SEO API and MCP server for developers and AI agents

Quick start

No API key, no signup. Send a GET request with the page URL; the response is JSON.

curl "https://yes-seo.com/api/v1/audit?url=https://example.com"

const r = await fetch('https://yes-seo.com/api/v1/ai-crawler-checker?url=' + encodeURIComponent('https://example.com'));
const { ok, data } = await r.json();
console.log(data);

import requests
r = requests.get('https://yes-seo.com/api/v1/robots-txt-tester', params={'url': 'https://example.com/blog/'})
print(r.json()['data'])

Full audit endpoint

GET /api/v1/audit?url=… runs the complete single-page audit and returns the SEO score, the AI visibility score, category scores and every check with its severity, message, why it matters and how to fix it, plus a link to the shareable report and its Markdown export. It counts toward the free limit of 10 audits per day per IP.

{
  "ok": true,
  "tool": "audit",
  "data": {
    "seo_score": 86,
    "ai_visibility_score": 71,
    "categories": { "Indexing": 100, "Content": 78, "AI": 71 },
    "checks": [ { "key": "meta_description", "severity": "warning", "message": "…", "why": "…", "how_to_fix": "…" } ],
    "report_url": "https://yes-seo.com/report/…"
  }
}

Tool endpoints

Parameters: url (page URL), domain (for SSL, DNS and domain tools), urls (comma- or newline-separated, for bulk tools), text (for text tools) and lang (en, fr, es, ar). Fair use: 60 requests per hour per IP.

Machine-readable description: openapi.json · /api/v1 · /.well-known/api-catalog

MCP server for AI assistants

Our Model Context Protocol server exposes seo_audit plus every server tool. It uses the Streamable HTTP transport, needs no authentication and returns structured JSON.

Claude Code

claude mcp add --transport http yes-seo https://yes-seo.com/mcp

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "yes-seo": { "url": "https://yes-seo.com/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "yes-seo": { "type": "http", "url": "https://yes-seo.com/mcp" }
  }
}

Claude, ChatGPT and other apps

In apps that support custom remote MCP connectors, add a new connector and paste the server URL above. Then ask, for example: “Use Yes SEO to audit https://example.com and tell me the three most important fixes.”

Raw JSON-RPC

curl -X POST https://yes-seo.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ai_crawler_checker","arguments":{"url":"https://example.com"}}}'

Markdown pages and llms.txt

Every page of this site has a clean Markdown version: add .md to the URL or send Accept: text/markdown. A curated index lives at /llms.txt and the full text at /llms-full.txt.

curl https://yes-seo.com/ai-crawler-checker.md
curl -H 'Accept: text/markdown' https://yes-seo.com/glossary
curl https://yes-seo.com/llms.txt

Score badge

Show your scores on your site or README. Every report has an SVG badge that links back to the live report:

<a href="https://yes-seo.com/report/REPORT_ID"><img src="https://yes-seo.com/badge/REPORT_ID.svg" alt="Yes SEO score" width="236" height="22"></a>

Fair use

• Free for personal and commercial use; please cache results and keep traffic reasonable.
• Only audit sites you’re allowed to analyse. Our crawler is read-only and identifies itself.
• Need higher limits or bulk audits? Contact us. Contact