mcp-seo-audit

atomno-mcp-seo-audit

detail.web エンジンを搭載した、テクニカル SEO と GEO の監査向け MCP（Model Context Protocol）サーバーです。LLM の推測ではなく、実測値を提供します。Cursor、Claude Desktop、または任意の MCP クライアントから実行できます。8 つのツール： audit_site（決定論的な 0–100 の健全性スコアとレターグレード、8 カテゴリーにわたる 78 項目のチェック、さらに ChatGPT／Perplexity／Google AI Overviews での可視性を示す GEO サブスコア）、audit_diff（前回のスナップショットとの比較）、robots.txt と sitemap.xml のバリデーター、JSON-LD とメタ／OpenGraph のビルダー、各チェックの修正方法の解説を利用できます。TLS、リダイレクト、TTFB、AI クローラー（GPTBot）のアクセス、llms.txt を検査します。無料プランと PRO+（ディープクロール、GEO、40 項目以上の詳細チェック）を提供します。API キーを使うと、PRO+ プラン以上で詳細なエンジンを利用できます（無料プランと PRO+ を参照）。

LLM と組み合わせる理由

言語モデルだけでは、トレーニングデータと、せいぜいレンダリング済みの 1 ページからサイトを推測することしかできません。TLS 証明書の有効期限を直接読み取ったり、応答時間を測定したり、sitemap.xml を解析したり、robots.txt で GPTBot がブロックされているか確認したりすることはできません。このサーバーは、実際の HTTP リクエスト、セキュリティヘッダー、リダイレクトチェーン、構造化データの検証といったチェックを実行し、決定論的なスコア（同じサイトなら同じ数値）を返します。クライアント向けのレポートにも掲載できるほど、再現性があります。サーバーを計測器、LLM を測定結果を解釈する分析役と考えてください。この 2 つを組み合わせると、最も効果的に機能します。

得られるもの

• audit_site(url, depth=1, lang="ru") — 1 回の呼び出しで、以下が返されます。
  • ヘルススコア 0–100（高いほど良好）と、レターグレード A–F。
  • カテゴリ別（セキュリティ、SEO とインデックス登録、パフォーマンス、GEO など）に分類された問題。それぞれに pass / warn / fail のステータスが付いています。
  • 人が読みやすい短い概要。
• audit_diff(url, lang="ru") — サイトを再監査し、前回の実行結果と比較します。ヘルス／スコアの差分と、悪化または改善したチェックがわかります。最初の呼び出しでベースラインが保存されます。これは、一度限りの LLM への質問ではできない、サイトの経時的な追跡です。状態を保持する機能のため、PRO+ プラン以上のキーが必要です。
• list_checks(lang="ru") — エンジンのチェック項目をカテゴリ別にまとめた全カタログです。各項目には free／PRO バッジが付いているため、無料プランの対象範囲と PRO で利用できる機能を、ユーザーとエージェントが正確に確認できます。
• explain_issue(check_id, lang="ru") — 個別のチェック項目を詳しく説明します。その重要性と修正方法がわかります。audit_site または list_checks の check_id を渡してください。タイトルとカテゴリはローカライズされますが、詳細なアドバイスは現在ロシア語です（advice_lang フィールドに表示されます）。
• validate_robots(content, lang="ru") — robots.txt を貼り付けると、構文上の問題、Sitemap: ディレクティブの有無、レンダリングボットに対する CSS／JS のブロック状況、明示的にブロックされている AI クローラー（GPTBot、ClaudeBot など）が返されます。フェッチは行わず、指定されたテキストを検証します。
• check_sitemap(url, lang="ru") — URL からサイトマップをフェッチし、形式（urlset／sitemapindex）、URL 数、よくある問題（404、XML 以外のコンテンツタイプ、http:// リンク、<lastmod> の欠落、ファイルあたり 50k 件の上限）を報告します。フェッチはサーバー側で SSRF 対策されています。
• build_jsonld(type, fields, lang="ru") — そのまま貼り付けて使える schema.org の JSON-LD <script>（Organization、LocalBusiness、Article、Product、FAQPage、BreadcrumbList、WebSite）を生成し、必須／推奨フィールドのうち不足しているものを通知します。データを捏造することはなく、渡された情報のみを使用します。
• build_meta(fields, lang="ru") — <head> のメタタグ（title、description、canonical、Open Graph、Twitter Card）を生成し、title（50–60 文字）と description（120–160 文字）の長さを検証します。

Free と PRO+ の比較

	Free（キーなし）	PRO+ 以上（API キー）
チェック	基本的な技術チェック	さらに詳しい 40 以上のチェック（E-E-A-T、Schema.org、Goldmine title）
GEO	4 つの GEO シグナル	GEO 対応度のサブスコアと詳細な GEO チェック
クロール	1 ページ	最大 20 ページの詳細クロール（depth=2/3）

