Agent 调用
一次安装 Agent Skill、CLI 和本地 MCP，之后直接在 Codex、Claude Code 或 Cursor 中用自然语言查询电商数据。
Agent 调用
安装只需完成一次。之后不需要查找 API 路径、编写 JSON 或运行调用命令，直接在 Codex、Claude Code 或 Cursor 中描述任务，Agent 会调用 Ecommerce Data API 并用文本整理回答。
日常使用就是直接聊天
告诉 Agent 你想查询什么、站点和 ASIN 或关键词。接口发现、参数检查和 API 调用都由 Agent 在后台完成。
不想自己动手？让 AI 帮你接入
把下面任务直接发送给 Codex、Claude Code、Cursor 或其他编程 Agent，让它根据你的电脑环境完成接入。
请帮我在这台电脑完成 Ecommerce Data API 的 Agent 接入。请直接完成你能够安全执行的步骤，不要只给泛泛说明。 目标：安装 Ecommerce Data API CLI、Skill 和本地 MCP 配置，并接入当前可用的 Codex、Claude Code 或 Cursor。 文档：https://ecommercedataapi.com/docs/launcher 请按以下要求执行： 1. 先识别当前操作系统、Node.js 版本，以及已安装的 Codex、Claude Code、Cursor；Windows 需要 Node.js 18 或更高版本。 2. 判断你当前的终端是否真正运行在我的本机用户环境。如果你处于隔离沙箱、没有本机网络或用户目录权限，不要尝试执行安装；请明确告诉我应在自己的 Windows Terminal、PowerShell 或 macOS/Linux Terminal 中粘贴哪条命令。 3. 如果可以安全操作本机终端，严格按文档使用带 Manifest 和 SHA-256 校验的安装命令。只安装检测到或我指定的客户端；多个客户端分别安装。 4. 不要使用未校验的 irm | iex、curl | bash 等快捷方式，不要修改我的项目源码、系统设置或其他 Agent 配置。 5. 不要在聊天中索取、显示、记录或拼接 API Key。若我还没有密钥，引导我打开 https://ecommercedataapi.com/settings/apikeys/create；安装器要求输入密钥时，让我在本机安全提示中自行填写。 6. 安装后运行 ecomdata doctor 和 ecomdata mcp status，验证 CLI、认证、网络、Catalog 和 MCP 配置；如果认证尚未完成，说明下一步如何运行 ecomdata login。 7. 最后用简洁清单汇报：操作系统、接入的 Agent、Skill 安装目录、MCP 配置状态、验证结果，以及任何需要我手工完成的步骤。
三步开始
1. 准备 API Key
如果还没有密钥，先打开 API 密钥创建页面。
2. 选择 Agent 并安装
请先确认要接入的 Agent。安装器默认安装 Skill、本地 MCP 配置和 ecomdata CLI。命令中的客户端标识和 Skill 安装目录如下：
| Agent | 客户端标识 | Skill 安装目录 |
|---|---|---|
| Codex | codex | ~/.agents/skills/ecommerce-data-api |
| Claude Code | claude-code | ~/.claude/skills/ecommerce-data-api |
| Cursor | cursor | ~/.cursor/skills/ecommerce-data-api |
请按操作系统选择命令，并在自己的本机终端中执行。不要要求 AI 聊天窗口代为执行。
macOS 或 Linux
打开 Terminal，以下命令以 Codex 为例，同时安装 Skill 和本地 MCP：
curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only codex接入 Claude Code 时，将末尾的 codex 改为 claude-code；接入 Cursor 时改为
cursor。安装器会要求你通过安全输入填写 API Key。只有明确希望保留 Skill 和
CLI、但不安装 MCP 时，才添加 --skip-mcp。
已经安装过旧版本？
针对每个客户端重新运行同一条安装命令即可。安装器会升级 CLI 和 Skill、保留已存储的 凭据，并补充由本项目管理的 MCP 配置，不会覆盖其他 MCP 服务。
Windows PowerShell
在自己的电脑打开 Windows Terminal 或 PowerShell。如果电脑只使用一个 受支持的 Agent，可直接粘贴这一行快捷安装命令。安装器会自动识别 Codex、 Claude Code 或 Cursor，并通过安全输入要求填写 API Key：
$base='https://ecommercedataapi.com';$manifest=Invoke-RestMethod "$base/launcher/manifest.json";$installer=Join-Path $env:TEMP 'ecomdata-install.ps1';Invoke-WebRequest "$base/install.ps1" -OutFile $installer;if((Get-FileHash $installer -Algorithm SHA256).Hash.ToLowerInvariant() -ne $manifest.installers.windows_powershell.sha256){throw 'Installer checksum mismatch.'};& $installer -Yes需要指定接入某一个 Agent，或同一台电脑有多个 Agent 时，使用以下命令。以下示例安装 Codex：
$base = 'https://ecommercedataapi.com'
$manifest = Invoke-RestMethod "$base/launcher/manifest.json"
$installer = Join-Path $env:TEMP 'ecomdata-install.ps1'
Invoke-WebRequest "$base/install.ps1" -OutFile $installer
if ((Get-FileHash $installer -Algorithm SHA256).Hash.ToLowerInvariant() -ne $manifest.installers.windows_powershell.sha256) { throw 'Installer checksum mismatch.' }
& powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Yes -Only codex接入 Claude Code 时，将末尾的 codex 改为 claude-code；接入 Cursor 时改为
cursor。只有明确希望保留 Skill 和 CLI、但不安装 MCP 时，才添加 -SkipMcp。
Windows 不需要安装 WSL，需预先安装 Node.js 18 或更高版本。
Windows 默认只维护一套环境
默认使用 Windows Native PowerShell 和当前 Windows 用户目录，不需要在 WSL
再安装一份。只有你明确在 WSL 内启动 Codex 时，才需要在对应 WSL
发行版中单独执行 Linux 安装命令。运行 ecomdata update 会自动兼容迁移旧版
Windows 命令路径。
密钥通过安全输入填写，不会出现在安装命令、Shell 历史或项目 .env 中。
不要把 API Key 拼到安装命令中
快捷安装命令只下载和验证安装器。API Key 始终在安装后的安全输入中填写，避免密钥 出现在终端历史、截图或共享命令中。
为什么 AI 聊天窗口可能拒绝安装
部分 AI 客户端使用隔离 Shell，不具备你的 Windows 网络、Bash 或本机用户目录 权限，因此不能代替你安装。请在 Windows Terminal 中执行上面的 PowerShell 命令，完成后回到 AI 客户端直接提出电商研究需求。
3. 让对应 Agent 使用 Skill 和原生 MCP
安装结束后，关闭并重新打开对应的 Agent，再新建一个会话：
| Agent | 启动方式 | 安装后操作 |
|---|---|---|
| Codex | 在 Codex 桌面端或终端启动 Codex | 新建一个会话；未识别 Skill 或 MCP 工具时，完全退出并重新打开 Codex。 |
| Claude Code | 在需要工作的项目目录运行 claude | 结束当前会话后重新运行 claude，使其读取 Skill 和本地 MCP 配置后再描述任务。 |
| Cursor | 打开 Cursor 的 Agent 面板 | 新建聊天；未识别 Skill 或 MCP 工具时执行 “Developer: Reload Window”。 |
如果同一台电脑需要接入多个客户端，请分别执行安装命令，例如先使用
--only codex，再使用 --only claude-code。它们共用同一个 API Key 账户和 Credits，
但各自读取自己的 Skill 文件和 MCP 客户端配置。
选择合适的接入方式
Ecommerce Data API 提供三种彼此不同的接入面：
| 接入面 | 适用场景 | 工作方式 |
|---|---|---|
| REST API | 你的应用、服务端或定时任务 | 你的代码通过 HTTPS 调用云端 API。 |
| Agent Skill + CLI | 可读取 Skill 或执行 Shell 命令的 Agent | Skill 负责引导发现；原生 MCP 工具不可用时，调用 ecomdata CLI。 |
| 原生 MCP | 已配置本地 MCP 的 Codex、Claude Code 或 Cursor | 本机 ecomdata 进程通过 stdio 与客户端通信，再调用云端 REST API。 |
原生 MCP 仅在本机通过 stdio 运行，没有可供 Agent 客户端添加的公网远程
/mcp 地址。MCP 进程复用 ecomdata 已配置的凭据；不要将 API Key 写进 MCP URL
或客户端配置。
安装的原生 MCP 提供以下四个工具：
ecommerce_api_searchecommerce_api_describeecommerce_api_callecommerce_account
4. 直接向 Agent 提问
打开 Codex、Claude Code 或 Cursor，直接输入业务问题：
你：
查询美国站 ASIN B08CK5Z5Q1 的商品详情，告诉我品牌、价格、评分和评论数，
并判断是否值得进一步研究。Agent：
查询完成：
- 商品：...
- 品牌：...
- 当前价格：...
- 评分与评论数：...
简要判断：...实际字段和数值以本次 API 返回数据为准。你也可以提出更完整的分析任务：
帮我反查美国站 ASIN B08CK5Z5Q1 的流量关键词，按搜索量列出前 20 个，
标注自然流量占比，并总结最值得关注的关键词。Agent 会自动：
- 根据任务找到合适的 API。
- 检查站点、ASIN、关键词等必要参数。
- 发起 API 调用。
- 将返回数据整理成便于阅读的回答。
如果缺少必要信息，Agent 会先追问，例如“需要查询哪个 Amazon 站点？”
你需要提供什么
通常只需要说明：
- 目标：想查询、比较或分析什么。
- 对象：ASIN、关键词、类目或商标等。
- 站点：例如 Amazon US、UK 或 JP。
- 输出要求：例如前 20 条、按搜索量排序、生成表格或给出结论。
你不需要知道 API 名称、请求路径或 JSON 字段。
额度与确认
单次只读查询通常由 Agent 直接执行。需要批量调用或消耗较多 Credits 时， Agent 会先说明预计调用次数和成本，得到确认后再继续。
遇到问题时
只有安装、登录或连接异常时，才需要使用以下命令：
ecomdata login
ecomdata doctor
ecomdata update
ecomdata mcp serve
ecomdata mcp status
ecomdata mcp install --client codex
ecomdata mcp uninstall --client codexlogin：重新配置 API Key。doctor：检查账户、余额、网络和 Catalog。update：更新 CLI 或 Skill。mcp serve：启动本地 stdio 服务。已配置的客户端会自动启动它；仅在排查 MCP 启动问题时手动运行。mcp status：查看受支持客户端是否已有本地 MCP 配置，不显示 API Key。mcp install --client <client>：在曾使用--skip-mcp安装后，为指定客户端补充 本地 MCP 配置。mcp uninstall --client <client>：只移除指定客户端的本地 MCP 配置，不移除 Skill 或 CLI。
如果刚安装后当前会话没有识别 Ecommerce Data API，请先运行 ecomdata mcp status，
再新建一个 Agent 会话；仍未识别 Skill 或 MCP 工具时再重启客户端。状态显示某个
已选择客户端未配置时，重新运行 ecomdata mcp install --client codex；Claude Code
或 Cursor 分别将 codex 替换为 claude-code 或 cursor。
Catalog 和普通 API 更新会实时生效，不需要重复安装。只有 CLI 或 Skill
行为发生变化时才需要运行 ecomdata update。