Agent Readiness

Can autonomous agents use your site? 8 checks, 0-100 score, P0/P1/P2 fix plan — verify against is-agentic.com.

This is a Pro feature — part of the Pro engine (v2.4.0+). The free toolkit checks the llms.txt basics via site_audit; the full 8-check scoring lives in Pro.

The problem

A growing share of your traffic isn’t human and isn’t a search crawler — it’s autonomous agents. Agents read what curl reads: no JavaScript patience, no HTML error-page parsing, no guessing your API surface. A site that returns app-shell 200s, HTML error pages, and JS-only content is invisible to them.

Vercel’s is-agentic.com made this measurable — public scores for how well agents can discover, retrieve, and use a site. For reference: vercel.com scores 85, linkedin.com 47, and the reference implementation of this exact checklist took zens.ink from 64 to 98/100.

The 8 checks

#CheckTierPoints
1Agent-friendly 404s (real status + markdown recovery body)essential15
2OpenAPI spec (operationIds, descriptions, typed schemas)essential15
3JSON error responses (structured, never HTML)essential15
4Markdown negotiation (Accept: text/markdown + Vary)essential15
5Developer discoverability (/developers/ + llms.txt links)recommended10
6Agent instructions (when-to-use in llms.txt)recommended10
7Trust anchors (about/contact/privacy + Organization schema)recommended10
8CLI / MCP surface documentedrecommended10

Usage

python3 -m zens_ink_pro.agent_readiness https://yoursite.com

# Save report + JSON
python3 -m zens_ink_pro.agent_readiness https://yoursite.com --report agent-report.md --json agent-data.json

Deterministic scoring — no LLM calls, no API keys, ~10 HTTP requests per run. Every finding names the exact change needed and its point value, bucketed P0 (critical) / P1 (high) / P2 (polish).

After fixing

Rescan with the official public scorer to confirm:

npx is-agentic yoursite.com

What good looks like

The zens.ink implementation (August 2026) is the reference: OpenAPI 3.1 at /openapi.json, markdown on Accept: text/markdown with Vary: Accept, JSON 404s with hints, trust-anchor pages in four languages, and a llms.txt that opens with agent guidance. 98/100, grade “Strong technical baseline” — every fix pattern is documented in the Pro package’s references/ directory.