SEO Tools MCP Server

SEO ツール MCP サーバー

SEO API に対応した包括的な stdio MCP（Model Context Protocol）サーバーです。このサーバーを使うと、LLM（大規模言語モデル）が DataForSEO API の機能やその他の SEO ツールを利用できます。

注意

バージョン 1.1.0 には、ラッパーのパスを DataForSEO の公式ドキュメントと照合して見つかった約 40 件のエンドポイントの不具合を修正する内容が含まれています。すべての修正内容については、CHANGELOG.md をご覧ください。

概要

SEO Tools MCP Server を使うと、Claude などの LLM とさまざまな SEO API をシームレスに連携でき、自然言語でのやり取りを通じて SEO 分析、キーワード調査、バックリンク分析をはじめとする多くの SEO 関連タスクを実行できます。

この実装では、DataForSEO API の主要なエンドポイントすべてを MCP ツールとして公開し、LLM が呼び出して特定の SEO データを取得できるようにしています。サーバーはトランスポート層に stdio を使用しているため、さまざまな LLM プラットフォームと簡単に連携できます。

特長

• DataForSEO API のエンドポイントを幅広くカバー（このバージョンで修正された不具合については CHANGELOG.md をご覧ください）
• Local Falcon などのサードパーティ製 SEO ツールとの連携に対応（任意）
• 連携が容易な stdio トランスポート
• 認証の処理
• 詳細なエラー報告
• Zod スキーマを使った型安全なツール定義
• 新しい API 連携を追加できる拡張可能なアーキテクチャ
• 環境変数によるモジュールとツールの選択的なフィルタリング

Data for Seo に登録する

https://dataforseo.com/?aff=200885

実装済みの API カテゴリ

DataForSEO API

1. SERP API - Google、Bing、Yahoo などの検索エンジンの検索結果データ
2. Keywords Data API - キーワード調査、候補、検索ボリュームデータ
3. DataForSEO Labs API - 高度な SEO 分析、ドメイン比較、キーワード分析
4. Backlinks API - バックリンクプロファイル、参照ドメイン、アンカーテキスト分析
5. OnPage API - ウェブサイト監査、コンテンツ分析、技術的な SEO チェック
6. Domain Analytics API - 技術スタックの検出、ドメインデータ分析
7. Content Analysis API - コンテンツの品質評価、セマンティック分析
8. Content Generation API - AI を活用したコンテンツ生成ツール
9. Merchant API - Amazon と Google Shopping の E コマースデータ
10. App Data API - Google Play と App Store のモバイルアプリデータ
11. Business Data API - Google My Business、Trustpilot などのビジネス掲載データ
12. AI Optimization API - ChatGPT、Claude、Gemini、Perplexity の LLM 応答、AI スクレイパー、AI キーワードデータ

Local Falcon API（任意）

1. グリッドポイントの計算 - ローカル検索順位分析用のグリッド座標を生成
2. GMB の場所を検索 - クエリを使って Google My Business の場所を検索
3. 座標地点の検索順位を取得 - 指定した座標におけるビジネスの検索順位を確認
4. 座標地点でキーワードを検索 - 特定の場所で検索語句をテスト
5. グリッド検索を実行 - グリッドベースのローカル検索順位分析を一括実行

インストール

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

使い方

この MCP サーバーを使用するには、利用するサービスの API 認証情報が必要です。

DataForSEO を使ってサーバーを実行する

# Set environment variables for DataForSEO authentication
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# Run the server
npm start

DataForSEO と Local Falcon を使ってサーバーを実行する

# Set environment variables for all API authentications
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# Run the server
npm start

モジュールとツールのフィルタリング

このサーバーはデフォルトで数百のツールを公開します。LLM と使用する場合、ツールの全リストによってコンテキストウィンドウを大きく消費します。環境変数を使って必要なモジュールやツールだけを有効にし、公開するツールの数を減らせます。

フィルタリングする理由

• コンテキストの使用量を削減
• LLM によるツールの検出を高速化
• より的を絞った応答

モジュールで絞り込む

ENABLED_MODULES を使用すると、特定の API カテゴリーのみを有効にできます（カンマ区切り、大文字と小文字は区別されません）。

export ENABLED_MODULES="SERP,BUSINESS_DATA,LABS"

利用可能なモジュール：

• SERP - 検索エンジンの結果
• KEYWORDS_DATA - キーワード調査
• LABS または DATAFORSEO_LABS - 高度な SEO 分析
• BACKLINKS - バックリンク分析
• ONPAGE - ウェブサイト監査
• DOMAIN_ANALYTICS - ドメインデータ
• CONTENT_ANALYSIS - コンテンツ評価
• CONTENT_GENERATION - AI コンテンツ生成
• MERCHANT - E コマースデータ
• APP_DATA - モバイルアプリデータ
• BUSINESS_DATA - ビジネスリスティング
• AI_OPTIMIZATION - LLM の応答と AI データ

個別のツールで絞り込む

ENABLED_TOOLS を使用すると、特定のツールを細かく制御できます（カンマ区切り、大文字と小文字は区別されません）。

export ENABLED_TOOLS="serp_google_maps_live,business_data_google_my_business_info"

どちらの変数も設定されていない場合、デフォルトですべてのモジュールとツールが有効になります。

モジュール単位のサブスクリプションと 404

DataForSEO のアクセス権は、多くの場合、すべてを一括で許可するのではなく、モジュールごとに付与されます。そのため、一部のエンドポイントは動作しても、ほかのエンドポイントは 404 を返すことがあります。

重要な解釈ルール：

