SEO-IntentRank (Antigravity MCP)

SEO-IntentRank MCP 服务（seo-intentrank）

SEO-IntentRank 的官方 Model Context Protocol（MCP）服务：提供人类搜索意图关键词、技术 SEO 审核、Google Lighthouse Core Web Vitals（CLS/LCP/INP）和页面诊断智能分析。

由 AI Build Infra 开发、维护并发布——为人工智能与搜索引擎优化提供高性能基础设施。

---

🌟 概述

SEO-IntentRank 是由 AI Build Infra 打造的企业级 SEO 诊断 MCP 服务，可为 AI 助手（ChatGPT、Claude Desktop、Google Antigravity、Cursor 和 Perplexity）提供实时网页诊断能力。

它弥合了原始技术抓取数据与真实人类搜索行为之间的鸿沟，提供深入的页面审核、直接获取 Google Lighthouse Core Web Vitals 数据（包括精确的累计布局偏移 / CLS 分数），以及语义化的人类搜索意图关键词提取。

核心功能：

1. 🎯 人类意图关键词引擎：将页面搜索意图分类为信息型、商业调查型、交易型和导航型；综合生成高转化率的自然语言搜索查询；挖掘已解答的问题；并标记 AI 套话和关键词堆砌。
2. 🔍 页面 SEO 检查：扫描 <title>（字符长度和约 580px 的像素宽度估算）、<meta name="description">（CTA 检测）、<meta name="robots">、Open Graph 标签（og:*）、Twitter Cards（twitter:*）和 Canonical URL 验证。
3. 📐 媒体与图片 Alt 审核：检测缺失的 alt 属性、装饰性图片（alt=""），以及可能导致累计布局偏移（CLS）的缺失 width/height 属性。
4. ⚡ Lighthouse Core Web Vitals：直接从 Google Lighthouse / PageSpeed Insights 获取精确数值分数，涵盖：
   • 累计布局偏移（CLS），包括阈值分析（$\le 0.1$ 为良好）和偏移元素根因识别。
   • 最大内容绘制（LCP）、下一次绘制交互（INP）、首次内容绘制（FCP）和首字节时间（TTFB）。
   • 离线审核原始 HTML 时，使用基于本地 DOM 的布局偏移启发式分析作为后备方案。
5. 🏗️ 技术 SEO 层级结构：检查是否仅使用一个 <h1>、标题级别是否存在非顺序跳级（例如 H1 → H3）、Schema.org JSON-LD 结构化数据验证、robots.txt 禁止抓取规则、sitemap.xml 和文本与 HTML 比例。

---

💡 SEO-IntentRank 在 AI 助手（ChatGPT / Claude / Antigravity）中的工作方式

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                        AI Assistant (ChatGPT / Claude / Antigravity)                   │
└───────────────────────────────────────────┬────────────────────────────────────────────┘
                                            │ MCP Tool Calls
                                            ▼
┌────────────────────────────────────────────────────────────────────────────────────────┐
│                        SEO-IntentRank MCP Server (AI Build Infra)                      │
├───────────────────────────────┬────────────────────────────────────────────────────────┤
│ 🎯 extract_human_intent_      │ Categorizes search intent (Informational, Commercial,  │
│    keywords                   │ Transactional, Navigational), synthesizes real queries │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 🔍 scan_onpage_seo            │ Audits Title (pixels/chars), Description, Open Graph,  │
│                               │ Twitter Cards, Canonical tags, & Image Alt dimensions  │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ ⚡ audit_lighthouse_cls_       │ Fetches real CLS, LCP, INP & Web Vitals from Google    │
│    vitals                     │ Lighthouse API + local DOM layout shift heuristics     │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 🏗️ audit_technical_seo        │ Validates single H1, heading skips (H1->H3), Schema    │
│                               │ JSON-LD, Robots.txt disallows, & Sitemap.xml           │
├───────────────────────────────┼────────────────────────────────────────────────────────┤
│ 📊 comprehensive_seo_audit    │ Unified master audit delivering 0-100 score, letter    │
│                               │ grade (A+ to F), and prioritized step-by-step actions  │
└───────────────────────────────┴────────────────────────────────────────────────────────┘

---

🚀 安装与快速开始

使用 NPX 运行

npx -y seo-intentrank

添加到 Antigravity / Claude Desktop / Cursor 配置

将以下内容添加到你的 mcpServers 配置（mcp_config.json 或 claude_desktop_config.json）：

{
  "mcpServers": {
    "seo-intentrank": {
      "command": "npx",
      "args": ["-y", "seo-intentrank"]
    }
  }
}

或用于本地开发：

