SEO Tools MCPサーバー

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

概要

SEO Tools MCPサーバーは、ClaudeのようなLLMと様々なSEO APIとのシームレスな統合を実現します。これにより、SEO分析、キーワード調査、バックリンク分析、その他多くのSEO関連タスクを、自然言語での対話を通じて直接実行できるようになります。

この実装では、主要なDataForSEO APIエンドポイントのすべてをMCPツールとして公開しており、LLMはこれらを呼び出して特定のSEOデータを取得できます。サーバーはトランスポート層としてstdioを使用するため、様々なLLMプラットフォームとの統合が容易です。

Related MCP server: DataForSEO MCP Server

特徴

• DataForSEO APIエンドポイントの包括的なカバー

• 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ショッピングのEコマースデータ

10. App Data API - Google PlayおよびApp Storeのモバイルアプリデータ

11. Business Data API - Googleマイビジネス、Trustpilotなどのビジネスリスティングデータ

12. AI Optimization API - ChatGPT、Claude、Gemini、PerplexityによるLLM応答、AIスクレイパー、AIキーワードデータ

Local Falcon API (オプション)

1. Calculate Grid Points - ローカルランキング分析用のグリッド座標を生成

2. Search GMB Locations - クエリでGoogleマイビジネスの場所を検索

3. Get Ranking at Coordinate - 特定の座標でのビジネスランキングを確認

4. Keyword Search at Coordinate - 特定の場所で検索語句をテスト

5. Run Grid Search - グリッドベースの完全なローカルランキング分析を実行

インストール

# 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での使用

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

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

開発

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

例

SEO Tools MCPサーバーの使用方法を示すサンプルコードについては、examplesディレクトリを確認してください。

基本的な例では以下を示しています：

• サーバーの起動

• クライアントからの接続

• 異なるAPIエンドポイントへの呼び出し

• 結果の処理

利用可能なツール

サーバーは、統合されたすべてのAPIカテゴリにわたって数百のツールを公開しています。以下は、最も一般的に使用されるツールの例です：

DataForSEO SERP APIツール

• serp_google_organic_live - Googleオーガニック検索結果を取得

• serp_google_organic_task_post - Googleオーガニック検索タスクを作成

• serp_google_maps_live - Googleマップ検索結果を取得

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 Optimizationツール

• 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統合を参照してください。

ライセンス

MIT