• SERP、App Data、DataForSEO Labs App Store、Content Generation など、利用可能とされるライブエンドポイントでの 404 は、現在のアカウントでそのモジュールが有効になっていないことを意味する場合があります。
• これは必ずしも MCP サーバーのバグや、エンドポイントパスの誤りを意味するものではありません。
• ロケーションや言語などの無料の探索用エンドポイントは、同じ大きなカテゴリー内の有料ライブエンドポイントが利用できない場合でも、引き続き動作することがあります。

サーバーは、既知のモジュール範囲に関する 404 応答を、より明確なメッセージに正規化するようになりました。

• DataForSEO module not enabled: <module> ...

このメッセージが表示された場合は、DataForSEO ダッシュボードでモジュールを有効にするか、現在のアカウントですでに有効になっているモジュールのツールに切り替えてください。

Claude またはその他の LLM での使用

このサーバーは、LLM が標準化された方法で外部システムとやり取りできるようにする Model Context Protocol を実装しています。Claude で使用するには、各 LLM プラットフォーム固有の MCP 実装に従って統合する必要があります。

使用例については、examples ディレクトリをご覧ください。

開発

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

使用例

SEO Tools MCP Server の使い方を示すサンプルコードについては、examples ディレクトリをご覧ください。

基本的な例では、次の方法を説明しています。

• サーバーの起動
• クライアントからの接続
• さまざまな API エンドポイントへの呼び出し
• 結果の処理

利用可能なツール

このサーバーは、統合されたすべての API カテゴリーにわたり、数百のツールを提供します。以下に、よく使われるツールの例を示します。

DataForSEO SERP API ツール

• serp_google_organic_live - Google のオーガニック検索結果を取得
• serp_google_organic_task_post - Google のオーガニック検索タスクを作成
• serp_google_maps_live - Google Maps の検索結果を取得

DataForSEO Keywords Data ツール

• keywords_google_ads_search_volume - キーワードの検索ボリュームを取得
• keywords_google_ads_keywords_for_site - ドメインのキーワード候補を取得
• keywords_google_trends_explore - キーワードの経時的なトレンドを調査

DataForSEO Labs ツール

• labs_google_keyword_ideas - シードキーワードを基にキーワード候補を取得
• labs_google_related_keywords - 関連キーワードを取得
• labs_google_domain_rank_overview - ドメインのランキング概要を取得

DataForSEO Backlinks ツール

• backlinks_summary - ドメインのバックリンクプロファイルの概要を取得
• backlinks_backlinks - ドメインのバックリンク一覧を取得
• backlinks_referring_domains - 対象の参照ドメインを取得
• backlinks_history - 対象の過去のバックリンクデータを取得
• backlinks_timeseries_summary - バックリンクの時系列データを取得
• backlinks_bulk_new_lost_backlinks - 複数の対象について、新規および失われたバックリンクを取得
• backlinks_bulk_new_lost_referring_domains - 複数の対象について、新規および失われた参照ドメインを取得
• backlinks_bulk_pages_summary - 複数の対象について、ページの概要を取得

DataForSEO AI 最適化ツール

• ai_chatgpt_models - 利用可能な ChatGPT モデルの一覧を取得します
• ai_chatgpt_llm_responses_live - ChatGPT からライブ応答を取得します
• ai_chatgpt_scraper_locations - ChatGPT スクレイパーで利用可能な地域を取得します
• ai_chatgpt_scraper_languages - ChatGPT スクレイパーで利用可能な言語を取得します
• ai_claude_models - 利用可能な Claude モデルの一覧を取得します
• ai_claude_llm_responses_live - Claude からライブ応答を取得します
• ai_gemini_models - 利用可能な Gemini モデルの一覧を取得します
• ai_gemini_llm_responses_live - Gemini からライブ応答を取得します
• ai_perplexity_models - 利用可能な Perplexity モデルの一覧を取得します
• ai_perplexity_llm_responses_live - Perplexity からライブ応答を取得します
• ai_keyword_data_search_volume_live - AI キーワードの検索ボリュームデータを取得します
• ai_keyword_data_locations_and_languages - AI キーワードデータで利用可能な地域と言語を取得します

Local Falcon ツール（設定されている場合）

• localfalcon_calculate_grid_points - 基準座標の周囲にグリッドポイントを計算します
• localfalcon_search_gmb_locations - Google マイビジネスの場所を検索します
• localfalcon_get_ranking_at_coordinate - 指定した座標でのビジネスランキングを取得します
• localfalcon_keyword_search_at_coordinate - 指定した場所でキーワードを検索します
• localfalcon_run_grid_search - ローカルランキングのグリッド検索を実行します

ツールの全一覧

利用可能なすべてのツールとそのパラメーターの完全な一覧は、src/api ディレクトリにある実装を確認してください。

サーバーの拡張

このサーバーは拡張できるように設計されています。追加の SEO API に対応するには、次の手順を実行します。

1. src/api/ に連携用の新しいディレクトリを作成します
2. クライアントの処理とツールの登録を実装します
3. src/index.ts に連携機能を追加します
4. 認証用の環境変数処理を追加します

テンプレートとして、src/api/localfalcon/ の Local Falcon 連携を参照してください。

セキュリティ

• 認証情報（DATAFORSEO_LOGIN、DATAFORSEO_PASSWORD、LOCALFALCON_API_KEY）は環境変数からのみ読み込まれます。これらをコミットしないでください。
• .env.example を .env にコピーし、独自の認証情報を入力してください。
• .gitignore は .env、.env.*.local、その他の機密情報を保存するパスを除外します。
• コントリビューションを行う前に、npm audit を実行し、重大または深刻な脆弱性を修正してください。

ライセンス

MIT