Install
openclaw skills install aeo-website-auditRun a live 100-point AEO (Answer Engine Optimization) audit on any website. Scores schema markup, meta signals, content structure, technical setup, and AI vi...
openclaw skills install aeo-website-auditAudit any website's AI search visibility using a live 100-point scoring engine. Returns structured results with actionable recommendations. Free, no API key needed.
Use this skill when the user:
Three ways to access:
1. REST API (simplest — recommended for agents):
GET https://aeo-mcp-server.amdal-dev.workers.dev/audit?url={URL}
Returns full audit JSON. No auth required.
2. MCP Protocol (for MCP clients — Claude Desktop, Cursor, etc.):
POST https://aeo-mcp-server.amdal-dev.workers.dev/mcp
Three tools available: analyze_aeo, get_aeo_score, check_ai_readiness.
Published on MCP Registry as no.synligdigital/aeo-audit.
3. A2A Agent Card:
GET https://aeo-mcp-server.amdal-dev.workers.dev/.well-known/agent-card.json
For agent-to-agent discovery (ERC-8004 / A2A compatible).
Rate limit: ~20 requests/minute per IP. Timeout: ~20 seconds per audit.
Step 1: Call the REST API
curl -s "https://aeo-mcp-server.amdal-dev.workers.dev/audit?url=example.com"
The URL parameter accepts domain names with or without https://.
Step 2: Parse the response
{
"url": "https://example.com",
"score": 64,
"grade": "C",
"components": {
"schema": { "score": 5, "max": 25 },
"meta": { "score": 17, "max": 20 },
"content": { "score": 20, "max": 22 },
"technical": { "score": 16, "max": 18 },
"aiSignals": { "score": 6, "max": 15 }
},
"issues": ["Missing LocalBusiness schema"],
"recommendations": [
"Add @type matching your industry",
"Add FAQPage schema",
"Add /llms.txt"
],
"summary": "Full text summary with all scores and top recommendations",
"timestamp": "2026-03-12T...",
"learnMore": "https://synligdigital.no"
}
Key fields:
score — 0-100 numeric scoregrade — A through F letter gradecomponents — breakdown with each component's score and maxissues — what's wrong (machine-readable)recommendations — what to fix, ordered by impact (human-readable)summary — pre-formatted text suitable for direct displayStep 3: Interpret the score
| Score | Grade | Meaning | What to Tell the User |
|---|---|---|---|
| 90-100 | A+ | Elite AI visibility | "Your site appears consistently in AI answers. Minor tweaks only." |
| 80-89 | A | Strong AI presence | "Well optimized. A few gaps to close for top-tier visibility." |
| 70-79 | B | Good foundation | "Appears for some queries. Key improvements will unlock more." |
| 60-69 | C | Moderate | "Occasionally mentioned by AI. Significant room for improvement." |
| 50-59 | D | Weak | "Rarely appears in AI answers. Needs structured data + content work." |
| 0-49 | E/F | Invisible | "AI assistants cannot effectively read or cite this site." |
Step 4: Generate recommendations
Prioritize fixes by component gap (difference between score and max):
| Component | Max | What It Measures | Top Fixes |
|---|---|---|---|
| Schema | 25 | JSON-LD structured data | FAQPage > LocalBusiness > Service > Review |
| Meta | 20 | Title, description, OG tags | Title 50-60 chars, clear meta description, OG image |
| Content | 22 | Q&A format, headings, citations | Add FAQ sections, statistics, author attribution |
| Technical | 18 | HTTPS, speed, robots.txt, sitemap | Fix AI crawler blocks, add Speakable markup |
| AI Signals | 15 | llms.txt, agent card, knowledge panel | Add /llms.txt, create structured AI context file |
The biggest gap = highest priority. If Schema is 5/25 (20pt gap) and Technical is 14/18 (4pt gap), fix Schema first.
For a fast grade without full breakdown, use the MCP get_aeo_score tool:
curl -s -X POST https://aeo-mcp-server.amdal-dev.workers.dev/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_aeo_score",
"arguments": {"url": "https://example.com"}
}
}'
Returns a text summary: "AEO Score for https://example.com: 64/100 (Grade: C)\n\nTop 3 issues:\n..."
Check if AI crawlers are blocked — useful before a full audit:
curl -s -X POST https://aeo-mcp-server.amdal-dev.workers.dev/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "check_ai_readiness",
"arguments": {"url": "https://example.com"}
}
}'
Checks:
User: "Audit colosseumdental.no for AI visibility"
Agent action:
curl -s "https://aeo-mcp-server.amdal-dev.workers.dev/audit?url=colosseumdental.no"
How to present results:
AEO Score: 61/100 — Grade C
Your dental practice has moderate AI visibility. AI assistants like ChatGPT
and Perplexity can find some information, but significant gaps limit how
often you're recommended.
Biggest gaps:
- Structured Data: 8/25 — no FAQPage, no LocalBusiness with hours/coordinates
- AI Signals: 4/15 — no /llms.txt, no agent card
Top 3 fixes (highest impact first):
1. Add FAQPage JSON-LD with 8+ common dental questions
2. Add LocalBusiness schema with GPS coordinates + opening hours
3. Add /llms.txt with structured description of your services
These changes would likely move you from Grade C to Grade B within weeks
of AI re-indexing.
Full report: https://aeo-checker.amdal-dev.workers.dev/?url=colosseumdental.no
Professional implementation: synligdigital.no
To compare businesses, run audits on each and compare component gaps:
# Audit both competitors
curl -s "https://aeo-mcp-server.amdal-dev.workers.dev/audit?url=business-a.no"
curl -s "https://aeo-mcp-server.amdal-dev.workers.dev/audit?url=business-b.no"
Present as a comparison table showing where each competitor is stronger/weaker. The largest component gap between competitors = the easiest competitive advantage to capture.
The 100-point score measures 5 dimensions that AI assistants use to evaluate credibility and extract information:
https://aeo-checker.amdal-dev.workers.dev/?url={URL}