{"id":51534004,"url":"https://github.com/swarmclawai/agentready","last_synced_at":"2026-07-09T06:30:48.272Z","repository":{"id":353651732,"uuid":"1220343905","full_name":"swarmclawai/agentready","owner":"swarmclawai","description":"Open-source readiness scanner for agent-facing websites, merchants, APIs, docs, and support surfaces.","archived":false,"fork":false,"pushed_at":"2026-04-24T20:01:05.000Z","size":65,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T22:08:58.906Z","etag":null,"topics":["a2a","agent-readiness","agentic-web","ai-agents","cli","ecommerce","llms-txt","mcp","npm-package","openapi","robots-txt","scanner","sitemap","structured-data","web-security"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@swarmclawai/agentready","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/swarmclawai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-24T19:57:11.000Z","updated_at":"2026-04-24T20:01:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/swarmclawai/agentready","commit_stats":null,"previous_names":["swarmclawai/agentready"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/swarmclawai/agentready","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Fagentready","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Fagentready/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Fagentready/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Fagentready/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swarmclawai","download_url":"https://codeload.github.com/swarmclawai/agentready/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swarmclawai%2Fagentready/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35290235,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-09T02:00:07.329Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a2a","agent-readiness","agentic-web","ai-agents","cli","ecommerce","llms-txt","mcp","npm-package","openapi","robots-txt","scanner","sitemap","structured-data","web-security"],"created_at":"2026-07-09T06:30:47.437Z","updated_at":"2026-07-09T06:30:48.266Z","avatar_url":"https://github.com/swarmclawai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AgentReady\n\n[![npm version](https://img.shields.io/npm/v/%40swarmclawai%2Fagentready?label=npm)](https://www.npmjs.com/package/@swarmclawai/agentready)\n[![npm alpha](https://img.shields.io/npm/v/%40swarmclawai%2Fagentready/alpha?label=alpha)](https://www.npmjs.com/package/@swarmclawai/agentready/v/0.1.0-alpha.0)\n[![license](https://img.shields.io/npm/l/%40swarmclawai%2Fagentready)](LICENSE)\n[![node](https://img.shields.io/badge/node-%3E%3D20.18-339933)](packages/cli/package.json)\n\nOpen-source readiness scanner for the agentic web.\n\nAgentReady checks whether a website, API, marketplace, merchant, MCP server, or agent service is ready for AI agents to discover it, understand it, authenticate with it, buy from it, pay it, request refunds, and interact safely.\n\n## Install\n\nAgentReady is published on npm as [`@swarmclawai/agentready`](https://www.npmjs.com/package/@swarmclawai/agentready). It installs one executable: `agentready`.\n\nCurrent npm dist-tags:\n\n- `alpha`: `0.1.0-alpha.0`\n- `latest`: `0.1.0-alpha.0`\n\nThis is an alpha release, so installing with `@alpha` is the clearest way to stay on the prerelease channel:\n\n```bash\nnpm install -g @swarmclawai/agentready@alpha\nagentready scan https://example.com --profile merchant\n```\n\nRun it without a global install:\n\n```bash\nnpx @swarmclawai/agentready@alpha scan https://example.com --profile merchant\n```\n\nOr add it to a project for CI:\n\n```bash\nnpm install --save-dev @swarmclawai/agentready@alpha\nnpx agentready scan https://example.com --profile merchant --format markdown --output agentready-report.md\n```\n\nRequirements:\n\n- Node.js `\u003e=20.18`\n- Network access to the target being scanned\n\n## Status\n\n`0.1.0-alpha.0` is an early CLI release. It performs passive checks by default and produces text, JSON, Markdown, or HTML reports.\n\nAgentReady does not bypass authentication, CAPTCHAs, rate limits, or access controls. It does not submit forms, make purchases, trigger paid actions, or attempt exploitation.\n\n## Commands\n\n```bash\nagentready scan https://example.com\nagentready scan https://example.com --profile merchant --format markdown --output report.md\nagentready scan https://example.com --format json\nagentready rules list\nagentready rules test ./rules/custom-rule.yaml https://example.com\nagentready init\n```\n\nProfiles:\n\n- `website`\n- `merchant`\n- `api`\n- `marketplace`\n- `mcp-server`\n- `agent-service`\n- `auto`\n\nOutput formats:\n\n- `text`\n- `json`\n- `markdown`\n- `html`\n\n## What It Checks\n\nAgentReady includes passive rules for:\n\n- `robots.txt`, `sitemap.xml`, `llms.txt`, `llms-full.txt`, and Markdown fallbacks\n- structured data, product schema, service schema, price, inventory, cart, checkout, shipping, tax, refund, cancellation, and support signals\n- OpenAPI, API auth docs, idempotency, webhooks, and rate-limit guidance\n- HTTP 402 and x402 metadata hints\n- A2A Agent Cards at `/.well-known/agent-card.json` and legacy `/.well-known/agent.json`\n- MCP OAuth protected resource and authorization metadata hints\n- Web Bot Auth, AP2/mandate text, signed receipts, support response expectations\n- `security.txt`, HTTPS, unsafe CORS, public `/admin`, obvious leaked secrets, and prompt-injection-like public tool text\n\n## Example JSON\n\n```json\n{\n  \"target\": \"https://example.com\",\n  \"profile\": \"merchant\",\n  \"score\": 58,\n  \"findings\": [\n    {\n      \"id\": \"commerce.refund_policy_detected\",\n      \"severity\": \"critical\",\n      \"status\": \"fail\",\n      \"title\": \"Refund or return policy is detectable\",\n      \"evidence\": [\n        {\n          \"message\": \"No refund or return policy signal found.\"\n        }\n      ],\n      \"recommendation\": \"Publish a crawlable refund/return policy with time windows, eligibility, and escalation paths.\"\n    }\n  ]\n}\n```\n\n## Development\n\n```bash\npnpm install\npnpm typecheck\npnpm test\npnpm build\n```\n\nThe CLI package lives in `packages/cli`; scanner logic is split across `packages/core`, `packages/rules`, `packages/report`, and `packages/types`.\n\n## License\n\nApache-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswarmclawai%2Fagentready","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswarmclawai%2Fagentready","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswarmclawai%2Fagentready/lists"}