Nova Data Analytics

Nova Amazon Seller MCP

Model Context Protocol を通じて、Amazon Seller Central と Amazon Ads のデータを Claude、ChatGPT、Gemini、または Cursor に接続し、自然な言葉で質問できます。

Which SKUs lost the most net profit versus last month, and why?
Which keywords burned more than $100 with zero sales?
What runs out of stock in the next three weeks across all marketplaces?

このリポジトリは、ホスト型 MCP サーバーである Nova MCP のセットアップキット兼リファレンスです。そのまま貼り付けて使えるクライアント設定、ドキュメント化されたツールリファレンス、プロンプトライブラリの例が含まれています。サーバー自体は Nova が運営する商用サービスです。このリポジトリにサーバーのコードは含まれていません。

---

概要

エンドポイント	https://mcp.novadata.io/api/mcp
トランスポート	リモート、ストリーミング可能な HTTP
認証	OAuth。販売者アカウントごとに Nova で発行
現在のアクセス範囲	Amazon のデータを読み取ります。書き込みは独自の Nova コスト設定（COGS、FBM、VAT）のみです
開発中	利益の全体像を踏まえたキャンペーンおよび出品情報の操作
マーケットプレイス	Amazon の 23 のマーケットプレイス
データ更新頻度	1 時間ごとに同期
料金	商用サービス。Nova のプランは月額 $29 から。14 日間の無料トライアルがあり、カードは不要です

生の SP-API ではなくデータレイヤーを使う理由

Amazon の Selling Partner API と Advertising API は、多数のエンドポイントに分割された生のレポートを返しますが、レポート間の照合は行われません。これらの API に接続したアシスタントは、コンテキストの大半をページネーションとデータの結合に費やします。

代わりに、Nova MCP は事前にモデル化されたレイヤーを提供します。注文、決済、40 種類以上の Amazon 手数料を SKU 単位で照合したデータ、顧客の検索語句まで含む Sponsored Products、在庫日数付きの FBA および AWD 在庫、出品情報の健全性とカートボックスの状態、自社 ASIN の Best Seller Rank を利用できます。フィルタリングとランキングはサーバー側で実行されるため、販売者からの質問への回答は通常、ページネーションを繰り返すのではなく、1 回のツール呼び出しで済みます。

セットアップ

Seller Central と Amazon Ads を接続した Nova アカウントと、完了済みの 1 時間ごとの同期が少なくとも 1 回必要です。アカウントをお持ちでない場合は、novadata.io でトライアルを開始してください。

• Claude Desktop と Claude web
• Claude Code
• ChatGPT
• Cursor

サーバー URL はどのクライアントでも同じです。各クライアントのコネクター設定で URL を追加してください。

ツールリファレンス

詳しくは docs/tools.md をご覧ください。

ツール	返されるデータ
query_metrics	期間を問わず、SKU、ASIN、マーケットプレイス、アカウント、または時間単位でグループ化した任意の指標
find_movers	基準期間と比較した、指標の増加幅および減少幅が最も大きい項目
explain_movement	1 つの SKU の変動に関する要因シグナル：トラフィック、コンバージョン、価格、カートボックス、広告、ランキング
query_advertising	キャンペーン、広告グループ、ターゲティング、キーワード、ASIN、または SKU 単位の Sponsored Products
query_search_terms	除外キーワードの設定や新たなキーワードの発見に使える、広告費につながった顧客の検索クエリ
query_inventory	FBA および AWD 在庫の健全性、販売速度、在庫日数、在庫切れのリスク
query_listing_health	抑制、削除、購入不可、カートボックス喪失、ハイジャック、カタログコンテンツ
query_bsr	自社 ASIN の Best Seller Rank。最新値または時系列
query_sqp	検索クエリのパフォーマンス：クエリごとのインプレッション、クリック数、購入シェア
list_cost_inputs	設定済みの SKU ごとの COGS、FBM コスト、VAT カテゴリー。セットアップの監査に使用
import_cogs / import_fbm_costs / import_vat_categories	アシスタントから離れずに、会話形式でコスト入力を管理
list_metrics / describe_metric	指標のカタログと定義
list_accounts / list_tags	販売者アカウントとカスタム商品フィルター

