geo-audit
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@geo-audit run a full GEO audit on https://example.com and list the top fixes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
geo-audit
A keyless Model Context Protocol (MCP) server for diagnostic GEO and AI search visibility checks over public HTTP. It does not promise rankings or inclusion in any AI answer engine.
更多 AI agent 技能,见 Skillπ(skillpi.com)
Requirements
Node.js 20 or newer
npm or pnpm
Related MCP server: maxaeo-ai-visibility-mcp
Install and build
npm install
npm run buildStart the MCP server over stdio with npm start. Configure your MCP host with the command node and argument dist/index.js, using this directory as its working directory. The server writes protocol messages only to stdout; diagnostics go to returned tool content.
Tiers
The default TIER=free exposes check_robots, check_sitemap, check_meta, and run_audit. Free run_audit performs those three checks, allows three full audits per UTC day by default, and stores the counter under ~/.geo-audit/usage.json with owner-only permissions.
TIER=paid exposes all six tools: check_robots, check_sitemap, check_schema, check_meta, check_ai_files, and run_audit. Paid full audits run all five checks, include the last local score when available, and append a local history row to ~/.geo-audit/history.jsonl. If writing history fails, the audit still succeeds and reports history_available: false. Set FREE_AUDITS_PER_DAY to change the free limit. This switch only changes local behavior; it does not implement billing or remote licensing.
The Skill file is always free and MIT licensed. The intended paid offering is an MCPize-hosted MCP service; this project does not implement payment or subscription enforcement.
Tools
Every tool accepts { "url": "https://example.com/" }.
Tool | Checks |
| robots.txt availability and rules for OAI-SearchBot, GPTBot, ClaudeBot, and wildcard |
| Sitemap discovery, bounded sitemap traversal, lastmod coverage, and noindex URLs |
| Organization JSON-LD presence and required recommended fields |
| Title, description, Open Graph, canonical, and hreflang |
|
|
| Combined score, grade, prioritized fixes, Markdown report, and (paid) local history |
Checks use public unauthenticated HTTP only. Targets resolving to loopback, private, link-local, or reserved IP ranges are rejected; redirects are revalidated, capped at three, and requests time out after ten seconds. The tool does not access authenticated pages, submit forms, change remote state, or send content to an LLM.
Sample audits
Example snapshots are in examples/. They are dated observations of public sites and may change as those sites change.
Example summary: the included Skillπ snapshot scored 58/100 (差), and 36kr scored 48/100 (差). Scores measure only the documented checks and are not rankings.
Development
npm run build
npx @modelcontextprotocol/inspector node dist/index.jsThe Inspector command is for local manual MCP tool validation. No credentials are needed. Paid mode can be selected with TIER=paid in the process environment.
Example paid audit through MCP Inspector CLI:
TIER=paid npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call --tool-name run_audit --tool-arg url=https://skillpi.com/At the included snapshot, Skillπ scored 58/100 (差) and 36kr scored 48/100 (差). See the dated reports for check-by-check evidence and prioritized fixes.
License
MIT. See LICENSE.
本审计为诊断性检查,不保证排名、不保证被 ChatGPT 提及。
Available Tools
4 toolscheck_metaC
检查 title、description、Open Graph、canonical 与 hreflang。
Inputs: url (required).
check_robotsB
检查 robots.txt 对 OAI-SearchBot、GPTBot、ClaudeBot 的规则。
Inputs: url (required).
check_sitemapC
检查 sitemap 的数量、lastmod 与 noindex 页面。
Inputs: url (required).
run_auditB
运行 GEO 可见度诊断并生成 Markdown 报告。
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct audit surface: robots.txt rules, sitemap structure, meta tags, and a full aggregate audit run. The only overlap is run_audit vs. the individual checks, but that aggregate-vs-detail pattern is clear and intentional, so an agent can easily pick the right tool.
All four tools follow a consistent verb_noun snake_case pattern (check_robots, check_sitemap, check_meta, run_audit). The single verb deviation (run_audit) is semantically appropriate for an aggregate action.
Four tools is a tight, well-scoped set for a GEO audit, with each tool earning its place. However, the surface is slightly thin—structured-data or content-readability checks would be natural additions—so it's reasonable rather than ideal.
The set covers the core technical GEO checks (robots/bots, sitemap, meta/OG/canonical/hreflang) plus an aggregate report generator, giving a coherent lifecycle. Minor gaps exist—e.g., structured data (JSON-LD/schema.org) and llms.txt or page-content readability checks are often central to GEO and are absent.
Maintenance
Related MCP Connectors
Scan any public site for AI-agent visibility; get scored findings, a machine-readable fix pack, and
Free SEO, AI visibility (AI crawlers, llms.txt, JSON-LD) and security-header checks for any URL.
Scan any public website and see how ready it is for AI agents and AI search, explained plainly.
Audit any site's AI visibility from your assistant: crawler access, rendering, and schema.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEvaluates any website's AI visibility with 15 checks across crawlability, structure, content, and connectivity, and provides actionable fixes.MIT
- AlicenseAqualityCmaintenanceEnables AI agents to check whether a public website is crawlable, understandable, and ready for AI search workflows through local-only audits of robots.txt, sitemaps, metadata, and llms.txt.373 npm2MIT
- AlicenseAqualityCmaintenanceCheck whether a website is visible to AI search engines (ChatGPT, Perplexity, Claude, Google AI Overviews). Returns a 0-100 readiness score, a grade, and a specific fix for each gap. Dependency-free, no API keys.25 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform instant SEO audits, check robots.txt, sitemaps, and AI crawler access for any URL without API keys.MIT