{"name": "AgentReady scan API (agentready.market)", "version": "v1", "status": "stable", "description": "Agent-readiness audit for e-commerce stores: score /100 of whether an AI shopping agent can find, understand and buy. Free keyless reads; scans metered per the RateLimit headers.", "openapi": "https://www.agentready.market/openapi.json", "docs": {"human": "https://www.agentready.market/api", "markdown": "https://www.agentready.market/api.md", "auth": "https://www.agentready.market/auth.md", "llms": "https://www.agentready.market/llms.txt"}, "endpoints": [{"method": "GET", "path": "/api/v1/scan", "params": {"url": "<store-url>", "vertical": "<optional>"}, "description": "Run a fresh scan (~30s): score, grade, pillars, top_fixes, report_url, Index neighbors."}, {"method": "GET", "path": "/api/v1/scan/{scan_id}.json", "description": "Read a stored scan report."}, {"method": "GET", "path": "/api/v1/scan/{scan_id}/brief.md", "description": "Agent brief (Pro Bearer key): the full fix job as one markdown file for a coding agent \u2014 sequenced how-tos, paste-ready artifacts, verify loop."}, {"method": "POST", "path": "/api/v1/reports", "description": "Bulk read, up to 100 hosts (Pro Bearer key)."}, {"method": "POST", "path": "/mcp", "description": "MCP server, Streamable HTTP, no auth."}, {"method": "GET", "path": "/ask", "params": {"query": "<natural language question>"}, "description": "NLWeb-style natural-language endpoint: ranked results with URLs, deterministic."}], "versioning": {"current": "v1", "policy": "Breaking changes only ever ship under a new /vN prefix. Deprecated endpoints keep working for at least 6 months and announce removal with Deprecation and Sunset headers (RFC 8594) before they go away."}}