DataDive

@datadive-tools/mcp

Claude（またはMCP互換クライアント）が、既存のAPIキーを使ってDataDiveのニッチ、キーワード、競合他社、Rank Radarのデータを照会できるMCPサーバーです。

お使いのマシン上でstdio経由でローカル実行されます。APIキーがマシンの外部に送信されるのは、api.datadive.toolsへのリクエストのx-api-keyヘッダーとして使用される場合のみです。

質問できること

• 「マーケットプレイスcomにあるDataDiveのニッチを一覧表示して。」
• 「ニッチz515cGOFg3のマスターキーワードリストは？」
• 「ニッチXの上位の競合他社と、その売上を教えて。」
• 「ニッチXのランキングジュースは？改善できる箇所を教えて。」
• 「Rank Radarを表示して。」
• 「Rank Radar Yのオーガニックランキングの推移を、2024-03-01から2024-04-01までプロットして。」
• 「米国のマーケットプレイスで、競合他社を5件指定して、ASIN B08N5WRWNWのニッチ調査を実行して。」
• 「今日のデータでニッチXを更新して。競合他社は同じにして。」
• 「ニッチXを競合他社12件で再調査して。ただしB08N5WRWNWは対象に残して。」
• 「調査はもう終わった？」
• 「ニッチXで、ASIN B08N5WRWNWのキーワード10個のRank Radarトラッキングを開始して。」
• 「接続されているAmazonの販売者アカウントはどれ？」
• 「米国のカタログから、有効な「widget」製品を検索して。」
• 「先週、出品情報に価格やコンテンツの変更はあった？」

1. DataDive APIキーを取得する

1. https://2.datadive.toolsにサインインします。
2. Settings → API Key（/api-key）に移動します。
3. Generate API Keyをクリックします。値をコピーしてください。後ほど、以下のMCPクライアント設定に貼り付けます。

Billing ManagerまたはOwnerのロールと、Standardプラン以上が必要です。このページが表示されない場合は、組織の管理者にお問い合わせください。

2. MCPクライアントに追加する

Claude Desktop

設定ファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

mcpServersの下にdatadiveエントリを追加します。

