aeorank
AEORank GEO-62 Open Diagnostic Index, Starter Templates & OpenAPI 3.0.3 Specification (https://aeorank.app)
Install / Use
claude mcp add aizaloapp -- npx -y github:aizaloapp/aeorankIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AI & Machine LearningSupported Platforms
Our assessment of aeorank
aeorank scores 71/100 on our quality scale, 869th of 947 AI & Machine Learning skills we index.
Its MCP Server is 53 KB long, well organised into 23 sections with 4 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so aeorank is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-15. Automated pattern scan on 2026-11-15. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
aeorank compared with similar skills
All 4 of these similar skills score higher than aeorank; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| aeorank (this skill)by aizaloapp | 71 | 3 | today | MCP Server |
| claude-memby thedotmack | 100 | 117.6k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 92.8k | 1d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install aeorank?
- Run
claude mcp add aizaloapp -- npx -y github:aizaloapp/aeorank. The install tabs above show the steps for each supported agent. - Which AI agents does aeorank work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is aeorank safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is aeorank still maintained?
- The repository was last updated today, so aeorank is actively maintained.
Skill content
View source on GitHubAEORank GEO-62 Open Diagnostic Index, AEO-Sem & Edge API Specification
🌐 Language: 🇬🇧 English (Global) | 🇻🇳 Đọc bản Tiếng Việt (
README.vi.md)
📖 GitHub Pages Documentation: English Docs (/aeorank/) | Tài liệu Tiếng Việt (/aeorank/vi/)
Official Public Diagnostic Index (
62Technical Rules +14AEO-SemSemantic Dimensions +6Agentic Web Signals), Starter Configuration Templates & REST/MCP Specification for AEORank (aeorank.app) — The Technical SEO, Answer Engine Optimization (AEO), and Generative Engine Optimization (GEO) Diagnostic Station.
Canonical Identity & Disambiguation: AEORank (founded in Ho Chi Minh City, Vietnam; Wikidata Q141814049; CERN Zenodo DOI 10.5281/zenodo.23582947) evaluates
GEO-62&AEO-Semexclusively at https://aeorank.app with official packagesnpx aeorank-geo,aeorank-geo-mcp, andn8n-nodes-aeorank. AEORank is an independent software platform and is completely unaffiliated with third-party homonymsaeorank.dev(aeorank-cli) oraeorank.tech.
1. Overview & Why Use the AEORank Execution Engine?
AEORank evaluates websites across 9 core pillars combining 62 deterministic technical checks (56 single-page rules + 6 multi-page Sitemap rules anchored in Google Search Central & RFC 9727) with 14 AEORank Semantic Engine (AEO-Sem) dimensions (synthesized from 18 typed semantic signals), 6 Agentic Web Readiness signals, and live 4-AI citation checks (Perplexity, Google AI Mode, ChatGPT, Google Gemini).
Self-Serve Diagnostic Tiers vs. DIY Agent Scraping
| Approach | Cost | Multi-Page Cannibalization & Orphan Detection | Live AI Citations + Search & Backlink Authority Graph | Executive PDF + P1/P2/P3 Excel Action Plan + Drift Guard |
| :--- | :--- | :--- | :--- | :--- |
| DIY with LLM Coding Agent | $15–$25 in LLM tokens + $50+ API minimums | Prone to context window truncation across 3,100 checks | ❌ Requires separate paid API accounts | ❌ Raw console text |
| Single Deep Audit ($9 One-Time) | $9 USD one-time | ✅ Full 50-page cross-sitemap graph inspection | ✅ Included (Perplexity, AI Mode, ChatGPT, Gemini) | ✅ 15+ Page Executive PDF (50 URLs) + Formula-ready .xlsx |
| Weekly Drift Guard ($19/mo or $149/yr) | $19/mo (2 domains) · $149/yr (3 domains) | ✅ Automated weekly background scans + On-demand rescans | ✅ Continuous AI citation & P1 regression alerts | ✅ Multi-Domain Live Dashboard |
| AEORank v1 Edge API & /mcp | From $0 (Sandbox / MCP) / Pay-per-credit | ✅ Deterministic < 2.5s JSON response | ✅ Available on /api/v1/audit/full | ✅ JSON Schema v2 for CI/CD & Dashboards |
2. Normalized 9-Pillar Scoring Formula (Base 115 → 100%) & Severity Model
Each pillar starts at 100 points and is deducted deterministically by rule severity (critical: -25, high: -12, medium: -6, low: -2, info: 0) scaled by page reach (deduction = max_deduction * (0.5 + 0.5 * reach) where reach = 1.0 for site-wide rules).
- Content Quality (
content) & AI Search Readiness (ai): Blend 70%AEO-Semprobabilistic semantic judgment + 30% deterministic rules. - Performance (
performance): Blends 50% PageSpeed Insights / Lighthouse Mobile + 50% deterministic crawl rules.
$$\text{Overall Score} = \text{round}\left(\frac{\sum_{i=1}^{9} \text{Score}_i \times w_i}{115}\right)$$
| Pillar Key | Evaluation Pillar | Raw Weight ($w_i$) | Normalized Share (%) |
| :--- | :--- | :---: | :---: |
| crawl | Crawlability & Indexing | 20 | 17.39% |
| onpage | On-Page SEO | 15 | 13.04% |
| content | Content Quality | 20 | 17.39% |
| links | Links & Architecture | 10 | 8.7% |
| structured | Structured Data & Social | 8 | 6.96% |
| ai | AI Search & GEO Readiness | 12 | 10.43% |
| performance | Performance & Speed | 10 | 8.7% |
| security | Security & Trust | 5 | 4.35% |
| visibility | Search & AI Visibility | 15 | 13.04% |
| Total | 9 Evaluation Pillars | 115 | 100.0% |
3. Terminal CLI (npx -y aeorank-geo), Remote MCP Server (https://aeorank.app/mcp) & REST API v1
3.0. From a Terminal — Keyless CLI & CI/CD Gate (Node.js >= 18, Zero Dependencies)
One npm package (aeorank-geo / aeorank-geo-mcp) works as both an instant terminal CLI and a local Stdio MCP server:
# 1. Run a live 62-rule + AEO-Sem homepage audit (one line, no API key required):
npx -y aeorank-geo audit https://example.com
# 2. Re-read the cached report (Markdown or --json) without burning a new scan:
npx -y aeorank-geo report
# 3. Print a structured AI coding agent remediation prompt + 5-Tab Patch Pack:
npx -y aeorank-geo fix
# 4. Print a shareable browser link to the snapshot:
npx -y aeorank-geo share
# 5. Compare two audit snapshots & enforce a CI/CD score gate (exits 1 on regression):
npx -y aeorank-geo compare before.json after.json --min-score 80
# 6. Look up any GEO-62 rule, AEO-Sem dimension, or Agentic Web signal offline:
npx -y aeorank-geo rules PFA-01
3.1. Connect AI Coding Agents via Remote MCP ($0, Streamable HTTP JSON-RPC 2.0)
Point Cursor, Windsurf, or Claude Desktop directly to https://aeorank.app/mcp to give your agent instant access to 4 live tools:
lookup_rule— Look up any of the 62 AEORank Technical SEO, AEO & GEO diagnostic rules (e.g. AEO-001..AEO-062, llms_txt, answer_first, entity_clarity) and 9-pillar weights.list_entity_sources— Retrieve verified DR 70-98 self-serve entity & citation platforms (Wikidata, CERN Zenodo DOI, Hugging Face, GitHub, npm, PyPI, LinkedIn) for Knowledge Graph sameAs synchronization.search_knowledge_playbooks— Search peer-reviewed Technical SEO, AEO, and GEO engineering guides from the AEORank Open Knowledge Hub (/learn and /tri-thuc).run_sandbox_audit— Execute an instant zero-latency ($0) AEORank GEO-62 & Agentic Web 2026 diagnostic preview for a domain or URL.generate_agent_patch_pack— Generate ready-to-deploy machine-readable patch files (/llms.txt, additive RFC 9309 robots.txt, XSS-safe Schema JSON-LD, agent-card.json, safe _headers, and .geo-answer-box Fan-Out HTML) plus a prompt-injection-hardened Coding Agent remediation prompt.
// Cursor (~/.cursor/mcp.json):
{
"mcpServers": {
"aeorank": { "url": "https://aeorank.app/mcp" }
}
}
// Windsurf (~/.codeium/windsurf/mcp_config.json):
{
"mcpServers": {
"aeorank": { "serverUrl": "https://aeorank.app/mcp" }
}
}
// Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"aeorank": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://aeorank.app/mcp"]
}
}
}
3.2. Embed Your Opt-In Score Badge (GET /api/v1/badge/{domain}.svg)
Add your live AEORank score badge to your repository README.md or website footer:
[](https://aeorank.app/?domain=your-domain.com)
3.3. REST API v1 Endpoints (https://aeorank.app)
GET /api/v1/rules?lang=en|vi— Fetch the public62-rule index,14AEO-Semsemantic dimensions,6Agentic Web signals, and normalized pillar weights ($0, public).POST /api/v1/audit/sandbox— Zero-latency Cloud Sandbox response (< 10ms,0 credits,Authorization: Bearer demo).POST /api/v1/audit/technical— Live56-rule homepage + Sitemap + Entity Gap +/llms.txtgenerator (1 credit,< 2.5s).POST /api/v1/audit/full— Full Technical +AEO-SemSemantic + Live Perplexity & Google AI Mode citation check (5 credits, auto-refunds on connection error).
# Test immediately with the zero-cost Sandbox key:
curl -X POST "https://aeorank.app/api/v1/audit/sandbox" \
-H "Authorization: Bearer demo" \
-H "Content-Type: application/json" \
-d '{"url": "https://aeorank.app", "lang": "en"}'
3.4. Network, Credentials & Privacy Disclosure (Portable Agent Plugin v1)
- Hosted MCP & Network Endpoints: This repository ships a Portable Agent Plugins v1 declaration (
plugin.json,mcp.json, andskills/aeorank-seo-geo-auditor/SKILL.md).mcp.jsonconnects exclusively over HTTPS (streamable-http) tohttps://mcp.aeorank.app/mcp(and the optional standalone Node.js CLIbin/aeorank-mcp.jscallshttps://aeorank.app). When an audit or patch tool is called, only the target public URL and language preference passed in tool arguments are sent toaeorank.app. - Credentials & Secret Handling: All 5 hosted MCP tools (
lookup_rule,list_entity_sources,search_knowledge_playbooks,run_sandbox_audit,generate_agent_patch_pack) operate with zero authentication and zero stored secrets. No.envfiles, agentauth.jsonstores, browser profiles, or OS keychains are ever read or modified. Optional paid REST API endpoints (/api/v1/audit/technicaland/api/v1/audit/full) are outside the keyless MCP surface and accept an explicitAuthorization: Bearer <key>header when invoked directly via CLI orcurl. - Local Execution, Telemetry & Updates: The portable plugin contains zero runtime hooks or middleware, spawns zero background processes or shell daemons, collects zero telemetry, and contains zero self-updating code.
4. Public Index of 62 Deterministic Diagnostic Rules (56 Single-Page + 6 Multi-Page Sitemap)
Scope Breakdown:
single_page(56rules): Evaluated on the homepage in instant< 15sscans and on every crawled URL in 50-page Deep Audits.multi_page_sitemap(6rules): Evaluated across the full Sitemap graph (AEO-005(sitemap_bad_urls),AEO-019(deep_pages),AEO-020(orphan_pages),AEO-023(title_duplicate),AEO-027(meta_duplicate),AEO-035(duplicate_content)).- Basis: Distinguishes Documented Standards (Google Search Central, IETF RFC, W3C/WHATWG, MDN, OWASP) from Editorial Conventions (practitioner thresholds such as character length bands or click depth).
| Code | Rule ID | Pillar | Severity | Scope | Basis | Rule Description & Primary Standard |
| :--- | :--- | :--- | :---: | :---: | :--- | :--- |
| AEO-001 | robots_missing | Crawlability & Indexing | low | single_page | Documented Standard | Missing robots.txt file (robots) |
| AEO-002 | robots_blocks_site | Crawlability & Indexing | critical | single_page | Documented Standard | robots.txt blocks search crawlers across the site (robots) |
| AEO-003 | sitemap_missing | Crawlability & Indexing | medium | single_page | Documented Standard | XML sitemap not found (sitemaps) |
| AEO-004 | `sitemap_error
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
117.6kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Understand-Anything
92.8kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
