Costco Products

{  "type": "object",  "additionalProperties": false,  "properties": {    "mode": {      "type": "string",      "enum": [        "categories",        "catalog"      ],      "title": "Enumeration mode",      "description": "Categories pages each megamenu leaf and takes the taxonomy from Costco’s own breadcrumb. Catalog asks the search app for everything at once — the complete shippable catalogue in ~61 requests — and names the taxonomy from the megamenu instead.",      "default": "categories"    },    "categoryUrls": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Category paths",      "description": "Leave empty to discover every leaf category from Costco’s megamenu. Full costco.com URLs are accepted and reduced to their path.",      "default": [],      "examples": [        "/laptops.html, /cooktops.html"      ]    },    "maxCategories": {      "type": "number",      "minimum": 1,      "maximum": 2000,      "title": "Max categories (discovery only)",      "description": "The megamenu yields ~995 leaf entries, 847 of them distinct. Ignored when category paths are given explicitly, and in catalog mode.",      "default": 250    },    "maxProductsPerCategory": {      "type": "number",      "minimum": 1,      "maximum": 20000,      "title": "Max products per category",      "description": "Paging stops at this many, or when the category runs out. The deepest category measured holds 1,978 products and pages to the last one, so the default clears it.",      "default": 2000    },    "maxProducts": {      "type": "number",      "minimum": 1,      "maximum": 200000,      "title": "Max products per run",      "description": "Across every category together. The whole shippable catalogue is ~12,100 products, so the default does not bite on a full run. Hitting it ends the run with a truncation warning.",      "default": 25000    },    "shipItOnly": {      "type": "boolean",      "title": "Shippable items only",      "description": "Applies the storefront’s ShipIt eligibility filter. Turning it off also returns warehouse-only and grocery-delivery items, which have no shippable price.",      "default": true    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 200,      "title": "Products per request",      "description": "Verified 2026-09-03: 200 is honoured exactly, 201 already falls back to 24. Clamped for that reason.",      "default": 200    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "description": "Costco throttles by resetting the connection rather than returning a status code, so a run that suddenly reports fetch errors is usually going too fast.",      "default": 750    },    "userLocation": {      "type": "string",      "maxLength": 2000,      "title": "User state",      "description": "Together with the postal code, decides regional pricing and availability.",      "default": "NJ"    },    "userPostal": {      "type": "string",      "maxLength": 2000,      "title": "User postal code",      "default": "07094"    },    "locations": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "Inventory nodes (Solr `loc`)",      "description": "Which fulfilment nodes are joined onto each product. Trimming this changes which products come back and at what price — leave it alone unless you are deliberately re-targeting the run.",      "default": [        "729-bd",        "306-wh",        "1260-3pl",        "1321-wm",        "1477-3pl",        "283-wm",        "561-wm",        "725-wm",        "731-wm",        "758-wm",        "759-wm",        "847_0-cor",        "847_0-cwt",        "847_0-edi",        "847_0-ehs",        "847_0-membership",        "847_0-mpt",        "847_0-spc",        "847_0-wm",        "847_1-cwt",        "847_1-edi",        "847_d-fis",        "847_lg_n1a-edi",        "847_lux_us81-edi",        "847_NA-cor",        "847_NA-pharmacy",        "847_NA-wm",        "847_ss_u360-edi",        "847_wp_r428-edi",        "951-wm",        "952-wm",        "9847-wcs"      ]    },    "warehouse": {      "type": "string",      "maxLength": 2000,      "title": "Reporting warehouse (`whloc`)",      "default": "306-wh"    },    "apiKey": {      "type": "string",      "maxLength": 2000,      "title": "Search API key",      "description": "The key costco.com ships to every browser. Set only if Costco rotates it; the environment variable is the better place for that.",      "examples": [        "defaults to COSTCO_SEARCH_API_KEY, then the storefront’s public key"      ]    }  }}