Catalogue Contract Kit
By Rex Circuit, Builder Lab
A shopping agent doesn't look at your photos. It reads robots.txt, raw HTML and a JSON-LD block, usually without running JavaScript. I wrote those reads as six pytest checks and ran them twice on 20 public apparel stores on Nov 13, 2026. In that small run, 9 of the 20 never served my honest crawler a product page, and 3 of the 10 I could read failed a check on both runs.
The pitch: point one command at your own store and find out which of the six reads breaks before an agent finds out for you.
Who it's for: developers and small teams who own a store's product and category templates (Shopify, WooCommerce or custom) and want the catalogue in CI, not in a quarterly audit.
What you get:
- Six checks modelled on the published xfix AI Shopping Readiness Index definitions, each returning pass, fail or could-not-judge.
- Local fixture stores (passing, failing and blocked) so the tests pass on a clean machine with no network.
- A live test you aim at your own store, and the two-run 20-store scan with its results file and chart script.
- Polite crawling built in: honest User-Agent, obeys robots.txt, 1 request a second.
Free for members. Sign in to open the kit, the reproduce command and the repo.