プロンプトの例

職種別に整理された、より充実したライブラリはプロンプトにあります。

利益

• PPC 控除後の過去 30 日間の SKU 別利益を表示してください。
• 先月と比べて純利益が最も減少した SKU と、その理由を教えてください。
• 今四半期の ASIN 別の実質 TACoS はいくらですか？

広告

• 先週、注文が 0 件なのに 100 ドルを超えて消化したキャンペーンはどれですか？
• ACoS が 25% 未満で、注文が 3 件以上ある検索語句を見つけてください。
• ACoS は良好なのに、貢献利益がマイナスのキーワードはどれですか？

在庫

• すべてのマーケットプレイスで、今後 3 週間以内に在庫切れになる商品はどれですか？
• 在庫日数が 120 日を超えている SKU はどれですか？

出品情報

• 現在、出品停止中またはカートボックスを失っている商品はどれですか？

比較

何が必要かによって選択肢は変わります。率直に比較します。

	Nova MCP	Amazon Ads MCP	Raw SP-API
広告データ	はい。検索語句レベルまで対応	はい。公式	Ads API 経由
検索クエリのパフォーマンス	はい	いいえ	一部対応。別個のレポートが必要
セラーセントラルの財務データ	はい。SKU 別に照合済み	いいえ	未加工のレポート。未照合
COGS と仕入原価	はい。MCP 自体で管理	いいえ	いいえ
手数料と広告費控除後の実質利益	はい	いいえ	自分で構築
出品情報の健全性とカートボックス	はい	いいえ	個別の API
キャンペーンと出品情報の操作	開発中	はい	はい
利益を踏まえた操作	開発中	いいえ	いいえ

重要なのは最後の行です。Amazon 公式の Ads MCP Server ではキャンペーンを変更できます。無料で公式ですが、仕入原価を把握していないため、利益が出る ACoS と利益が出ない ACoS を見分けられません。操作できない利益分析ツールでは、手作業が必要になります。Nova は、SKU の実際の収益を把握したうえで入札額を変更できるよう、この 2 つを組み合わせた機能を開発しています。

こうした操作機能が提供されるまでは、Nova MCP は Amazon のデータを読み取り、コスト情報を管理します。今すぐキャンペーンの書き込み操作が必要な場合は、Amazon の Ads MCP Server と併用してください。

セキュリティと権限

• Nova に対する OAuth を使用します。Amazon のパスワードが MCP と共有されることはありません。
• 認証情報はセラーアカウントごとに設定され、いつでも Nova から取り消せます。
• 現時点で、このサーバーは Amazon 上の情報を変更できません。出品情報、キャンペーン、在庫、価格のいずれも変更できません。
• 現時点で利用できる書き込みツールが更新するのは、Nova 内の独自のコスト設定（COGS、FBM 料金、VAT カテゴリ）のみです。
• 開発中の操作ツールは、オプトイン方式とし、読み取り権限とは別に範囲を設定でき、個別に取り消せるようにする予定です。

このサーバーを含め、Amazon MCP サーバーを評価する際に確認すべき点は共通しています。認証情報の共有ではなく Amazon OAuth を使っているか、読み取り権限と書き込み権限が別々に設定されているか、変更を適用する前に人が承認できるか、アシスタントが変更した内容の監査証跡があるかを確認してください。

リンク

• 製品：novadata.io/amazon-mcp-for-sellers
• セットアップガイド：novadata.io/amazon-ai-agents/connect-claude
• データのカバー範囲：novadata.io/amazon-data-library
• プロンプトライブラリ：novadata.io/amazon-mcp-prompts

コントリビューション

設定ファイル、ドキュメント、プロンプトライブラリに関する Issue やプルリクエストを歓迎します。ホスト型サービスに関するお問い合わせは、サイトから Nova までご連絡ください。

ライセンス

このリポジトリの内容は MIT ライセンスです。LICENSEを参照してください。Nova MCP サービス自体は商用です。