開発者 / MCP

拡張機能 MCP：Codex と Claude Code に接続

Codex または Claude Code から MCP 経由でタスクを送信すると、ログイン済みのブラウザー拡張機能がデータを収集して結果を返します。収集には拡張機能の接続が必要です。

MCP を使うと、ブラウザー拡張機能で Amazon のレビュー、商品詳細、BSR ランキングを収集できます。mcp:collect 権限を持つ専用のキーが必要で、拡張機能の収集枠を使用します。まず collection_capabilities を呼び出し、必要な機能に対応しているか確認してください。

拡張機能 MCP の機能

エージェントがタスクを作成し、ログイン済みの SellerSide.ai 拡張機能がデータを収集して結果を返します。BSR は売れ筋ランキングと新着ランキングに対応し、上位 50 件または 100 件を取得できます。カテゴリーのページ URL を省略せずに指定してください。

  1. 1. ブラウザーに SellerSide.ai 拡張機能をインストールします。
  2. 2. 同じ SellerSide.ai アカウントで拡張機能にログインし、接続されていることを確認します。
  3. 3. アカウント設定で mcp:collect 権限を持つ MCP キーを作成し、Codex または Claude Code に接続します。

Codex

Codex の config.toml にサーバー設定を追加します。キーはローカルの環境変数から読み込まれます。

config.toml
[mcp_servers.sellerside]
url = "https://sellerside.ai/api/v1/developer/mcp"
bearer_token_env_var = "SELLERSIDE_MCP_KEY"

サンプルをコピーして、ご自身の環境でご利用ください。このページからリクエストは送信されません。

Claude Code

個人用またはプロジェクト用の MCP 設定に HTTP サーバーを追加します。実際のキーをコードリポジトリにコミットしないでください。

MCP の設定
{
  "mcpServers": {
    "sellerside": {
      "type": "http",
      "url": "https://sellerside.ai/api/v1/developer/mcp",
      "headers": {
        "Authorization": "Bearer ${SELLERSIDE_MCP_KEY}"
      }
    }
  }
}

サンプルをコピーして、ご自身の環境でご利用ください。このページからリクエストは送信されません。

どちらのクライアントも同じ SellerSide.ai MCP エンドポイントに接続します。収集を実行するのはログイン済みの拡張機能です。Codex や Claude Code 自体がブラウザーのデータを収集するわけではありません。

利用できるツール

  • collection_capabilities — レビュー、商品詳細、BSR ランキングの対応状況と接続状態を確認します。
  • collect_amazon_product — asin、market、idempotencyKey を指定して商品詳細を収集します。UUID 形式のタスク ID が返されます。
  • collect_amazon_bsr — categoryUrl、market、listType、limit（50 または 100）、idempotencyKey を指定してランキングを収集します。UUID 形式のタスク ID が返されます。
  • get_data_collection_result — UUID を captureId に指定し、状態、データ、欠落しているフィールドを取得します。利用枠は追加で消費しません。
  • cancel_data_collection — 未完了の商品詳細または BSR タスクをキャンセルします。消費した利用枠は一度だけ返還されます。
  • collect_amazon_reviews — asin と同一リクエストで共通の idempotencyKey を指定し、Amazon レビューの収集タスクを登録します。拡張機能の ASIN 収集枠を 1 回分使用します。
  • get_collection_status — 自分のアカウントのレビュータスクの状態を確認します。
  • get_collection_reviews — 保存済みのレビューをページ単位で取得します。
  • cancel_collection — 自分のアカウントのレビュータスクをキャンセルします。

対応プラットフォームとデータ

プラットフォームデータの種類MCP の対応状況
Amazonレビューブラウザー拡張機能で収集
Amazon商品詳細 / BSR ランキングブラウザー拡張機能で収集（対応バージョンが必要）
eBay / Walmart / MercadoLibreレビューMCP による収集には未対応

よくある質問

MCP 専用のプランは必要ですか？いいえ。現在の有料会員資格と拡張機能の収集枠を利用します。拡張機能がオフラインでも収集できますか？いいえ。接続した状態にしておく必要があります。保存済みの結果を取得すると利用枠を消費しますか？いいえ、追加の消費はありません。

商品詳細と BSR の結果は 7 日間保存されます。未完了のタスクは 5 分後にタイムアウトし、収集枠が返還されます。価格と順位は収集時点のページ情報です。フィールドが空の場合、その情報は取得できていません。評価数には本文のない評価も含まれるため、文章付きのレビュー数とは異なる場合があります。