Geo Audit MCP

geo-audit-mcp

GEO（Generative Engine Optimization）サイト監査用の軽量 MCP サーバーです。6 つの柱にわたる 31 項目のシグナル（技術的なクロール可能性、コンテンツ構造、スキーマとメタデータ、E-E-A-T、引用への対応、ガバナンス）をチェックし、スコア、柱ごとの内訳、実行可能な修正プロンプトを返します。

このサーバーが提供するツールは 1 つのみです。

geo_site_audit

出力形式

{
  "score": 72,
  "pillars": {
    "technical": { "pass": 4, "fail": 1, "warn": 0, "na": 0, "total": 5, "pct": 80 },
    "content": { "pass": 3, "fail": 0, "warn": 1, "na": 0, "total": 4, "pct": 88 },
    "schema": { "pass": 2, "fail": 1, "warn": 1, "na": 0, "total": 4, "pct": 63 },
    "eeat": { "pass": 4, "fail": 1, "warn": 2, "na": 0, "total": 7, "pct": 71 },
    "citations": { "pass": 6, "fail": 1, "warn": 3, "na": 0, "total": 10, "pct": 75 },
    "governance": { "pass": 1, "fail": 0, "warn": 0, "na": 0, "total": 1, "pct": 100 }
  },
  "checks": [
    { "id": "T1", "pillar": "technical", "title": "Page reachable over HTTPS", "status": "pass", "message": "Page returned HTTP 200." },
    { "id": "B1", "pillar": "content", "title": "Answer-first opening mentions brand", "status": "fail", "message": "Add a 2–3 sentence opening that names your brand...", "evidence": "Welcome to our platform..." }
  ],
  "fixPrompt": "You are improving GEO readiness for MyBrand...",
  "summary": "- [Content] Improve heading hierarchy...",
  "stats": { "words": 1523, "headings": 14, "externalLinks": 8, "jsonLdBlocks": 2 },
  "auditedUrl": "https://example.com/page"
}

各項目の意味

フィールド	説明
score	GEO 対応度の総合スコア（0～100）。6 つの柱を重み付けして算出します
pillars	柱ごとの合格／不合格／警告の件数と割合
checks	ステータス、メッセージ、証拠を含む 31 項目すべてのチェック結果
fixPrompt	実行可能な修正プロンプト。Claude、Cursor、またはサイトエディターに貼り付けてください
summary	人が読める形式の概要（OPENAI_API_KEY が設定されている場合は LLM が生成し、未設定の場合は自動生成されます）
stats	ページ単位の統計情報：単語数、見出し、外部リンク、JSON-LD ブロック数
auditedUrl	監査対象となった正規化済み URL

BYOK

このサーバーではご自身の API キーを使用します。利用状況と請求は、各プロバイダーのアカウントに紐づきます。API キーは必須ではありません。静的 HTML 分析を使って監査を完全にオフラインで実行できます。任意で OPENAI_API_KEY を設定すると、LLM を使用した概要生成が可能になります。

必須の環境変数

変数	必須	説明
OPENAI_API_KEY	任意	LLM による監査概要の生成に使用する OpenAI API キーです。未設定の場合、チェック結果から概要を自動生成します。
OPENAI_BASE_URL	任意	OpenAI 互換のカスタムエンドポイント（デフォルト：https://api.openai.com/v1）。
OPENAI_HTTPS_PROXY	任意	OpenAI API 呼び出しに使用する HTTPS プロキシ URL（例：http://127.0.0.1:7890）。
WEBSITE_HTTPS_PROXY	任意	対象ウェブサイトの取得に使用する HTTPS プロキシ URL。

クイックスタート

npm install
npm run build

MCP 設定例

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "geo-audit-mcp": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH>/geo-audit-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>"
      }
    }
  }
}

Cursor / Windsurf / その他の MCP クライアント

{
  "mcpServers": {
    "geo-audit-mcp": {
      "command": "node",
      "args": ["<ABSOLUTE_PATH>/geo-audit-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENAI_HTTPS_PROXY": "http://127.0.0.1:7890"
      }
    }
  }
}

ツールの入力

{
  "url": "https://example.com/pricing",
  "brand_name": "Example",
  "page_type": "product"
}

パラメーター	必須	説明
url	はい	監査する完全な URL です。https:// または http:// で始まる必要があります。
brand_name	いいえ	ブランド名です。冒頭コンテンツのチェック（B1）の精度が向上します。
page_type	いいえ	ヒント：homepage、product、または article。省略すると URL パスから自動検出されます。

チェック項目（31 項目のシグナル、6 つの柱）

技術的なクロール可能性（5 項目）

T1～T5：HTTPS での到達可能性、AI クローラーに対する robots.txt のルール、llms.txt の有無、JavaScript を使わない場合の読み取り可能なテキスト、正規 URL。

コンテンツ構造（4 項目）

B1～B4：冒頭でのブランドへの言及、見出しの階層、段落の分割、引用可能なブロック（リスト／FAQ）。

スキーマとメタデータ（4 項目）

C1～C4：タイトルとメタディスクリプション、Organization／WebSite の JSON-LD、ページ種別の構造化データ、FAQPage スキーマ。

E-E-A-T（7 項目）

E1～E7：著者／エンティティのシグナル、表示されている署名欄、About／Contact リンク、sameAs を含む Organization JSON-LD、Privacy／Terms リンク、権威性のあるレビューへのリンク、公開日。

引用への対応（10 項目）

R1～R10：外部参照リンク、権威性のあるレビューサイトのドメイン、リンクの多様性、コンテンツ内のリンク、引用可能なブロック、引用可能な事実、出典の明記、エンティティの sameAs、ページの引用可能性スコア、引用に適した文章の割合。

ガバナンス（1 項目）

G1：サイトマップへの到達可能性。

メモ

• 監査では、ブラウザーに似たUser-Agentを使用した直接HTTPリクエストで対象ページを取得します。ボット対策が厳しいサイトでは、リクエストがブロックされることがあります。
• 監査はステートレスです。データは保存も記録もされません。
• SSRF対策が組み込まれており、内部IP、localhost、クラウドのメタデータエンドポイントはブロックされます。
• OPENAI_API_KEYが設定されている場合、要約ではデフォルトでGPT-4.1-miniが使用されます。変更するにはOPENAI_MODELを設定してください。
• 修正プロンプトは、Claude、Cursor、またはサイトエディターにそのまま貼り付けられるよう設計されています。対象はHTML、メタタグ、JSON-LDのみです。
• 実際の認証情報をgitにコミットしないでください。環境変数のみを使用してください。

gptmelo.comが開発 — ChatGPT向けのGEOブランドモニターです。