{"openapi":"3.1.0","info":{"title":"AgentsReady API","version":"1.0.0","description":"Score how well AI agents can read and use a website, and get the fixes. Free, no key. Rate-limited per IP.","contact":{"url":"https://agentsready.dev/about"}},"servers":[{"url":"https://agentsready.dev"}],"paths":{"/api/check":{"get":{"operationId":"checkSite","summary":"Score a site for AI agents (plain JSON)","description":"Score out of 100 (60 core + 40 for the job), every failed check with its fix, and a fix prompt for coding agents. Same as the MCP tool check_site.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","example":"stripe.com"},"description":"The site to check, like example.com"},{"name":"job","in":"query","schema":{"type":"string","enum":["recommend","buy","signup","api","personal"]},"description":"recommend, buy, signup, api or personal. Detected if left out."}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/scan":{"get":{"operationId":"scanSite","summary":"Scan a site the way an AI agent would","description":"Streams each probe (`kind: probe`), then the result (`kind: result`) with `scan` (raw signals), `track` (detected job) and `result` (developer index). Cached for 24 hours.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","example":"stripe.com"},"description":"The site to check, like example.com"}],"responses":{"200":{"description":"Server-sent events, one JSON object per `data:` line.","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}},"/api/agent":{"get":{"operationId":"runAgent","summary":"Send an agent to do a job on the site","description":"Streams the agent's reads and notes, then `type: done` with the path, human gates, grade and fixes. Runs are shared and cached; daily caps apply.","parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string","example":"stripe.com"},"description":"The site to check, like example.com"},{"name":"track","in":"query","schema":{"type":"string","enum":["recommend","buy","signup","api","personal"],"default":"api"},"description":"The job: recommend, buy, signup, api or personal"}],"responses":{"200":{"description":"Server-sent events, one JSON object per `data:` line.","content":{"text/event-stream":{"schema":{"type":"string"}}}}}}},"/api/watch":{"post":{"operationId":"watchSite","summary":"Get an email when a site gets worse for agents","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email","domain"],"properties":{"email":{"type":"string","format":"email"},"domain":{"type":"string"}}}}}},"responses":{"200":{"description":"Watching","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"sites":{"type":"array","items":{"type":"string"}}}}}}}}}},"/badge/{domain}":{"get":{"operationId":"badge","summary":"README badge (SVG) with the site's score","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","example":"stripe.com"},"description":"The site to check, like example.com"}],"responses":{"200":{"description":"SVG badge","content":{"image/svg+xml":{"schema":{"type":"string"}}}}}}}}}