前言¶

跨境卖家在亚马逊上往往要面对大量商品评论：手动翻差评很难覆盖全量，五星评论里也可能藏着「勉强好评」的抱怨。若只靠表格或关键词统计，高频问题不易量化，改进建议也缺少结构化输出。

下面介绍的 amazon-review-insights（SkillHub 展示名常与「亚马逊评论分析」对应）是一套面向全球电商卖家的 Amazon 商品评论智能分析 Skill。安装到 Cursor、Codex CLI、Claude Code 等支持 Agent Skills 的环境后，可由 Agent 按技能文档调用后端接口：抓取评论、做 AI 差评分析、统计高频问题、识别五星评论中的隐性负面反馈，并支持趋势跟踪与增量更新。SkillHub 上该技能分类为 business-ops，社区评分 97265，下载约 2125 次（数据来自任务线索中的 SkillHub 统计，以页面实时展示为准）。

这是什么¶

amazon-review-insights 是遵循通用 SKILL.md 格式的 Agent Skill，通过 Python CLI（技能包内的 scripts/api_client.py）与固定 API 端点 https://api.astrmap.com 通信，由 AstrMap 提供评论采集与 AI 分析能力；公开技能页维护者为 sparkbayes（据 SkillHub 镜像站同名技能元数据）。

它解决的是：把「建任务 → 采评论 → 等分析 → 拉结果」封装成 Agent 可执行的步骤，让运营用自然语言描述 ASIN、站点和需求，而不是自己拼 REST 请求。

官方 SkillHub 入口：

https://api.skillhub.cn/user_ad1cad5b/amazon-review-insights

对应社区页面：

https://skillhub.cn/skills/user_ad1cad5b/amazon-review-insights

（上述 API 地址在抓取时返回 405，页面详情以 SkillHub 站内展示为准；下文安装与 CLI 用法与公开发布的同名技能文档一致，安装后请以本地 SKILL.md 为准。）

核心功能¶

以下能力与 Skill 简介及公开文档描述一致，Agent 通过不同 action 组合完成：

1. 抓取 Amazon 评论：按 ASIN、站点创建采集或自动分析任务。
2. AI 差评分析：对评论做负面向分析与归纳。
3. 高频问题量化：通过类目标签分布、基础统计等接口汇总问题频率。
4. 五星评论中的隐性负面：在 AI 洞察与代表性评论等结果中呈现（具体字段以 API 返回为准）。
5. 改进建议：由 AI 洞察类接口生成可读的总结与建议方向。
6. 评论趋势：get_trend 等 action 支持趋势查看。
7. 增量更新：create_incremental 在已有任务上拉取新评论并重新分析（会消耗积分，需用户确认）。

仅查询已完成的分析结果时，只需 API Key，不要求采集通道在线；创建任务、增量抓取等需要采集通道（Chrome 浏览器扩展）在线且 check_device 返回 is_alive=true。

安装与启用¶

在 Agent 中安装 Skill¶

在 SkillHub 生态中，常见做法是把安装话术发给 Agent，由 Agent 通过 secure-skills 检索并安装。公开文档给出的命令为：

npx secure-skills-cli add amazon-review-insights

Cursor / Codex CLI / Claude Code 的具体菜单路径因版本而异，本质都是让 Agent 拉取技能包并加载 SKILL.md；若你使用 OpenClaw 等标注「OpenClaw 专属」的运行时，需确认当前环境是否在该技能的兼容性列表内。

环境变量与依赖¶

技能元数据要求配置环境变量 CUSTOMER_INSIGHTS_API_KEY，Python 依赖 requests>=2.28.0。建议在 shell 配置文件中写入：

export CUSTOMER_INSIGHTS_API_KEY="your-api-key-here"

API Key 获取路径（文档说明）：打开 https://app.astrmap.com/ 登录后，用户菜单（左下）→ API Keys 创建并复制。未配置时，Agent 应向你索取 Key，并在后续命令中通过 --api-key 传入。

安装 Python 依赖（在技能包目录下）：

pip install -r requirements.txt

安全说明：API Key 会发送至 api.astrmap.com 做鉴权，请勿把 Key 提交到仓库或日志。

采集通道（创建任务时）¶

创建采集或自动分析任务前，需安装并登录 AstrMap Chrome 浏览器扩展（文档称网站已不再分发旧版桌面客户端；check_device 仍可能返回 endpoint_type 为 extension 或历史 desktop）。扩展需配合 Chrome 内登录 Amazon 买家账号（文档明确要求勿用卖家账号），并保证能正常访问 Amazon。离线时先执行：

python scripts/api_client.py --action check_device --api-key "your-key"

直到 is_alive 为 true 再创建任务。

典型用法¶

统一调用形式：

python scripts/api_client.py --action <action> [--params...]

1. 新建 ASIN 并自动分析¶

流程上先做设备与积分检查，创建任务前向用户说明扣点并确认，再创建任务并轮询状态（文档建议约每 6 分钟查询一次任务详情）。

python scripts/api_client.py --action create_task --api-key "your-key" --asin "B09V3KXJPB" --site US

站点参数与语言映射（文档摘要）：US / CA / UK 等为英语站点，DE / FR / IT / ES / JP 等对应当地语言。

轮询示例：

python scripts/api_client.py --action get_task_detail --api-key "your-key" --task-id "TSK_xxx"

2. 只采集、稍后手动触发分析¶

创建时加 --is-auto false，任务停在 COLLECTED 后，可用 API Key 单独触发分析（此时不要求采集通道在线）：

python scripts/api_client.py --action trigger_analysis --api-key "your-key" --task-id "TSK_xxx"

3. 读取已完成任务的结果¶

查询已完成结果不扣积分、也不要求设备在线。示例：

python scripts/api_client.py --action get_ai_insights --api-key "your-key" --task-id "TSK_xxx"

python scripts/api_client.py --action get_category_tag_distribution --api-key "your-key" --task-id "TSK_xxx"

python scripts/api_client.py --action get_negative_reviews --api-key "your-key" --task-id "TSK_xxx" --page 1 --page-size 20

在对话里，你也可以直接用自然语言描述目标，例如让 Agent「获取某 ASIN 的评论并完成分析，最后给出前三类高频投诉与改进建议」——Agent 会按 SKILL.md 中的场景脚本依次检查 Key、设备、积分与任务状态。

适用场景与注意¶

适合谁

• 在 Amazon 多站点、多 ASIN 运营，需要系统化看差评与趋势的团队。
• 产品经理或运营希望把评论洞察接到日常 Agent 工作流，而不是单独开 BI 看板。

限制与注意

• 后端为 AstrMap 积分体系：自动分析、增量抓取会扣点；仅查询已完成结果不扣点。积分不足时 API 可能返回文档中的 1002 等错误码。
• 创建任务依赖浏览器扩展与买家账号环境；合规与账号安全请阅读技能包内 references/security.md（文档引用路径）。
• API 端点固定为 https://api.astrmap.com，不可改为自建地址。
• 任务长时间未完成时，文档建议检查扩展是否仍在线（例如超过约 18 分钟仍无进展）。

结尾¶

amazon-review-insights 把亚马逊评论的采集、AI 分析与结果查询收敛成 Agent 可执行的 Skill：适合需要持续跟踪差评、趋势和隐性反馈的卖家团队。安装与配置以 SkillHub 页面指引为准，技术细节以安装后的 SKILL.md 与 api.astrmap.com 行为为准。

官方地址：https://api.skillhub.cn/user_ad1cad5b/amazon-review-insights