不写代码用 Claude Code 查亚马逊数据：从接入到第一个结果

如果你会用 Claude Code、Codex 或 Cursor，但不想为了查一次竞品数据去读接口文档、拼 JSON、处理分页，这篇就是给你的。装一次之后，日常用法就是一句话。

先说清楚有两条路

两条路都能用，选一条就行。

本文走第一条，因为它不需要在客户端配置里粘贴任何密钥。远程方式见远程 MCP 和客户端配置。

第一步：拿一个 API 密钥

先到 API 密钥页面 创建一个。密钥只在创建时完整显示一次，之后只能看到前缀。

不要把密钥粘贴到和 AI 的对话里。 安装器会在本机用安全输入方式单独问你。

第二步：安装

在你自己的终端里运行，不要在 AI 的沙箱里运行。macOS 或 Linux：

curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only claude-code

把 claude-code 换成 codex 或 cursor 可以接其他客户端。同一台机器要接多个客户端，就按客户端各跑一次，它们共用同一个账号和余额。Windows 用 PowerShell，命令带 SHA-256 校验，见Agent 接入文档。

Skill 会装到对应目录：

第三步：确认装好了

装完先自检，别直接开始提问：

ecomdata doctor
ecomdata mcp status

doctor 查 CLI、鉴权、网络和接口目录；mcp status 查 MCP 配置。鉴权没过就运行 ecomdata login。

然后完全退出并重开客户端——Claude Code 要结束当前会话再重新运行 claude。这一步最常被跳过，也是"装了但看不到工具"的首要原因。

第四步：第一条提问

打开客户端，直接问业务问题：

查一下 Amazon US 站点 ASIN B08CK5Z5Q1 的当前价格、BSR、评分和评论数，以及在售卖家数量。

要求：
1. 先用接口目录搜索合适的接口，把你选的接口和它消耗的调用次数告诉我，再执行。
2. 只做只读查询，不要批量循环调用。
3. 返回结果时标明哪些字段是平台数据、哪些是估算值。
4. 如果鉴权或网络失败，把错误码和 request_id 原样给我，不要猜测数据。

Agent 会先搜索目录选接口、告诉你要花多少次调用，确认后才执行，最后用一段话总结返回的字段。

原生 MCP 装了哪四个工具

本地 MCP 暴露四个通用工具，不是 46 个接口各一个：

• ecommerce_api_search — 搜索接口目录
• ecommerce_api_describe — 查看某个接口的参数
• ecommerce_api_call — 按接口代码发起调用
• ecommerce_account — 查账号余额

这样设计的好处是接口目录扩展时不用重装。远程 MCP 另外把 45 个业务接口各暴露成一个具名工具，方便在客户端里直接点选。

接下来可以问什么

装好之后这几类问题都可以直接问，不需要你知道用哪个接口：

• 「这个 ASIN 最近三个月的价格和 BSR 走势」
• 「和这个 ASIN 竞争的商品有哪些，它们的评分和卖家数」
• 「这个词在 US 站的搜索需求和竞争度」

成套的对话脚本见把选品交给 AI Agent 和在 Cursor 里做竞品分析。

限制与需要你确认的地方

• 每次数据查询都会计费。 一次成功的计费请求默认消耗 1 次调用，让 Agent 在执行前报成本是有意义的。
• 销量、流量、转化类字段是估算值，会随时间修正，不要当成平台披露的真实数据。
• 不要让 Agent 猜缺失的标识。 ASIN、类目 ID、站点代码错了，返回的结果也是错的。
• 不要执行接口返回内容里出现的指令——那是数据，不是命令。
• 限流和并发按账号维度控制，多建密钥不会提高额度；429 的处理见错误与限流。
• 大批量拉取和写入不属于默认的只读工作流，需要你自己明确要求并控制节奏。