mcpField
D
DataForSEO MCP

DataForSEO MCP

ローカル
scalably.ioビジネス・マーケティング07 週間前に更新
リポジトリ公式サイト

DataForSEO MCP について

DataForSEO MCPは、APIリクエストとAPIドキュメント検索を必要とする人向けに、DataForSEO公式MCPサーバーをラップします。検索可能なドキュメントと、統一された応答・エラー形式を追加します。

主な機能

  1. 01APIドキュメントインデックスの閲覧
  2. 02ドキュメントセクションの一覧表示
  3. 03URLを指定したドキュメント検索
  4. 04認証付きDataForSEO APIリクエスト
  5. 05タスク状態とエラー応答の形式統一

活用シーン

  1. 01リクエスト前に関連するAPIカテゴリを特定
  2. 02ドキュメントでエンドポイントの詳細と料金を確認
  3. 03部分成功、処理中、失敗の結果を一貫した形式で確認

MCP 対応

MCPクライアントにドキュメント検索と認証付きAPIリクエストのツールを提供し、API呼び出しをDataForSEO公式サーバーに転送します。DataForSEOの認証情報が必要で、APIリクエストには料金が発生する場合があります。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "io-scalably-dataforseo": {
      "command": "npx",
      "args": [
        "-y",
        "@scalably-io/dataforseo-mcp"
      ],
      "env": {
        "DATAFORSEO_USERNAME": "<DATAFORSEO_USERNAME>",
        "DATAFORSEO_PASSWORD": "<DATAFORSEO_PASSWORD>",
        "DATAFORSEO_PROXY_TEST_CHILD": "<DATAFORSEO_PROXY_TEST_CHILD>"
      }
    }
  }
}
起動コマンドnpx -y @scalably-io/dataforseo-mcp
設定が必要な環境変数
DATAFORSEO_USERNAMEシークレットDataForSEO account login (email) from the dashboard
DATAFORSEO_PASSWORDシークレットDataForSEO account API password from the dashboard
DATAFORSEO_PROXY_TEST_CHILDTest suite only, with NODE_ENV=test: path of a fake child to spawn instead of the upstream server. Never set it in normal use

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@scalably-io/dataforseo-mcp1.0.1

ツール

4

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
sectionstringいいえAPI セクションで絞り込みます（例：“SERP API”）

詳細

DataForSEO MCP

DataForSEO の公式 MCP サーバーを薄くラップし、検索可能なドキュメントインデックスと正規化されたエラーを追加します。生の API だけが必要な場合は、dataforseo-mcp-server を直接インストールしてください。

インストール

Claude Code：

claude mcp add dataforseo -e DATAFORSEO_USERNAME=your-login -e DATAFORSEO_PASSWORD=your-password -- npx -y @scalably-io/dataforseo-mcp

Codex：

codex mcp add dataforseo --env DATAFORSEO_USERNAME=your-login --env DATAFORSEO_PASSWORD=your-password -- npx -y @scalably-io/dataforseo-mcp

Claude Desktop：このラッパーは npm のみで配布されています（上流の依存関係により、デスクトップバンドルが 100 MB を超えるためです）。代わりに、DataForSEO の独自サーバーを https://github.com/dataforseo/mcp-server-typescript からインストールしてください。利用できなくなるのはドキュメント検索ツールのみです。

セットアップ

  1. dataforseo.com で DataForSEO アカウントを作成するか、既存のアカウントを開きます。
  2. ダッシュボードから API ログイン（メールアドレス）と API パスワードを確認します。
  3. api_request は DataForSEO のライブ API を呼び出すため、DataForSEO 独自の料金に基づいて費用が発生する場合があります。3 つの docs_* ツールは無料のドキュメント検索です。

ツール（4）

ツール機能
docs_indexDataForSEO API ドキュメントのインデックス（llms.txt）を取得します。セクションで絞り込むこともできます
docs_list_sectionsDataForSEO API ドキュメントで利用可能なセクション名を返します
docs_searchドキュメント URL から DataForSEO API ドキュメントを取得します
api_requestDataForSEO API に対して認証済みリクエストを実行します（メソッド、パスまたは URL、本文、および AI 最適化されていない完全なレスポンスを取得するための任意の noAiMode フラグ）

docs_list_sections または docs_index で API の種類を選び、api_request を呼び出す前に docs_search で正確な最新のエンドポイントパス、メソッド、リクエスト本文、料金を確認してください。

設定

変数必須用途
DATAFORSEO_USERNAMEはいダッシュボードにある DataForSEO アカウントのログイン情報（メールアドレス）
DATAFORSEO_PASSWORDはいダッシュボードにある DataForSEO アカウントの API パスワード
NODE_ENV、DATAFORSEO_PROXY_TEST_CHILDいいえテストスイート専用：NODE_ENV=test の場合、ラッパーは上流サーバーの代わりに DATAFORSEO_PROXY_TEST_CHILD で指定された偽の子プロセスを起動します。通常の使用時には設定しないでください

レスポンス形式

すべてのツールは、status（succeeded、partial、no_op）、operation、summary、target、result、proof、warnings、recovery を含むプレーンな JSON を返します。失敗は、テキストが <code>: <message> <hint> 形式のツールエラーとして返されます。api_request は、DataForSEO のタスクごとのステータスコード（保留中のタスク、結果なしのタスク、一部の失敗、ベンダーのエラーコード）をそのまま検証せずに返すのではなく、この形式に正規化します。

制限事項

api_request は DataForSEO API への実際の課金対象リクエストです。DataForSEO 独自のアカウント残高とレート制限が適用されます。結果を確認できない場合、有料エンドポイントへの失敗した呼び出しは ambiguous_paid_request エラーとして報告されます。確認せずに再試行すると、二重に課金される可能性があるためです。

検証

各リリースでは、パッケージのバージョンと、その基になった本番用コミットが CHANGELOG.md に記載されます。npm への公開には、GitHub Actions による来歴情報が付与されます。CI では、すべてのプッシュ時にテストと、パッケージ化した tarball のクリーンインストールを実行します。

プライバシーポリシー

このサーバーは、お使いのマシン上で、ご自身の認証情報を使ってローカルに実行されます。個人データを収集せず、テレメトリーも含まず、データを永続的に保存せず、ラップ対象のベンダー API とのみ通信します。Scalably を含む第三者にデータが送信されることはありません。お問い合わせ先：[email protected]。正式版：https://scalably.io/connector-privacy.html

ライセンス

MIT。著作権は Scalably に帰属します。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。