API／MCP を利用できるプランはどれですか？ プログラムからのアクセス（このサーバー、audit_diff、詳細クロール、GEO サブスコア）は、PRO+（pro_plus）、Business、Enterprise で有効になります。エントリーレベルの PRO プランと Free プランはウェブダッシュボードのみです。これらのプランで発行された API キーは認証されますが、返される結果は引き続き free のものです。プログラムからアクセスするには、PRO+ 以上を選択してください。

監査エンジン自体はサーバー上で動作します。このパッケージは薄いクライアント（HTTP 呼び出しとフォーマットのみ）です。

インストール

uvx atomno-mcp-seo-audit

または、MCP クライアントの設定（mcp.json）に追加してください。

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"]
    }
  }
}

設定

すべて環境変数で設定します。

変数	デフォルト値	用途
DETAILWEB_API_BASE	https://api.detailweb.ru	バックエンドのベース URL
DETAILWEB_API_KEY	—	PRO+ プラン以上の API キー（dwa_...）。キーがない場合、または Free／PRO の場合は無料プランになります
DETAILWEB_TIMEOUT	60	HTTP タイムアウト（秒）
DETAILWEB_LANG	ru	課題タイトルのデフォルト言語（ru / en）

無料プランはキーも登録も不要です。上記のコマンドを実行するだけで使えます。 プログラムからのアクセス（40 以上の詳細チェック、GEO サブスコア、ディープクロール、audit_diff）には、PRO+ プラン以上のキーが必要です。エントリーレベルの PRO プランはウェブダッシュボード専用で、そのキーでは無料の結果が返されます。現在はリクエストに応じて提供しています。[email protected] までメールするか、audit.detailweb.ru からお問い合わせください。アカウントが有効になったら、Dashboard → Account → API keys（dwa_…。キーは一度だけ表示されます）でキーを作成し、DETAILWEB_API_KEY に設定してください。

使用例

「https://example.com を監査して」

エージェントが audit_site("https://example.com") を呼び出し、ヘルススコア、評価、修正すべき問題の一覧を取得します。

ライセンス

MIT © atomno-mcp。オープンソースのクライアントは、プロプライエタリなホスト型バックエンドと通信します。

---

🇷🇺 ロシア語

detail.web エンジンを使用した、テクニカル SEO 監査用 MCP サーバーです。AI エージェント（Cursor、Claude Desktop、その他の MCP クライアント）から直接監査を実行できます。ヘルススコア、8 カテゴリーの問題、GEO サブスコア（ChatGPT、Perplexity、AI Overviews など、AI 検索での可視性）を確認できます。

ニューラルネットワークと組み合わせて使う理由。 言語モデルは、それ自体では学習データ、よくてもレンダリング済みの 1 ページだけをもとにサイトを判断します。SSL 証明書の有効期限を直接読み取ったり、応答時間を測定したり、sitemap.xml を解析したり、robots.txt で GPTBot がブロックされているか確認したりすることはできません。このサーバーは、HTTP リクエスト、ヘッダー、リダイレクト、構造化データなどを実際にチェックし、決定論的なスコア（同じサイトなら同じ数値）を返すため、クライアント向けのレポートに使用できます。これは測定器であり、ニューラルネットワークは測定値を読む分析担当者です。組み合わせて使うのが最も効果的です。

ツール： audit_site（監査＋スコア＋GEO）、audit_diff（前回のチェックからの変更点 — 状態を保持。PRO+ 以上のプラン）、list_checks（Free／PRO のチェック一覧）、explain_issue（重要な理由＋修正方法）、validate_robots、check_sitemap、build_jsonld、build_meta。

インストール：

uvx atomno-mcp-seo-audit

MCP クライアントの設定（mcp.json）：

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"],
      "env": { "DETAILWEB_LANG": "ru" }
    }
  }
}

無料プラン（基本チェック、1 ページ）は、キーも登録も不要ですぐに利用できます。プログラムからのアクセス（40 以上の詳細チェック、GEO サブスコア、最大 20 ページのディープクロール、audit_diff）には、PRO+（pro_plus）以上のプラン（Business、Enterprise）のキーが必要です。エントリーレベルの PRO（1290 ₽）と Free はウェブ管理画面専用です。これらのプランのキーは認証を通過しますが、結果は無料プランのままです。現在はリクエストに応じてプランを提供しています。[email protected] へのメール、または audit.detailweb.ru からお問い合わせください。アカウントが有効になったら、管理画面の アカウント → API キー でキー（dwa_…）を作成します（キーは一度だけ表示されます）。キーを env の DETAILWEB_API_KEY に設定してください。ツールと設定の詳細は、上記の英語版をご覧ください。