agent-readiness-scan
Open-source · MIT · A gift to the Algorand ecosystem

Is your brand ready
for AI agents to act on it?

The open web is becoming a customs house. Pages, products, identities, and actions now need to declare what they are, who may fetch them, and which agent may act. This is the audit — and the drop-in declarations to fix it.

$ npx @kirkelabs/agent-readiness-scan https://your-site.com

No install. No account. No data leaves your machine. Node ≥ 20.

Why it exists

Audits tell you you're invisible. This one ships the declarations.

The 1 June 2026 Kirke Labs strategic paper — The Web Becomes a Customs House — argues the new web bargain is declared-access-for-action. AI search, agentic commerce (ACP, Universal Cart), bot authentication (Web Bot Auth), Cloudflare Content Signals, and the EU DSA/DMA all push in the same direction: every web property now needs a customs-house posture, not just a content strategy. agent-readiness-scan audits that posture across eight dimensions and generates the drop-in robots.txt, .well-known/* manifests, and JSON-LD scaffolds you need to ship the declaration.

How it scores

Eight customs-house dimensions

01 Per-bot crawler policy w10

robots.txt names individual AI bots — training, grounding, user-directed — with explicit rules.

02 Declared use-policy signals w7

Cloudflare Content Signals, noai/noimageai meta, X-Robots-Tag header.

03 Bot-Auth readiness w5

Web Bot Auth key directory at /.well-known/http-message-signatures-directory.

04 MCP exposure w7

Model Context Protocol server card + OAuth-protected-resource metadata (NSA-recommended).

05 Agentic-commerce manifests w7

OpenAI/Stripe ACP and Google Universal Cart manifests at the canonical .well-known/ paths.

06 Agent-actionable Product/Offer w7

Product/Offer JSON-LD complete enough for agent-driven checkout (price, shipping, returns, ratings).

07 Brand identity corroboration w8

sameAs to Wikidata, Crunchbase, Companies House, SEC EDGAR, GLEIF — registry-grade, not just social.

08 Source provenance & regulatory w5

dateModified, security.txt, T&Cs, contact, privacy. The customs-form data.

Full rubric, thresholds and rationale: METHODOLOGY.md. These are documented judgement calls — disagree in an issue.

What you get back

A score, and the customs declaration to fix it

Honest limits

What it does not claim

This measures heuristic indicators of agent-readiness across 2026 standards (MCP, ACP, UCP, Web Bot Auth, Content Signals). A high score makes a brand easier for agents to discover, declare access to, and act on — it is not a guarantee of agent uptake, citation, or transaction. Most of these standards are emerging, not universal. The bar will rise.