开发者 / MCP

插件 MCP：连接 Codex 与 Claude Code

让 Codex 或 Claude Code 通过 MCP 向 SellerSide.ai 下发采集任务，由你已登录的浏览器插件领取、采集并回传。插件离线时无法采集。

通过 MCP 调用浏览器插件，采集 Amazon 评论、商品详情和 BSR 榜单。MCP 使用独立密钥，需要 mcp:collect 权限，并消耗插件采集额度。请先调用 collection_capabilities，确认插件支持所需功能。

插件 MCP 能力

Agent 创建任务后，由已登录的 SellerSide.ai 插件采集数据并返回结果。BSR 支持畅销榜和新品榜，可获取前 50 或 100 名商品，需提供完整的类目页面链接。

  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 评论采集任务，消耗 1 次插件 ASIN 采集额度。
  • get_collection_status — 查询自己账号下的评论任务状态。
  • get_collection_reviews — 分页读取已保存的评论。
  • cancel_collection — 取消自己账号下的评论任务。

支持的平台与数据

平台数据类型MCP 支持情况
Amazon评论通过浏览器插件采集
Amazon商品详情 / BSR 榜单通过浏览器插件采集，需使用支持此功能的版本
eBay / Walmart / MercadoLibre评论暂不支持通过 MCP 采集

常见问题

需要单独购买 MCP 套餐吗？不需要，沿用现有付费会员及插件采集额度。插件离线时能采集吗？不能，需要保持插件连接。读取已保存的结果会再次扣额吗？不会。

商品详情和 BSR 结果保留 7 天。未完成的任务在 5 分钟后超时，并返还采集额度。价格和排名以采集时的页面为准；字段缺失表示当时未获取到该信息。评分数可能包含没有文字内容的评分，不等于文字评论数。