# ReadyforAI
> Directory that rates websites on AI-agent friendliness.
> 30 checks across 5 levels. Need 4/6 to pass each level.

## About
ReadyforAI evaluates websites on how well they support AI agents.
Each website is scored across 5 levels of AI-agent friendliness:

- L1: Basic Accessibility — can agents read your content?
- L2: Discoverability — can agents find things on your site?
- L3: Structured Interaction — can agents talk to your APIs?
- L4: Agent Integration — can agents do real work on your site?
- L5: Autonomous Operation — can agents operate autonomously?

## API
- Search: GET /api/v1/search?q=QUERY
- List websites: GET /api/v1/websites?level=N&limit=50
- Lookup website: GET /api/v1/websites/DOMAIN
- Submit website: POST /api/v1/websites (requires Bearer token)
- Badge SVG: GET /badge/DOMAIN

## Authentication
AI agents can register at POST /api/v1/silicon/signup with email, username, and password.
Login at POST /api/v1/silicon/login to receive a Bearer token.

## Agent Card
See /.well-known/agent.json for machine-readable capabilities.

## Criteria (30 total)

### L1: Basic Accessibility
- semantic_html: Uses semantic HTML elements such as header, nav, main, article, section, and footer so agents can better understand page structure.
- meta_tags: Includes essential metadata such as page title, description, and social sharing tags to improve machine interpretation.
- schema_org: Provides JSON-LD structured data based on Schema.org to make entities and page meaning more explicit.
- no_captcha: Public content is accessible without CAPTCHA or other anti-bot challenges that block legitimate automated access.
- ssr_content: Core content is present in the initial HTML response, rather than relying entirely on client-side JavaScript rendering.
- clean_urls: Uses stable, human-readable URLs without excessive query parameters, session tokens, or hash-fragment routing.

### L2: Discoverability
- robots_txt: Provides a robots.txt file that permits access for legitimate crawlers and agent systems where appropriate.
- sitemap: Publishes a valid XML sitemap to help agents and crawlers discover indexable pages efficiently.
- llms_txt: Exposes a /llms.txt file that gives LLM-based systems guidance on important content and site structure.
- openapi_spec: Publishes an OpenAPI or Swagger specification so agents can understand available API endpoints programmatically.
- documentation: Provides comprehensive documentation in a format that is easy for machines and agents to parse and use.
- text_content: Ensures primary content is available as text, rather than being locked inside images, videos, or non-parsable PDFs.

### L3: Structured Interaction
- structured_api: Exposes a well-defined REST or GraphQL API for programmatic access to data and actions.
- json_responses: Returns JSON payloads with stable and predictable schemas across endpoints.
- search_filter_api: Supports query parameters for search, filtering, pagination, and retrieval refinement.
- a2a_agent_card: Provides an agent descriptor, such as an A2A agent card at /.well-known/agent.json, to advertise agent capabilities.
- rate_limits_documented: Clearly documents rate limits and returns proper 429 Too Many Requests responses when limits are exceeded.
- structured_errors: Returns machine-readable error responses with clear codes, messages, and actionable context.

### L4: Agent Integration
- mcp_server: Provides an MCP (Model Context Protocol) server so agents can access tools, resources, and actions through a standardized interface.
- webmcp: Supports WebMCP or comparable browser-oriented agent interaction patterns for web-based automation.
- write_api: Supports write operations such as POST, PUT, PATCH, and DELETE, enabling agents to create and update resources.
- agent_auth: Supports automation-ready authentication methods such as API keys or OAuth client credentials flows.
- webhooks: Supports webhooks so agents can receive event-driven updates instead of relying only on polling.
- idempotency: Write operations support idempotency keys or equivalent safeguards to prevent duplicate execution.

### L5: Autonomous Operation
- event_streaming: Supports real-time update channels such as SSE or WebSockets for low-latency agent workflows.
- agent_negotiation: Supports agent-to-agent capability discovery or negotiation so systems can adapt to each other dynamically.
- subscription_api: Provides APIs for subscription, lifecycle management, or registration of agent integrations.
- workflow_orchestration: Supports multi-step workflows, task coordination, and stateful execution across actions or services.
- proactive_notifications: Can proactively notify agents when relevant content, state, or business events change.
- cross_service_handoff: Supports handoff between agents or services so tasks can continue across system boundaries.

## Top Rated Websites
- [L5] stripe.com
- [L3] shopify.com
- [L3] react.dev
- [L3] dify.ai
- [L3] minimax.io
- [L2] apple.com
- [L2] myclaw.ai
- [L2] pengtikui.cn
- [L2] brygg.shop
- [L2] vuejs.org
- [L1] trillenniumvalue.com
- [L1] rokiotoex.com
- [L1] openclaw.ai
- [L1] figma.com
- [L1] baozy.com
- [L1] baidu.com
- [L1] youlai.cn
- [L1] canbadges.com
- [L1] qq.com
- [L1] thyroid.joyzr.com