{
  "mcpServers": {
    "seo-intentrank": {
      "command": "node",
      "args": ["C:/path/to/seo-mcp-server/dist/index.js"]
    }
  }
}

---

🛠️ 可用的 MCP 工具

1. extract_human_intent_keywords

提取高转化率的人类搜索意图关键词，并分析受众的搜索行为。

参数：

• url (string, optional)：有效 URL。
• html (string, optional)：原始 HTML 标记。
• text (string, optional)：纯文章文本。
• targetKeyword (string, optional)：要评估的目标焦点关键词。

输出：

• 主要搜索意图及其百分比分布（informational、commercial、transactional、navigational）。
• 按相关性得分和标题信号排名靠前的人类意图关键词。
• 综合生成的、由该页面解答的自然人类搜索查询。
• 挖掘出的问题及其是否已得到解答的状态。
• 信息增益与 AI 水文评估得分。

---

2. scan_onpage_seo

审核有效 URL 或原始 HTML 字符串中的页面 SEO 元素。

参数：

• url (string, optional)：要获取并审核的网页 URL。
• html (string, optional)：用于离线分析的原始 HTML 字符串。

输出：

• 标题状态、长度及像素宽度估算值（Google 截断阈值约为 580px）。
• Meta 描述长度及是否包含 CTA。
• 完整的 Open Graph 和 Twitter Card 验证结果。
• Canonical 标签状态（自引用、缺失、相对或不匹配）。
• 图片 Alt 标签审核及尺寸缺失检测（用于检测 CLS 风险）。

---

3. audit_lighthouse_cls_vitals

使用 Google Lighthouse / PageSpeed API 和本地 DOM 位移启发式方法，直接审核 Core Web Vitals。

参数：

• url (string, optional)：要进行基准测试的有效 URL。
• html (string, optional)：用于计算本地布局位移风险的 HTML 片段。
• strategy (string, optional)：'mobile'（默认）或 'desktop'。
• apiKey (string, optional)：可选的 Google PageSpeed Insights API 密钥。

输出：

• 累积布局偏移（CLS）得分、评级（GOOD、NEEDS_IMPROVEMENT、POOR）及导致布局偏移的元素。
• LCP、INP、FCP、TTFB 测量值。
• Lighthouse 类别得分（性能、SEO、无障碍、最佳实践）。

---

4. audit_technical_seo

检查页面的技术架构和语义结构。

参数：

• url (string, optional)：有效 URL。
• html (string, optional)：原始 HTML 字符串。
• robotsTxtContent (string, optional)：要解析的原始 robots.txt 字符串。
• sitemapXmlContent (string, optional)：要解析的原始 sitemap.xml 字符串。

输出：

• 标题结构验证（H1 数量、标题级别是否存在非连续跳跃）。
• Schema.org JSON-LD 语法和 @type 验证。
• 内容字数、文本与 HTML 比率，以及内容单薄警告。
• Robots 指令和 Sitemap URL 数量。

---

5. comprehensive_seo_audit

一站式 SEO 审核工具，可并行运行所有工具并生成执行摘要报告。

参数：

• url (string, optional)：有效 URL。
• html (string, optional)：原始 HTML 标记。
• strategy (string, optional)：'mobile' | 'desktop'。
• apiKey (string, optional)：可选的 Google PageSpeed API 密钥。
• targetKeyword (string, optional)：目标焦点关键词。

输出：

• 总体 SEO 得分（0-100）和字母评级（A+、A、B、C、D、F）。
• 汇总页面 SEO、技术 SEO、Lighthouse 和意图审核结果。
• 按影响程度排序的优先行动计划（HIGH、MEDIUM、LOW）。

---

🧪 测试

运行自动化测试套件：

npm test

---

🏢 发布者与实体协调

SEO-IntentRank 由 AI Build Infra 研发并发布。

• 官方网站：https://aibuildinfra.com/
• 发布者：AI Build Infra
• 生态系统：高性能开发者工具、E-E-A-T 实体协调和 AI Agent 基础设施。
• 相关 MCP 服务：HumanCraft UI (@aibuildinfra/humancraft)

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "SEO-IntentRank MCP Server",
  "applicationCategory": "DeveloperApplication",
  "operatingSystem": "Cross-platform",
  "author": {
    "@type": "Organization",
    "name": "AI Build Infra",
    "url": "https://aibuildinfra.com/"
  },
  "publisher": {
    "@type": "Organization",
    "name": "AI Build Infra",
    "url": "https://aibuildinfra.com/"
  },
  "url": "https://github.com/AI-BuildInfra/SEO-intentrank",
  "downloadUrl": "https://www.npmjs.com/package/seo-intentrank"
}

---

📄 许可证

MIT 许可证。由 AI Build Infra 倾心打造。