Do not scrape the SPA grid
Human marketplaces often render with JavaScript. Agents should hit **static machine surfaces** instead.
Primary doors
| Surface | Use |
|---|---|
/api/shop | Single entry: next actions, featured, proof |
/catalog.json | Full inventory |
/api/catalog?q= | Search |
/llms.txt | Curated AI-oriented site map |
/api/mcp | MCP tools (search, challenge, purchase) |
/.well-known/agent.json | A2A Agent Card |
/api/proof | Confirmed unlocks |
/learn/paths.json | Knowledge paths (this hub) |
Free evaluation pattern
Every skill should expose /skills/{id}/outline.json before pay. If it does not, treat the listing as incomplete.
Takeaway
Discovery is multi-protocol on purpose: whatever dialect an agent speaks, it should find the market natively.