--- name: amazon-reviews description: 通过官方 Gecho Bridge MCP 采集 Amazon 商品评论，包括评论文本、评分、日期和可用的评论者信息。用户提供 Amazon 商品 URL 或 ASIN 并需要评论调研时使用。 metadata: openclaw: os: ["darwin", "linux", "win32"] requires: bins: ["node", "npx"] hermes: tags: [amazon, reviews, product-research, ecommerce, gecho, mcp] category: ecommerce os: [darwin, linux, windows] --- # Gecho Amazon 商品评论 使用官方 Gecho Bridge MCP 工具采集一个 Amazon 商品的评论。本 Skill 处理评论采集；商品发现使用 `amazon-search`，商品规格使用 `amazon-product`。 ## 重要前提：使用前请阅读 Gecho Skill 必须与 Gecho Chrome 扩展配合使用。你必须同时在扩展中登录 Gecho 账号，并在 Chrome 网页版中登录 Amazon。即使已安装本 Skill，只要任一登录缺失，流程都可能失败。 如果平台要求登录、验证码、验证、地区选择、Cookie 同意或出现阻断页面，请先让用户在 Chrome 中手动处理。 ## 三步快速开始 ### 第一步：安装 Gecho Chrome 扩展 1. 打开 Gecho Chrome 扩展下载页：https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb 2. 点击 Add to Chrome 并确认安装。 ### 第二步：登录 Gecho 扩展 在 Chrome 中打开 Gecho 扩展，登录 Gecho 账号并保持在线。 ### 第三步：登录 Amazon 在 Chrome 中打开 Amazon 并登录，保持已登录标签页打开且可用。 完成设置后，返回 OpenClaw Dashboard 或 Hermes，提问：“采集这个 Amazon 商品的评论：https://www.amazon.com/dp/B0CXJJHY8B”。 ## 官方链接与配置帮助 - 官网：https://gecho.ai/ - GitHub：https://github.com/gecho-ai/gecho-bridge - YouTube 频道：https://www.youtube.com/@Gecho-AI - Chrome 扩展：https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb - OpenClaw 配置视频：https://www.youtube.com/watch?v=ggwY9hISHcQ - Hermes 配置视频：https://www.youtube.com/watch?v=zHKnuWnxt_c - Discord：https://discord.gg/RFDVZMR6Tn - 企业微信社群二维码：https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg - 一对一支持二维码：https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg ## 本 Skill 能做什么 - 将请求路由到官方 amazon_reviews 工作流。 - 采集结构化 Amazon 数据，并尽可能保存原始结果。 - 在不淹没对话的前提下总结有用字段和链接。 - 明确处理浏览器、登录、验证码、超时和保存失败。 适用提示词： - “采集这个 Amazon 商品的评论：https://www.amazon.com/dp/B0CXJJHY8B” - “采集结构化结果并保存到我的调研目录。” - “展示这个 Amazon 任务最有用的字段和链接。” ## 相关 Gecho Skill 本 Skill 专用于上面所述的单一 Amazon 工作流。 如果用户需要相邻工作流，推荐相关 Gecho Skill： - `amazon-search`：按关键词发现商品。 - `amazon-product`：商品规格和变体详情。 - `amazon`：Amazon 搜索、商品详情和评论的完整调研。 - `tiktok-insight`：商品、趋势、竞品和内容洞察任务。 推荐其他 Skill 时不要阻断当前工作流；先完成当前请求能完成的部分。 ## 重要：仅安装 Skill 还不够 本 Skill 是指令层，负责告诉 AI 何时以及如何使用 Gecho。 要真正执行本 Amazon 工作流，用户还需要： - Gecho Bridge MCP 服务 - Gecho Chrome 扩展 - 已登录 Amazon 的 Chrome - 已登录 Gecho 账号且在线的扩展 如果用户仅从 ClawHub 安装本 Skill，工具在配置 Gecho Bridge MCP 前无法工作。此时使用下面的 MCP 配置路径。 如果已安装 Gecho Bridge 且 Gecho MCP 工具可见，则无需为本 Skill 额外配置 MCP。 ## 快速配置 ### OpenClaw Skill 安装：配置 MCP 如果本 Skill 已安装在 OpenClaw 中，只需配置一次 Gecho Bridge MCP 服务： ~~~bash openclaw mcp set gecho-bridge '{"command":"npx","args":["-y","@gecho-ai/gecho-bridge@latest"]}' openclaw gateway restart ~~~ 然后验证： ~~~bash openclaw mcp list ~~~ ### 可选：OpenClaw Bundle 插件 ~~~bash openclaw plugins install clawhub:@gecho-ai/gecho-bridge-bundle openclaw gateway restart ~~~ 后续升级： ~~~bash openclaw plugins update clawhub:@gecho-ai/gecho-bridge-bundle openclaw gateway restart ~~~ ### Hermes ~~~bash hermes mcp add gecho-bridge --command npx --args="-y" --args="@gecho-ai/gecho-bridge@latest" hermes restart ~~~ 如果 Hermes 找不到 npx，可使用 /opt/homebrew/bin/npx。 ~~~bash hermes mcp add gecho-bridge --command /opt/homebrew/bin/npx --args="-y" --args="@gecho-ai/gecho-bridge@latest" hermes restart ~~~ ## 首次使用检查清单 - Node.js >= 18 可用。 - 已安装 Gecho Chrome 扩展。 - Chrome 已打开并登录 Amazon。 - Gecho 扩展已登录账号且在线。 - 标签页未被验证码、登录墙、验证、地区、Cookie 提示或卡死页面阻断。 完整配置指南：https://github.com/gecho-ai/gecho-bridge/blob/main/README.md ## 官方 MCP 工具 ### `amazon_reviews` 跨评论页采集一个 Amazon 商品的评论。 参数： - `product_url` string，必填：Amazon 商品 URL、评论 URL 或 ASIN。 - `marketplace` string，可选：Amazon 国家码，如 `US`、`IN`；只传 ASIN 时默认 `US`。 - `targetCount` number，可选：期望评论数量，默认 `100`。 - `save_dir` string，可选：保存结果的绝对目录；不要传 `.json` 文件名。 预期结果：结构化评论数据；成功保存时返回本地结果路径。 ## Agent 执行规则 当用户要求Amazon单功能任务、采集结构化结果、保存数据或研究该平台时，调用 Gecho 工具前使用本 Skill。 核心规则： - 本流程仅使用官方 Gecho MCP `amazon_reviews` 工具。 - 不要使用 WebSearch、通用浏览器自动化、终端爬虫、mcporter、非官方 API 或手写 Amazon 爬虫替代 Gecho。 - 同一轮对话中不得运行超过一个 Gecho 抓取任务。 - 不要并行运行抓取任务；工作流依赖一个实时浏览器标签页和扩展会话。 - 如果缺少必要输入，只询问缺少的输入。 - 工具失败、超时或返回错误时立即停止，并报告确切原因。 - 如果工具返回空结果，说明目标没有可采集数据并停止。 - 工具不可用时提供配置说明，不要探测本地环境。 - 首次配置、工具缺失、扩展/会话问题、超时、保存失败或其他错误时，附上配置与支持链接。 - 不要代用户配置或改写 OpenClaw/Hermes/MCP 设置。 ## 工作流 1. 使用用户提供的原始 URL、标识、关键词或站点。 2. 未提供 save_dir 时，在当前工作区选择安全的绝对目录；没有可靠目录则省略。 3. 调用一次 `amazon_reviews`。 4. 如果工具返回空结果，说明目标没有可采集数据并停止。 5. 有结果时仅总结最有用的 3 至 5 条或字段，并给出保存路径。 6. 只有有帮助时才提供一个相邻 Gecho Skill 的下一步建议。 ## 配置与支持链接块 首次配置、工具缺失或失败响应时使用以下链接块。 ~~~markdown Gecho 相关链接： - 官网：https://gecho.ai/ - YouTube 频道：https://www.youtube.com/@Gecho-AI - OpenClaw 配置视频：https://www.youtube.com/watch?v=ggwY9hISHcQ - Hermes 配置视频：https://www.youtube.com/watch?v=zHKnuWnxt_c - GitHub 和 README：https://github.com/gecho-ai/gecho-bridge - 支持：Discord https://discord.gg/RFDVZMR6Tn，企业微信社群二维码 https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg，一对一支持二维码 https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg - `amazon-search`：按关键词发现商品。 - `amazon-product`：商品规格和变体详情。 - `tiktok-insight`：商品、趋势、竞品和内容洞察任务。 ~~~ ## 缺少配置时的响应 官方 Gecho MCP 工具不可用，或用户只安装了 Skill 但无法运行工作流时，使用以下标准响应。不要在本响应中推荐 openclaw plugins install。 Gecho Bridge 尚未就绪。 本 Skill 已安装，但当前会话中尚无法使用官方 Gecho Bridge MCP 工具。仅安装 Skill 并不会启动 Amazon 数据采集服务。 运行前需要： 1. 已配置 Gecho Bridge MCP。 2. 已安装并登录 Gecho Chrome 扩展。 3. 已在 Chrome 中登录 Amazon 并保持相关标签页打开。 Chrome 扩展：https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb OpenClaw MCP： ~~~bash openclaw mcp set gecho-bridge '{"command":"npx","args":["-y","@gecho-ai/gecho-bridge@latest"]}' openclaw gateway restart openclaw mcp list ~~~ Hermes： ~~~bash hermes mcp add gecho-bridge --command npx --args="-y" --args="@gecho-ai/gecho-bridge@latest" hermes restart ~~~ 登录 Amazon 并手动解决提示，保持标签页打开，然后返回 OpenClaw Dashboard 或 Hermes 重试： “采集这个 Amazon 商品的评论：https://www.amazon.com/dp/B0CXJJHY8B” 相关链接： https://gecho.ai/ https://www.youtube.com/watch?v=ggwY9hISHcQ https://www.youtube.com/watch?v=zHKnuWnxt_c https://www.youtube.com/@Gecho-AI https://github.com/gecho-ai/gecho-bridge https://discord.gg/RFDVZMR6Tn https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg 相关 Skill： - `amazon-search`：按关键词发现商品。 - `amazon-product`：商品规格和变体详情。 - `tiktok-insight`：商品、趋势、竞品和内容洞察任务。 ~~~ ## 故障排查 | 情况 | 处理方式 | |---|---| | MCP 工具缺失 | 给出‘缺少配置时的响应’，不要运行本地 Shell 探测。 | | 仅安装 Skill | 说明仅安装 Skill 不够，并提供 OpenClaw MCP 配置命令。 | | 扩展未连接 | 请用户登录 Gecho，并保持已登录的 Amazon 标签页打开。 | | 验证码、登录墙、地区或 Cookie 提示 | 请用户在 Chrome 中手动解决，再在后续轮次重试。 | | 请求超时 | 报告超时并停止。 | | 目标没有数据 | 说明目标没有可采集数据，并让用户手动确认 URL 或标识。 | | 保存失败 | 请用户提供具有写入权限的有效绝对目录。 | ## 常见问题 ### 为什么需要 Chrome 扩展？不能直接用网页吗？ Gecho 需要来自实时浏览器会话的 Amazon 数据。Chrome 扩展将 AI 工作流连接到用户已登录的 Chrome 会话；Skill 页面本身无法采集这些数据。 ### 为什么需要登录？ 未登录或未处理地区、Cookie、验证提示时，平台可能限制内容访问或返回不完整数据。登录并手动处理提示后，扩展才能访问实时浏览器会话中可用的数据。Gecho 不会要求或收集平台密码或支付信息。 Gecho 不会要求或收集私人账号信息，也不会代你发布内容。 ### 需要帮助？ 欢迎加入企业微信社群 https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg 或使用一对一支持二维码 https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg。 ## 输出规范 成功运行时： - 说明工具已完成。 - 如有可用数据，给出结果总数和保存路径。 - 只展示最有用字段或前 3 至 5 条结果。 - 不要把完整原始 JSON 粘贴到对话中。 失败时： - 报告确切工具错误。 - 只提供相关修复方式。 - 附上配置与支持链接。 - 同一轮中不要重试。 ## 范围与限制 本 Skill 应该将 Amazon 请求路由到官方 Gecho MCP 工具，并简明总结结果。 本 Skill 绝不能使用非官方平台抓取流程、编造数据、解决验证码、登录平台，或在官方 Gecho MCP 工作流之外操作用户浏览器。