seo-geo-audit-mcp

URL → traditional SEO plus GEO (Generative Engine Optimization) visibility audit. A 0–100 visibility score, per-category scores, prioritized findings (CRITICAL / WARNING / OK), and a remediation checklist — called by an AI agent over MCP.

Current version: 1.0.0

Tier: PanStories / Sartbot portfolio — T1-1 (highest priority). Moat: proprietary methodology extracted from the private SEO-GEO skill. Only audit outputs are exposed.

🌐 English · 简体中文 · 繁體中文

---

English

What it does

Tool	Purpose
audit_url	Fast single-page audit (HTTPS, lang, title/meta, canonical→200, viewport, robots+sitemap Content-Type guard, OG, JSON-LD presence).
audit_deep	Full audit: basic + crawler-access sweep (Cloudflare Search/Agent vs Training classification) + directory/GEO discovery.
get_checklist	Severity-tagged remediation checklist.
report_issue	Free feedback loop (false-positive / missing-check reports).

Every tool returns structuredContent (machine JSON) and a content[0].text human summary.

Key differentiators

• GEO + SEO in one pass — not just traditional on-page SEO.
• Cloudflare crawler sweep that distinguishes Search/Agent bots (must reach) from Training bots (a 403 is expected and not a bug). Reads CF-Cache-Status to defeat cache-masked 200s.
• SPA-fallback guard — checks Content-Type, not just HTTP status, so a missing robots.txt/sitemap.xml served as index.html is correctly flagged.
• No ranking guarantees, ever — we audit readiness; we never sell outcomes.

Quick start (local, zero dependencies)

node src/stdio-server.mjs
# then send JSON-RPC lines, e.g.:
# {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}
# {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"audit_url","arguments":{"url":"https://example.com"}}}

Audit a local HTML file (no network): arguments:{"url":"./sample.html"}.

Tests & gates

node --test                 # unit + local-fixture audit tests
node scripts/check-p0.mjs   # UI redline gate (emoji/gradient/placeholder/CDN/misleading)
node scripts/showcase.mjs https://example.com   # generates showcase-report.html

Deploy (Apify Pay-Per-Event)

Requires your Apify KYC for Agentic Payments (cannot be delegated). npm i (hosted deps) → apify login → apify push. Pricing lives in .actor/actor.json.

Disclaimer

Scores reflect audit signals only and do not guarantee search or generative-engine rankings.

License

Proprietary — source available on request. See LICENSE.

---

简体中文

它做什么

工具	用途
audit_url	快速单页审计（HTTPS、语言、标题/描述、canonical→200、视口、robots+sitemap 内容类型校验、OG、JSON-LD 存在性）。
audit_deep	完整审计：基础检查 + 爬虫可达性扫描（Cloudflare 搜索/代理机器人 vs 训练机器人分类）+ 目录与 GEO 发现。
get_checklist	按严重度标注的修复清单。
report_issue	免费反馈通道（误报 / 漏检上报）。

每个工具都返回 structuredContent（机器可读 JSON）和 content[0].text 人工可读摘要。

核心差异点

• GEO + SEO 一次完成 —— 不止传统页面级 SEO。
• Cloudflare 爬虫扫描：区分搜索/代理机器人（必须可达）与训练机器人（返回 403 属正常、并非故障）。读取 CF-Cache-Status 以识破被缓存掩盖的 200。
• SPA 兜底校验：检查 Content-Type 而非仅看 HTTP 状态码，因此把缺失的 robots.txt/sitemap.xml 当作 index.html 返回时能被正确标记。
• 绝不承诺排名 —— 我们审计就绪度，不售卖结果。

快速开始（本地、零依赖）

node src/stdio-server.mjs
# 然后发送 JSON-RPC 行，例如：
# {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}
# {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"audit_url","arguments":{"url":"https://example.com"}}}

审计本地 HTML 文件（无需联网）：arguments:{"url":"./sample.html"}。

测试与质量门

node --test                 # 单元测试 + 本地样本审计测试
node scripts/check-p0.mjs   # UI 红线门禁（emoji/渐变/占位文案/CDN/误导性表述）
node scripts/showcase.mjs https://example.com   # 生成 showcase-report.html

部署（Apify 按事件计费）

需要你的 Apify 实名认证（Agentic Payments，无法代为完成）。 npm i（托管依赖）→ apify login → apify push。计费定义在 .actor/actor.json。

免责声明

分数仅反映审计信号，不保证搜索或生成式引擎的排名。

许可证

专有授权 —— 源码按需提供。详见 LICENSE。

---

繁體中文

它做什麼

工具	用途
audit_url	快速單頁審計（HTTPS、語言、標題/描述、canonical→200、視口、robots+sitemap 內容類型校驗、OG、JSON-LD 存在性）。
audit_deep	完整審計：基礎檢查 + 爬蟲可達性掃描（Cloudflare 搜尋/代理機器人 vs 訓練機器人分類）+ 目錄與 GEO 發現。
get_checklist	依嚴重度標註的修復清單。
report_issue	免費回饋通道（誤報 / 漏檢上報）。

每個工具都回傳 structuredContent（機器可讀 JSON）與 content[0].text 人工可讀摘要。

核心差異點

• GEO + SEO 一次完成 —— 不止傳統頁面級 SEO。
• Cloudflare 爬蟲掃描：區分搜尋/代理機器人（必須可達）與訓練機器人（回傳 403 屬正常、並非故障）。讀取 CF-Cache-Status 以識破被快取掩蓋的 200。
• SPA 兜底校驗：檢查 Content-Type 而非僅看 HTTP 狀態碼，因此把缺失的 robots.txt/sitemap.xml 當作 index.html 回傳時能被正確標記。
• 絕不承諾排名 —— 我們審計就緒度，不販售結果。

快速開始（本地、零依賴）

node src/stdio-server.mjs
# 然後發送 JSON-RPC 行，例如：
# {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}
# {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"audit_url","arguments":{"url":"https://example.com"}}}

審計本地 HTML 檔案（無須聯網）：arguments:{"url":"./sample.html"}。

測試與品質門

node --test                 # 單元測試 + 本地樣本審計測試
node scripts/check-p0.mjs   # UI 紅線門禁（emoji/漸變/占位文案/CDN/誤導性表述）
node scripts/showcase.mjs https://example.com   # 產生 showcase-report.html

部署（Apify 按事件計費）

需要你的 Apify 實名認證（Agentic Payments，無法代為完成）。 npm i（託管依賴）→ apify login → apify push。計費定義在 .actor/actor.json。

免責聲明

分數僅反映審計訊號，不保證搜尋或生成式引擎的排名。

授權

專有授權 —— 源碼依需求提供。詳見 LICENSE。