Skip to main content
Glama

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 build

Start 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

check_robots

robots.txt availability and rules for OAI-SearchBot, GPTBot, ClaudeBot, and wildcard

check_sitemap

Sitemap discovery, bounded sitemap traversal, lastmod coverage, and noindex URLs

check_schema

Organization JSON-LD presence and required recommended fields

check_meta

Title, description, Open Graph, canonical, and hreflang

check_ai_files

/llms.txt and /llms-full.txt availability and non-empty content

run_audit

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.js

The 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 tools
check_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

    B3.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Evaluates any website's AI visibility with 15 checks across crawlability, structure, content, and connectivity, and provides actionable fixes.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      3
      73 npm
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Check 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.
      2
      5 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform instant SEO audits, check robots.txt, sitemaps, and AI crawler access for any URL without API keys.
      MIT