{
  "mcpServers": {
    "datadive": {
      "command": "npx",
      "args": ["-y", "@datadive-tools/mcp"],
      "env": {
        "DATADIVE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktopを再起動します。ツールメニューにdatadiveが表示されます。

Claude Code

claude mcp add datadive -- npx -y @datadive-tools/mcp
# Then add the env var via:
#   claude mcp add datadive --env DATADIVE_API_KEY=YOUR_API_KEY -- npx -y @datadive-tools/mcp

または、プロジェクト内の.mcp.json、もしくはグローバル設定の~/.claude/mcp.jsonを、上記と同じJSON形式で編集します。

Cursor

Settings → MCP → Add new MCP serverを選択し、同じJSON形式を貼り付けます。

{
  "datadive": {
    "command": "npx",
    "args": ["-y", "@datadive-tools/mcp"],
    "env": { "DATADIVE_API_KEY": "YOUR_API_KEY" }
  }
}

3. 確認する

Claudeに**「DataDiveのニッチを一覧表示して。」**と尋ねます。

list_nichesのツール呼び出しと、ニッチおよびページネーションのメタデータを含むJSONレスポンスが表示されます。表示されない場合は、以下の「トラブルシューティング」をご覧ください。

利用可能なツール

ツール	説明
list_niches	ニッチのページ分割リストです。検出ステップとして、以下のニッチスコープのツールで使う nicheIds を返します。
list_niches	ニッチのページ分割リストです。検出ステップとして、以下のニッチスコープのツールで使う nicheIds を返します。searchText、searchAsin、spaces、labels で絞り込めます。各ニッチには、その spaces と labels の ID が一覧表示されます。
list_spaces	ツリー形式で表示する Spaces（id、name、path、children）です。接続済みのメンバーには、権限のある Spaces のみが表示されます。ID は add_niche_spaces と spaces フィルターで使用します。
list_labels	ツリー形式で表示するラベルです。ID は add_niche_labels と labels フィルターで使用します。
list_fast_keywords	組織の Fast Keywords 実行履歴のページ分割リストです（fastKeywordsId、ASIN、ステータス、キーワード数、検索ボリューム）。search または marketplace で絞り込めます。
get_fast_keywords	Fast Keywords の結果を1件返します。商品、キーワードのルート、上位10件の競合が含まれます。status が success になるまでポーリングします。
get_fast_keywords_keywords	完了した Fast Keywords 実行のキーワードを返します。検索ボリューム、オーガニック順位、スポンサープロダクトの順位を含み、検索ボリュームの高い順に表示されます。ページ分割に対応（最大100件）しています。
run_fast_keywords	ダイブトークンを1つ消費します。 ASINだけから商品のキーワードを見つけます。非同期処理です。get_fast_keywords でポーリングします。事前に費用を確認し、confirm: true が必要です。
refresh_fast_keywords	ダイブトークンを1つ消費します。 Fast Keywords の結果を再実行します。24時間に1回まで実行できます。confirm: true が必要です。
get_niche_keywords	ニッチのマスターキーワードリストです。検索ボリューム、関連度、競合 ASIN の順位が含まれます。
get_niche_roots	ニッチのキーワード語根です。頻度と広範な検索ボリュームを含む、影響力の大きい単語を返します。
get_niche_competitors	競合 ASIN、タイトル、BSR、カテゴリー、ニッチの統計情報（売上、収益、評価、機会スコア）を返します。
get_ranking_juice	競合ごとの DataDive 独自のランキングジュース指標（現在のリスティングと最適化済みリスティング）を返します。
list_rank_radars	ランクレーダーのページ分割リストです。nicheId、searchText、spaces、labels（ニッチ経由で照合）、または status（デフォルトは ACTIVE。PAUSED、ARCHIVED、ALL も指定可能）で絞り込めます。
get_rank_radar_data	startDate／endDate の範囲内における、ランクレーダーの過去のキーワード順位を返します（最大90日）。デフォルトでは有効なキーワードをすべて返します。currentPage／pageSize（最大100件）を指定すると、一度に1ページずつ取得できます。
get_rank_radar_sqp_data	ランクレーダーの各キーワードについて、Amazon Search Query Performance を返します。検索ボリューム、インプレッション、クリック、カートへの追加、購入数を含み、市場全体とこの ASIN ファミリーを比較できます。日付範囲とページ分割は get_rank_radar_data と同じです。
get_rank_radar_ppc_data	ランクレーダーの各キーワードについて、スポンサープロダクトの指標を返します。スポンサープロダクトの順位、費用、売上、ACOS、CPC、マッチタイプを含み、キャンペーンごとの内訳も任意で取得できます。日付範囲とページ分割は get_rank_radar_data と同じです。
create_niche_dive	ダイブトークンを消費します。 シード ASIN から新しいニッチ調査を開始します。非同期処理です。get_dive_status でポーリングするための diveId を返します。Fast Keywords 実行に関連付けるには、fastKeywordsRequestId（run_fast_keywords の結果）を渡します。confirm: true が必要です。
create_niche_dive_from_competitors_list	ダイブトークンを消費します。 自動検出を行わず、独自の競合 ASIN リスト（2～200件）からニッチ調査を開始します。非同期処理です。get_dive_status でポーリングするための diveId を返します。confirm: true が必要です。
redive_niche	ダイブトークンを消費します。 既存のニッチを最新データで更新します。同じ競合を使用するか、新たに競合を検出できます。非同期処理です。get_dive_status でポーリングするための diveId を返します。confirm: true が必要です。
add_niche_keywords	ニッチのマスターキーワードリストにキーワードを追加します（1回あたり1～100件）。過去24時間以内にダイブしたニッチでは無料です。それより古いニッチでは、ニッチを再ダイブしてダイブトークンを消費するため、最初に confirm: true の確認を求めます。
remove_niche_keywords	ニッチのマスターキーワードリストからキーワードを取り除きます。手動で追加したキーワードは削除され、Outliers／Residue 由来のキーワードは元の場所に戻り、ダイブで見つかったキーワードはそのまま残ります。無料です。
list_keyword_exclusions	ニッチのマスターキーワードリストから非表示にしたキーワードです。完全一致の項目には検索ボリューム、フレーズの項目には非表示にしたキーワード数と検索ボリュームが表示されます。
add_keyword_exclusions	ニッチのマスターキーワードリストからキーワードを非表示にします。exact（キーワード1件）または phrase（その語句を含むすべてのキーワード）を指定でき、1回あたり1～100件です。無料です。remove_keyword_exclusions で取り消せます。
remove_keyword_exclusions	完全一致またはフレーズの除外設定を削除し、非表示にしていたキーワードを再表示します。無料です。
add_niche_spaces / remove_niche_spaces	ニッチを1～100件の Spaces に追加、または Spaces から削除します（list_spaces から取得した spaceIds）。無料で、confirm は不要です。組織のオーナーまたはチーム管理者のみ実行できます。閲覧権限しかない Space は拒否されます。不明な ID または拒否された ID が1つでもあると呼び出し全体が失敗し、変更は行われません。
add_niche_labels / remove_niche_labels	ラベルについても同様に操作します（list_labels から取得した labelIds）。組織のオーナーまたはチーム管理者のみ実行できます。
get_dive_status	create_niche_dive または redive_niche で開始したダイブのステータスをポーリングします。結果は in_progress、success（nicheId を含む）、または error です。
create_rank_radar	Search Term トークンを消費します。 ニッチ内の ASIN のキーワード順位の追跡を開始します。rankRadarId を返します。confirm: true が必要です。
add_rank_radar_search_terms	既存のランクレーダーにキーワードの追跡を追加します。新しいキーワードごとに Daily Tracked Keywords の枠を1つ使用します。pause_rank_radar_search_terms で取り消せます。
pause_rank_radar_search_terms	ランクレーダーの個別キーワードを一時停止し、履歴を保持したまま追跡枠を解放します。get_rank_radar_data から取得したキーワード ID を指定します。
resume_rank_radar_search_terms	ランクレーダーで一時停止したキーワードの追跡を再開します。キーワードごとに追跡枠を1つ再び使用します。
pause_rank_radar	ランクレーダー全体を一時停止します（API ではアーカイブと呼ばれますが、ARCHIVED ではなく status: PAUSED の下に一覧表示されます）。追跡は停止し、履歴は保持され、追跡枠が解放されます。resume_rank_radar で再開できます。
resume_rank_radar	一時停止中のランクレーダーを再開し、残りの上限に応じてできるだけ多くのキーワードを復元します（関連度の高い順）。
delete_rank_radar	順位の履歴を完全に削除します。 ランクレーダーを完全に削除し（status: ARCHIVED の下に一覧表示されます）、追跡枠を解放します。confirm: true が必要です。後でデータが必要になる可能性がある場合は、pause_rank_radar を優先してください。
delete_niche	ニッチデータを完全に削除します。 キーワード、競合、ダイブ履歴とともにニッチを削除します。消費済みのダイブトークンは返却されません。ランクレーダーが使用中のニッチは削除できません。confirm: true が必要です。
generate_listing_copy	AI Copywriter のプロンプトを1つ消費します。 ニッチのキーワード調査から、最適化されたタイトル、箇条書き、説明文の下書きを作成します。Amazon には公開されません。非同期処理です。generationId を返します。confirm: true が必要です。
get_listing_copy_generation_status	generate_listing_copy で開始した下書きのステータスをポーリングします。結果は generating、complete（生成されたコピーを含む）、または failed です。ポーリングは無料です。
list_seller_profiles	接続済みの Amazon セラーアカウントのページ分割リストです。検出ステップとして、以下のセラースコープのツール（およびアラートツール）で必要な sellerId と marketplace を返します。
get_seller_catalog	セラー自身の ASIN カタログをページ分割して返します。search、brand、status（デフォルトは Active）で絞り込めます。
get_seller_listing_changes	セラーのリスティングにおける価格、コンテンツ、画像の変更をページ分割して返します。types、asin、brand、search、日付範囲で絞り込めます。ランキング／コンバージョンとの correlation も任意で含められます。
list_ppc_campaigns	セラーアカウントのスポンサープロダクトキャンペーンを、期間合計と掲載枠ごとの内訳とともに返します。asin／parentAsin、state、search で絞り込めます。任意の指標で並べ替えられます。期間は最大90日（デフォルトは30日）です。
get_asin_inventory_distribution	ASIN の在庫指標（在庫数、在庫日数、在庫不足の状態、LILF および LTSF 手数料、長期保管在庫数）と、フルフィルメントセンターごとの販売可能在庫を返します。list_seller_profiles または Connections ページから取得した sellerId が必要です。
list_indexing_issue_alerts	インデックス登録の問題に関するアラートのページ分割リストです。追跡対象キーワードでインデックスされなくなった ASIN が対象です。sellerId、marketplace、status、updatedSince で絞り込めます。
list_blind_spend_alerts	無駄な広告費に関するアラートのページ分割リストです。売上がほとんどない、またはまったくない検索語句への広告費について、語句ごとの費用、クリック数、CVR を含みます。上記と同じフィルターを使用できます。
get_quota	課金対象の機能ごとの現在の使用量と上限、および次回の更新日を返します。引数は不要です。
list_usage	課金対象の使用履歴（トークン消費イベント）をページ分割して返します。type、search（ユーザー）、startDate／endDate で絞り込めます。
すべてのデータは、API キーを所有する組織の範囲内に限定されます。ほとんどのツールは読み取り専用です。変更を加えるツールには上記のマークが付いています。取り消せないツールには、明示的な confirm: true も必要です。詳しくは、変更を加えるツールをご覧ください。

変更を加えるツール

6 つのツールは取り消せないため、明示的な confirm: true 引数が必要です。これを指定せずに呼び出すと、何も変更せず、まず費用について確認するようアシスタントに求めるメモを返します。

• create_niche_dive、redive_niche — ダイブトークンを消費します（numberOfCompetitors に応じて増加します）。
• create_rank_radar — Search Term トークンを消費します（numberOfKeywords に応じて増加します）。
• generate_listing_copy — 呼び出しごとに AI Copywriter プロンプトを 1 つ消費します。
• delete_niche、delete_rank_radar — データを完全に削除します。

get_quota を使えば、いつでも残高を確認できます。

create_rank_radar は、最初の未確認の呼び出しで API に対して作成内容をプレビューします。そのため、返されるメモにはトークン費用だけでなく、具体的な情報が含まれることがあります。たとえば、指定した商品ファミリーが別の Rank Radar ですでに追跡されており、Tracked Search Terms を二重に消費することになる、といった内容です。プレビューでは何も作成されず、費用も発生しません。また、警告によって作成が阻止されることはありません。1 つの商品ファミリーに 2 つの Rank Radar を設定するのは、2 種類の検索語セットを追跡し、統計を分けて管理するための方法です。

その他の書き込みツールである pause_rank_radar、resume_rank_radar、および 3 つの *_rank_radar_search_terms ツールには、確認は不要です。これらは Daily Tracked Keywords の容量を移動するだけで、いったん一時停止すれば容量は再び解放されます。また、それぞれ対応するツールで元に戻せます。

add_niche_keywords で confirm: true が必要になるのは、費用が発生する場合だけです。過去 24 時間以内にダイブしたニッチでは、最初の呼び出しでキーワードを無料で追加できます。一方、古いニッチでは、その呼び出しでは何も変更されず、追加によって発生する再ダイブの Dive トークン費用が返されます。remove_niche_keywords とキーワード除外ツールは無料で、確認も不要です。

呼び出しごとの確認を省略するには（自動化されたセットアップなど）、クライアント設定で DATADIVE_AUTO_CONFIRM_WRITES=true を設定します。これにより、削除も含めて 6 つのツールすべてが confirm なしで実行されます。

この 3 つのツールはいずれも安全に再試行できません。同じ引数であっても、呼び出すたびにトークンを再度消費し、別個のダイブ／再ダイブ／Rank Radar を作成します。呼び出しでエラーが発生したりタイムアウトしたりした場合は、再度呼び出す前に get_dive_status／list_niches／list_rank_radars で、すでに存在するものを確認してください。

ダイブは非同期です。create_niche_dive は diveId と完了予定時刻をすぐに返します。その diveId を使って get_dive_status をポーリングし、success が報告されるまで確認してください。success には新しい nicheId が含まれており、その後 list_niches、get_niche_keywords、その他のニッチツールに渡します。

redive_niche は別のニッチを作成するのではなく、すでにあるニッチを更新し、同じ nicheId を維持します。そのため、そのニッチを基に作成された Rank Radar やレポートには、更新後のデータが反映されます。mode を指定します。

• same_competitors — ニッチの現在の競合セットを再ダイブします。他に指定するものはありません。最新の販売数、価格、キーワードデータを取得する用途にのみ使用します。
• discover — 新しい競合セットを検索し、numberOfCompetitors 件の ASIN を取得します。heroAsin（基準となる ASIN。デフォルトでは、ニッチ内で最も売れている競合他社の ASIN が選ばれ、自社の ASIN が優先されます）、lockedAsins（検出結果にかかわらず保持する ASIN）、excludedAsins（選択対象から除外する ASIN）で調整します。

⚠️ create_niche_dive では、marketplace に Amazon ドメインの完全なサフィックス（com、co.uk、com.mx、co.jp、…）を使用します。たとえば、英国のマーケットプレイスは uk ではなく co.uk です。

設定

環境変数	必須	デフォルト	備考
DATADIVE_API_KEY	はい	—	https://2.datadive.tools/api-key で生成します
DATADIVE_API_BASE_URL	いいえ	https://api.datadive.tools	ステージング環境で使用する場合に上書きします
DATADIVE_AUTO_CONFIRM_WRITES	いいえ	false	truthy な値を設定すると、confirm: true が指定されたすべてのツールを確認なしで実行します。対象はダイブ、Rank Radar の作成、リスティングのコピー、2 件の削除です。

トラブルシューティング

ツール呼び出しでエラーメッセージが返された場合、以下のいずれかです。それぞれ DataDive API の特定の HTTP ステータスに対応しています。

メッセージの冒頭	対処方法
Authentication failed: your DATADIVE_API_KEY is invalid or expired	キーが間違っているか、削除されているか、有効期限が切れています。https://2.datadive.tools/api-key で新しいキーを生成してください。
Subscription is inactive or paused	https://2.datadive.tools で請求を再開してください。API キーは有効ですが、サブスクリプションが有効ではありません。
Quota exceeded / … quota exceeded	サブスクリプションで、その課金対象機能（ダイブトークン、Rank Radar の追跡キーワード、AI Copywriter のプロンプトなど）のクォータを使い切っています。メッセージには機能名、使用状況、該当する場合は次回の更新日が記載され、引き上げを申請できるサブスクリプション概要ページへのリンクも含まれます。クォータが更新されるまで再試行しないでください。
Forbidden	キーは有効ですが、そのリソースへのアクセス権がありません。通常は、別の組織に属するニッチまたは Rank Radar が原因です。
Rate limit exceeded	数秒待ってから再試行してください。
Bad request	パラメーターを確認してください。メッセージにはサーバーによる検証エラーが記載されています（例：pageSize must not exceed 50）。
DataDive API error (5xx)	一時的なバックエンドの問題です。再試行してください。問題が続く場合は、サポートにお問い合わせください。
Network error reaching …	お使いのマシンから api.datadive.tools に接続できません。VPN、ファイアウォール、DNS を確認してください。

サーバー自体が起動しない場合は、MCP クライアントのログ出力を確認してください。

• DATADIVE_API_KEY environment variable is required — 環境変数がバイナリに渡されていません。クライアント設定の env（args ではなく）に設定されていることと、編集後にクライアントを再起動したことを確認してください。

プライバシー

• MCP サーバーはお使いのマシン上でローカルに実行されます。薄い中継層であり、すべてのツール呼び出しは、お使いのマシンから x-api-key ヘッダーに API キーを含めて api.datadive.tools に送信する単一の HTTPS リクエストになります。
• API キーは、お使いの MCP クライアントの設定ファイル（お客様が管理します）にのみ保存されます。それ以外の場所に送信されることはありません。
• サーバーが独自にログを記録することはありません。DataDive の標準バックエンドアクセスログには、直接 API を呼び出した場合と同様に、リクエストごとのメタデータ（組織、ルート、ステータス、遅延時間）が記録されます。

開発

npm install
npm run build       # tsup -> dist/index.js (with shebang)
npm test            # vitest run
npm run typecheck   # tsc --noEmit
npm run lint        # eslint

MCP Inspector を使って、バイナリをエンドツーエンドでテストします。

DATADIVE_API_KEY=YOUR_API_KEY npx @modelcontextprotocol/inspector dist/index.js

リリース

このリポジトリでは Changesets を使用しています。

npx changeset             # add a changeset describing the change (patch/minor/major)
git commit -am "fix: ..."
git push

「Version Packages」PR が自動的に作成されます。これをマージすると、バージョンが更新され、CHANGELOG.md が更新され、provenance 付きで npm に公開されます。

サポート

• 問題の報告： https://github.com/Data-Dive-Tools/datadive-mcp/issues
• API ドキュメント： https://developer.datadive.tools/docs#/v1
• DataDive サポート： [email protected]

ライセンス

MIT — LICENSE を参照してください。