# numisbids — NumisBids prices realized

Aggregator of numismatic auction catalogues (≈ 370 houses: CNG, Leu, Künker partners, Noonans, Heritage world coins, cgb.fr, …) with hammer prices for closed sales.

• Engine: Firecrawl (Cloudflare 403 on plain HTTPS), Scrapfly fallback. 1 credit per page; a category page carries 100 lots.
• Flow: /results → sales with a "Prices realized" link (sale id) → /sale/<sid> (firm, auction title, closing date, categories) → /sale/<sid>/category/<cid>?pg=N → one raw record per page.
• Records: sale per sold lot — hammer price in the printed currency (buyerPremiumIncluded=false, NumisBids: "Buyer's premium is not included"), sale date = closing date, estimate / firm / section in attributes.metadata, identifiers.numisbids_lot = <sid>/<lot>, grade parsed from the description (PCGS/NGC/PMG…), isBundle for large lots.
• Cursor: { doneSales, inProgress: { sid, categories, catIndex, page }, minSeenSid, backfillSid, done }. Backfill walks sale ids downwards to 1 (2013).
• Config: salesPerRun, pagesPerRun, skipSections (literature, antiquities).
• Smoke: set -a; . ./.env; set +a; pnpm tsx connectors/firecrawl/numisbids/_smoke.ts 2