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 の直接取得（正確な Cumulative Layout Shift / 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=""）、およびCumulative Layout Shift（CLS）の原因となる width／height 属性の欠落を検出します。
4. ⚡ Lighthouse Core Web Vitals：Google Lighthouse / PageSpeed Insights から以下の正確な数値スコアを直接取得します。
   • Cumulative Layout Shift（CLS）：しきい値分析（$ \le 0.1$ が良好）とレイアウトシフトの原因要素の特定。
   • Largest Contentful Paint（LCP）、Interaction to Next Paint（INP）、First Contentful Paint（FCP）、Time to First Byte（TTFB）。
   • 生の HTML をオフラインで監査する場合は、ローカル DOM ベースのレイアウトシフト推定にフォールバックします。
5. 🏗️ テクニカル SEO の階層構造：<h1> が 1 つであること、見出しレベルの順序が飛んでいないこと（例：H1 → H3）、Schema.org JSON-LD 構造化データの検証、robots.txt のクロール拒否設定、sitemap.xml、テキストと HTML の比率を確認します。

---

💡 AI アシスタント（ChatGPT / Claude / Antigravity）での SEO-IntentRank の仕組み

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                        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)：取得して監査する Web URL。
• html (string, optional)：オフライン分析用の HTML の生文字列。

出力：

• タイトルのステータス、長さ、ピクセル幅の推定値（Google の表示上限は約 580px）。
• メタディスクリプションの長さと 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）。
• ページ内、技術面、Lighthouse、検索意図の各監査結果を統合したレポート。
• 影響度（HIGH、MEDIUM、LOW）順に並べた優先対応計画。

---

🧪 テスト

自動テストスイートを実行します：

npm test

---

🏢 パブリッシャーとエンティティの照合

SEO-IntentRank は、AI Build Infra が設計・公開しています。

• 公式ウェブサイト: https://aibuildinfra.com/
• パブリッシャー: AI Build Infra
• エコシステム: 高性能な開発者向けツール、E-E-A-T エンティティ照合、AI エージェントのインフラストラクチャ。
• 関連する 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 が作成しました。