@rog0x/mcp-seo-tools

mcp-seo-tools

AI エージェントに SEO 分析ツール一式を提供する MCP（Model Context Protocol）サーバーです。外部 API キーを使わずに、公開されている任意の Web ページについて、メタタグ、見出し構造、リンク切れ、キーワード密度、ページ速度、サイトマップの健全性を分析できます。

ツール

ツール	説明
seo_meta_analyze	メタタグ、Open Graph、Twitter Card タグをスコアリング付きで監査します
seo_heading_check	H1～H6 の階層を検証し、レベルの飛びや重複を検出します
seo_link_check	リンク切れ、リダイレクト、アンカーテキストの欠落を検出します
seo_keyword_density	キーワードの出現頻度を測定し、ターゲットキーワードの配置を確認します
seo_page_speed	TTFB、読み込み時間、HTML サイズ、リソース数を測定します
seo_sitemap_parse	sitemap.xml を解析し、鮮度、重複、準拠状況を確認します

要件

• Node.js 18+
• API キーは不要です。すべてのツールで直接 HTTP リクエストと HTML 解析を使用します

インストール

git clone <repo-url>
cd mcp-seo-tools
npm install
npm run build

Claude Code での使用方法

Claude Code の MCP 設定に追加します。

claude mcp add seo-tools node D:/products/mcp-servers/mcp-seo-tools/dist/index.js

Claude Desktop での使用方法

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "seo-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-seo-tools/dist/index.js"]
    }
  }
}

ツールの詳細

seo_meta_analyze

URL を取得し、メタ関連のすべての要素を検査します。タイトルの長さ（最適値：30～60 文字）、メタディスクリプションの長さ（最適値：120～160 文字）、canonical URL、viewport タグ、言語属性、Open Graph の網羅性、Twitter Card の設定を確認します。0～100 のスコアを返します。

Input: { "url": "https://example.com" }

seo_heading_check

ページ上のすべての見出しを解析し、視覚的な階層ツリーを構築します。H1 の欠落、複数の H1、見出しレベルの飛び、空の見出し、長すぎる見出し（>70 文字）、重複する見出しを検出します。

Input: { "url": "https://example.com" }

seo_link_check

ページからすべてのアンカータグを抽出し、相対 URL を解決して重複を除外したうえで、各リンクに HEAD リクエストを送信します（必要に応じて GET にフォールバックします）。リンクを正常、リンク切れ、リダイレクト、タイムアウト、エラーに分類します。内部リンクと外部リンクの比率を報告します。

Input: { "url": "https://example.com", "max_links": 100 }

seo_keyword_density

スクリプト、スタイル、ナビゲーションを除去してから、残りの本文テキストをトークン化します。ストップワードを除外して、単語、バイグラム、トライグラムの出現頻度と密度を計算します。ターゲットキーワードが指定されている場合は、タイトル、H1、メタディスクリプション、最初の段落に含まれているかを確認します。

Input: { "url": "https://example.com", "target_keyword": "seo tools" }

seo_page_speed

サーバー側から見た Time to First Byte と合計ダウンロード時間を測定します。外部スクリプト、スタイルシート、画像、iframe の数を数えます。async/defer のないレンダリングブロックを引き起こすスクリプト、alt テキストや寸法が指定されていない画像、圧縮の欠落、遅延読み込みの不使用を検出します。

Input: { "url": "https://example.com" }

seo_sitemap_parse

サイトマップ URL または任意のページ URL を受け付けます（ページ URL の場合は /sitemap.xml を自動的に追加します）。robots.txt の Sitemap ディレクティブも確認します。<sitemapindex> と <urlset> の両方の形式に対応しています。URL 数の上限、lastmod の鮮度、重複エントリ、プロトコルの一貫性、末尾のスラッシュのパターンを検証します。

Input: { "url": "https://example.com" }

ライセンス

MIT