# Agent-Ready Audit

> Agent-Ready Audit is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.0499/call, status unknown (last checked 2026-11-20).

Audits a public website's AI-agent readiness by checking robots.txt rules for AI bots, llms.txt presence, structured data, and agent interfaces, then returns a scored report with fix recommendations.

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/agent-ready-audit?utm_source=zero.xyz
- Price: $0.0499/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-ready-audit-8745ec3e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rrbNIuU9fFPggcwVx3Uid

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-ready-audit-8745ec3e -d '<json body>'
```

Example prompt: Can you run an AI-readiness audit on https://mycompany.com and tell me which AI bots like GPTBot and ClaudeBot can access it, whether we have llms.txt, and what our overall grade is? Use the allow_search_block_training crawler policy and check up to 10 pages.

## When to prefer this

Choose this endpoint when you need a comprehensive, graded AI-agent readiness audit covering bot access policies, llms.txt presence, structured data, and fix recommendations for a public website — especially when you want per-bot HTTP probing (GPTBot, ClaudeBot, Google-Extended) and actionable snippets with effort estimates, rather than just a raw robots.txt parser or a generic SEO audit.

## Known failure modes

- URL is not publicly reachable — audit may return incomplete bot probe results
- robots.txt blocked for all agents causes a WARNING and limited recommendations unless override_full_disallow is set
- Site returns 5xx errors during crawl — fewer pages audited, lower confidence
- Invalid or malformed URL input returns a validation error
- Max pages limit exceeded (>25) returns a schema validation error

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

Returns a JSON object containing: overall letter grade (A–F), numeric score, per-bot access rules with HTTP probe results, categorized check results (each with pass/fail, points earned, severity, and a fix snippet with effort level), subscores across crawler_access/discoverability/structured_data/agent_interfaces/content_readability/machine_readable_summary, list of audited page URLs, and a disclaimer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2000,
   "description": "public http(s) URL"
  },
  "business": {
   "type": "object",
   "properties": {
    "logo": {
     "type": "string"
    },
    "name": {
     "type": "string"
    },
    "contact": {
     "type": "string"
    },
    "same_as": {
     "type": "array",
     "items": {
      "type": "string"
     }
    },
    "description": {
     "type": "string"
    }
   }
  },
  "max_pages": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1
  },
  "site_type": {
   "enum": [
    "auto",
    "saas",
    "api",
    "ecommerce",
    "publisher",
    "local_business",
    "docs"
   ],
   "default": "auto"
  },
  "custom_policy": {
   "type": "object",
   "additionalProperties": {
    "enum": [
     "allow",
     "block"
    ]
   }
  },
  "crawler_policy": {
   "enum": [
    "allow_all_ai",
    "allow_search_block_training",
    "custom"
   ],
   "default": "allow_search_block_training"
  },
  "runs_a2a_agent": {
   "type": "boolean",
   "default": false,
   "description": "Set true only if this site actually runs an A2A agent. Then the kit generates .well-known/agent-card.json and the agent card check is scored; otherwise it is N/A."
  },
  "override_full_disallow": {
   "type": "boolean",
   "default": false,
   "description": "Your robots.txt has 'Disallow: /' for everyone. By default the generated robots.txt does NOT open the site to the AI bots your policy allows (it adds a WARNING and an INSTALL.md conflict note). Set true only if you really want those bots allowed despite the site-wide block."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://www.python.org/",
  "bots": [
   {
    "name": "GPTBot",
    "class": "training",
    "robots": "not_specified",
    "operator": "OpenAI",
    "http_probe": {
     "status": 200,
     "probed_as": "GPTBot",
     "blocked_by_waf": false
    },
    "matched_rule": "group * has no rule for / (allowed)"
   },
   {
    "name": "ClaudeBot",
    "class": "training",
    "robots": "not_specified",
    "operator": "Anthropic",
    "http_probe": {
     "status": 200,
     "probed_as": "GPTBot",
     "blocked_by_waf": false
    },
    "matched_rule": "group * has no rule for / (allowed)"
   },
   {
    "name": "Google-Extended",
    "class": "training",
    "robots": "not_specified",
    "operator": "Google",
    "http_probe": {
     "status": 200,
     "probed_as": "GPTBot",
     "blocked_by_waf": false
    },
    "matched_rule": "group * has no rule for / (allowed)"
   }
  ],
  "grade": "D",
  "score": 62.8,
  "skill": "agent_ready_audit",
  "checks": [
   {
    "id": "llms_txt",
    "fix": {
     "effort": "S",
     "snippet": "",
     "summary": "Publish /llms.txt in the llmstxt.org shape (see artifacts.llms_txt).",
     "snippet_lang": "txt"
    },
    "max": 8,
    "pass": false,
    "points": 0,
    "category": "machine_readable_summary",
    "evidence": "no /llms.txt",
    "severity": "medium"
   },
   {
    "id": "llms_full_txt",
    "fix": {
     "effort": "S",
     "snippet": "",
     "summary": "Publish /llms-full.txt with the full text of your key pages (see artifacts.llms_full_txt).",
     "snippet_lang": "txt"
    },
    "max": 3,
    "pass": false,
    "points": 0,
    "category": "machine_readable_summary",
    "evidence": "no /llms-full.txt",
    "severity": "low"
   }
  ],
  "reason": null,
  "subscores": {
   "crawler_access": 100,
   "discoverability": 43,
   "structured_data": 50,
   "agent_interfaces": null,
   "content_readability": 100,
   "machine_readable_summary": 0
  },
  "disclaimer": "Improves technical accessibility for AI crawlers and agents. Does not guarantee crawling, ranking, citation, or traffic.",
  "pages_audited": [
   "https://www.python.org/",
   "https://www.python.org/psf-landing/",
   "https://www.python.org/jobs/"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-ready-audit-8745ec3e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
