# ShopsForBots
> A directory of online shops that publish machine-readable signals (UCP manifest, MCP endpoint declared in the manifest, llms.txt) for AI shopping agents. 251,296 shops listed. Every value comes from our own checks of each domain; we do not copy data from other directories. Third-party lists and public web-crawl/DNS data are only used to decide which domains we check. The list is a sample (currently mostly Shopify), scores are heuristic (v1). Data: fair use for private use; contact bot@shopsforbots.com for commercial use. Not affiliated with Shopify, Google or any listed shop.

## Agent access (no auth, CORS open, fair use 60 requests/min per IP)
- [MCP server](https://shopsforbots.com/mcp): Streamable HTTP, stateless JSON-RPC 2.0; tools search_shops, get_shop, list_categories, get_stats. Server card: https://shopsforbots.com/.well-known/mcp.json
- [Search API](https://shopsforbots.com/api/search?q=shoes&min_score=60&limit=10): parameters q, category, country, platform, min_score, status, protocol (comma list, e.g. ucp,mcp), limit (max 100), offset
- [Shop record](https://shopsforbots.com/api/shop/allbirds.com): full record for one domain
- [OpenAPI](https://shopsforbots.com/api/openapi.json) and [ai-plugin.json](https://shopsforbots.com/.well-known/ai-plugin.json)
- WebMCP: the directory and shop pages register search_shops and get_shop via navigator.modelContext (when the browser supports it)
- For bulk use download the static index below instead of paging the API
- [Docs and examples](https://shopsforbots.com/bot/#agents)

## Data (static JSON, no auth)
- [Compact index of all shops](https://shopsforbots.com/api/index.json): short keys d=domain, n=name, s=score, p=protocol codes (u=ucp, w=webmcp hint, m=mcp declared), k=capability codes, c=category, v=1 means detail is in chunks
- [One shop](https://shopsforbots.com/api/shops/allbirds.com.json): full record for a shop with its own page; replace the domain
- [Detail chunks](https://shopsforbots.com/api/chunks/000.json): 256 files; chunk = fnv1a-32(domain) mod 256, JSON object keyed by domain
- [Stats](https://shopsforbots.com/api/stats.json)
- [Changelog](https://shopsforbots.com/api/changelog.json)
- [Machine-readable description](https://shopsforbots.com/.well-known/shopsforbots.json)

## Docs
- [Methodology and score formula](https://shopsforbots.com/how-it-works/)
- [API](https://shopsforbots.com/api/)
- [For shops: how to become agent-ready](https://shopsforbots.com/for-shops/)
- [Submit a shop](https://shopsforbots.com/submit/)

## Notes for agents
- "MCP declared" means the shop's UCP manifest names an MCP endpoint. We have NOT tested it with a call (no tools/list, no POST). We do not test purchases. Verify before relying on any entry.
- Unknown values are null. Country and EU fields are mostly empty (only set with evidence).
- Scores: heuristic v1, max 85.
- Crawler: ShopsForBotsChecker (see https://shopsforbots.com/bot/). Opt-out via robots.txt (User-agent: ShopsForBotsChecker) or email.