SEO Tools MCP Server

SEO ツール MCP サーバー

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

概要

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

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

特長

• DataForSEO API エンドポイントを幅広く網羅
• Local Falcon やその他のサードパーティ SEO ツールとのオプション連携
• 連携しやすい stdio トランスポート
• 認証処理
• 詳細なエラー報告
• Zod スキーマによる型安全なツール定義
• 新しい API 連携を追加できる拡張可能なアーキテクチャ

実装済みの 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 の EC データ
10. App Data API - Google Play と App Store のモバイルアプリデータ
11. Business Data API - Google My Business、Trustpilot などのビジネス掲載データ

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

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

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

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

開発

# Run in development mode with hot reloading
npm run dev

使用例

SEO ツール MCP サーバーの使用方法を示すサンプルコードについては、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 - 対象の参照ドメインを取得します

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