Specularis AI Visibility Audit
Free AI visibility (GEO/AEO) audit: can ChatGPT, Claude and Perplexity find and cite your website?
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http specularis-ai-visibility-audit 'https://specularis-mcp-audit-production.up.railway.app/mcp'{
"mcpServers": {
"specularis-ai-visibility-audit": {
"type": "http",
"url": "https://specularis-mcp-audit-production.up.railway.app/mcp"
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
Specularis AI Visibility Audit — MCP Server
Run a free AI visibility (GEO/AEO) audit on any website from inside Claude, ChatGPT, or any MCP client — check whether ChatGPT, Claude, Perplexity and Gemini can reach, read and cite it, and find the sources they cite instead.
Hosted endpoint (Streamable HTTP):
https://specularis-mcp-audit-production.up.railway.app/mcpNo installation needed — it's a remote MCP server. Add the URL above and you're done.
Connect it
Claude (claude.ai or Claude Desktop): Settings → Connectors → Add custom connector → paste the URL above.
Claude Code:
claude mcp add --transport http specularis-audit https://specularis-mcp-audit-production.up.railway.app/mcpThen in any chat: "Audit example.com for AI visibility" — the tool runs.
Tools
| Tool | What it does |
|---|---|
run_ai_visibility_audit(website_url, email?, name?, role?) | Instant in-chat snapshot: AI crawler access (GPTBot, ClaudeBot, PerplexityBot, CCBot, Google-Extended), JSON-LD structured data, and llms.txt. Include an email to also receive the full scored report — 0–100 across six pillars — as a PDF. role accepts Real Estate Agent, Attorney, Founder or Other and tilts the scoring toward local entity signals, reviews and directories. |
find_ai_citations(query, domain) | Given a buyer question ("best personal injury lawyer in Miami") and a domain, returns the sources AI engines actually cite when answering it, tagged by engine, plus an appears in X of N count for the domain. The ranked source list is the off-site target list. |
book_strategy_call() | Returns a link to book a strategy call with Specularis. |
Passing email to run_ai_visibility_audit sends a report and registers the person as a Specularis lead. Omit it for the snapshot alone.
Without an MCP client
The same scan engine is reachable over plain HTTP, with no key and no connector:
curl -s "https://specularis-mcp-audit-production.up.railway.app/api/scan?d=example.com"Pass a bare hostname — no scheme, no path. It returns the full structured scan: per-bot fetch results, browser-vs-bot word counts for render-gap detection, parsed schema types, llms.txt, sitemap, and the six pillar scores. Useful for scanning domains in bulk.
If inconclusive is true, the scan could not complete — read inconclusiveReason and don't report a score.
What the full audit measures
Each bot is fetched with its real published user agent, so the result is what the engine itself would receive — not what a browser sees.
The report scores six pillars out of 100:
| Pillar | Max | What it covers |
|---|---|---|
access | 20 | Whether GPTBot, ClaudeBot and PerplexityBot can actually reach and receive the page |
entity | 15 | Organization / Person / LocalBusiness schema, sameAs, address |
content | 15 | Whether the text answers the questions buyers actually ask |
offsite | 30 | The directories, review platforms and threads AI engines cite |
freshness | 10 | Whether the content is maintained |
technical | 10 | Sitemap, llms.txt, render gaps, crawlability |
offsite is deliberately the largest pillar — more than access and entity combined. That reflects how the engines behave: they cite third-party corroboration far more often than a company's own marketing pages, so a technically flawless site can still be invisible.
A note on measuring "blocked". A real block is a 403, or a genuine interstitial with under 80 words of page text. Bot-protection layers return challenge pages intermittently, and counting those as blocks inflates the result — we published numbers once that were wrong for exactly this reason, and corrected them. Re-run before reporting a block.
Across 561 US businesses scanned in 2026, roughly half were effectively invisible to AI engines.
Use it as an agent skill
SKILL.md packages this as a portable agent skill in the open SKILL.md format — when to run an audit, how to read every field it returns, and the order to apply the fixes in. It works against either the MCP tools or the HTTP endpoint above.
Self-hosting
The server is a single-file Node app (Streamable HTTP transport).
npm install
npm startPoint any MCP client at http://localhost:3000/mcp.
| Variable | Purpose |
|---|---|
N8N_WEBHOOK_URL | Backend audit engine endpoint for the full PDF report |
CONTACT_URL | Booking link returned by book_strategy_call |
AUDIT_URL | Web-form fallback link included in responses |
PORT | Listen port (default 3000) |
PERPLEXITY_API_KEY | Primary engine for find_ai_citations |
ANTHROPIC_API_KEY | Adds Claude as a second engine |
GEMINI_API_KEY | Adds Gemini as a third engine |
OPENAI_API_KEY | Adds ChatGPT as a fourth engine |
OPENAI_MODEL | Model for the ChatGPT engine (default gpt-5-mini) |
FINDER_DAY_MAX | Global daily cap on citation-finder runs (default 250) |
find_ai_citations needs at least one engine key. The engines array in each response reports which ones actually ran, so only claim the engines it names.
Who's behind it
Built by Specularis — a GEO/AEO agency helping businesses get found and cited by AI engines. The audit is free; the report is the real deliverable.
- Free audit (web form): https://specularisinc.com/free-audit
- Contact: https://specularisinc.com/contact
License
MIT
Questions fréquentes
Qu'est-ce que Specularis AI Visibility Audit ?
Free AI visibility (GEO/AEO) audit: can ChatGPT, Claude and Perplexity find and cite your website?
Comment installer Specularis AI Visibility Audit ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http specularis-ai-visibility-audit 'https://specularis-mcp-audit-production.up.railway.app/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour Specularis AI Visibility Audit ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
Specularis AI Visibility Audit est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient Specularis AI Visibility Audit ?
Il est publié par AdevAarons. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.