Amazon Reviews — Documentation skill for Claude Code

Amazon Reviews 飞书文档报告使用手册

这个项目用于把 Amazon 商品评论采集下来，并整理成一份适合阅读和分享的飞书文档报告。

当前约定：

• 采集来源使用 sorftime MCP
• 交付结果使用飞书 CLI 生成“飞书文档报告”
• 本地 scripts/amazon_reviews_api.py 仅作为辅助格式化脚本使用，不负责采集

适合人群：

• 第一次接触 Claude Code / MCP / 飞书 CLI 的新手
• 需要日常重复执行 Amazon 评论采集和报告整理的人

1. 这个项目能做什么

你提供一个 Amazon 商品的 `ASIN` 或商品链接后，这套流程会完成下面几件事：

1. 通过 sorftime MCP 采集评论数据
2. 整理评论字段和摘要信息
3. 用飞书 CLI 创建一份飞书文档
4. 把结果写成“飞书文档报告”
5. 返回飞书文档链接，方便查看、转发和继续编辑

最终产物不是电子表格，也不是纯原始 JSON，而是一份适合业务阅读的飞书文档报告。

2. 目录说明

当前文件夹主要内容：

• SKILL.md：Skill 说明，定义采集与交付规则
• scripts/amazon_reviews_api.py：把评论 JSON 转成 Markdown 表格的辅助脚本
• README.md：当前这份新手说明文档

3. 开始前你需要准备什么

在正式使用前，请先确认你有下面几项：

3.1 Claude Code

你需要能正常使用 Claude Code，并能在当前项目目录下运行它。

3.2 sorftime MCP

你需要先把 `sorftime MCP` 配置到 Claude Code 当前项目或用户配置里，因为评论数据必须从这里获取。

推荐使用项目级配置文件 `.mcp.json`：

{
  "mcpServers": {
    "sorftime": {
      "type": "http",
      "url": "https://mcp.sorftime.com?key="
    }
  }
}

确认方式：

• 执行 claude mcp list
• 确认输出里能看到 sorftime 且状态为已连接
• 确认当前 Claude Code 主会话可以直接调用它

如果 `sorftime MCP` 没有配置好，这个项目无法继续执行。

3.3 飞书 CLI

你需要安装并登录飞书 CLI，因为最终报告要输出到飞书文档。

你至少要保证：

• 飞书 CLI 已安装
• 已完成登录或授权
• 已具备创建飞书文档的权限

如果飞书 CLI 没装好，评论可以采集下来，但无法自动生成飞书文档报告。

3.4 可选：Python 环境

如果你需要把评论 JSON 先整理成 Markdown 表格，再粘贴进飞书文档，可以使用本地脚本：

python -u ./scripts/amazon_reviews_api.py reviews.json

这一步不是必须，但在排查格式、预览数据结构时很有帮助。

4. 推荐给新手的安装顺序

如果你是第一次搭建，建议按这个顺序做：

1. 安装 Claude Code
2. 配置 sorftime MCP
3. 安装并登录飞书 CLI
4. 打开当前项目目录
5. 先尝试一次最小任务：输入一个 ASIN，生成一份飞书文档报告

这样最容易定位问题。不要一开始就批量跑多个商品。

5. 日常执行时怎么用

日常使用时，你只需要给出下面任意一种输入：