What makes Amazon Voc notable?

1.6K downloads. Trust evidence available

How should Amazon Voc be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Amazon Voc

亚马逊买家之声：评论采集 + VOC 洞察报告

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.6k

Updated

Oct 10, 2026

Version

0.1.4

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.6K downloadsadoption · observed Oct 10, 2026
Latest release: 0.1.4release · observed Sep 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17ddkyn6xqtz4f83y2v0marjh89xqb5:amazon-variant-analysis

Install using `clawhub skill install s17ddkyn6xqtz4f83y2v0marjh89xqb5:amazon-variant-analysis` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/funewa/amazon-variant-analysis before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-funewa-amazon-variant-analysis/snapshot"

Documentation

CLAWHUB

141,565 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: amazon-voc
display_name: Amazon-VOC
description: >
  Amazon VOC（买家之声）评论分析 Skill：采集亚马逊评论并生成 VOC 洞察报告，
  提炼差评痛点、购买动因、用户画像、使用场景与 Listing 优化建议，
  支持竞品对比与趋势分析。
  本包同时提供 ARI 完整评论分析能力：订阅 ASIN 并采集评论、浏览与筛选评论、
  查看星级/关键词/趋势与雷达图表、生成 VOC 与深度洞察等分析报告、
  运行商品运营工作流、商品变化监控（watch）、差评预警与差评工作台、
  行业对标与类目排行，并导出评论 CSV 与报告 Markdown/HTML。
  Use when the user asks about Amazon VOC, voice of customer,
  buyer feedback, review mining, 买家之声、客户之声、VOC 分析、评论挖掘、评论采集、
  消费者反馈、差评分析。
  Requires an ARI API key (ari_live_*).
allowed-tools: Bash
author: ARI (funewa)
agent_created: true
slug: amazon-voc
displayName: Amazon-VOC
version: 1.4.10
summary: 亚马逊买家之声：评论采集 + VOC 洞察报告
license: MIT
---

# Amazon-VOC 买家之声

## 自然语言入口与输出

- 用户只需表达商品和目标，例如“分析美国站 B0XXXXXXXX 的评论，简要说说主要问题和趋势”。
  从对话中提取 ASIN、站点、范围和输出长度，复用已明确的信息；不要要求用户填写命令、
  workflow/focus 或默认页数。无站点信息时默认美国站并说明。
- 用户只问简析时先查看已有评论、图表和历史报告；足够回答就直接简析。数据不足时说明缺口，
  按后续工作流处理必要采集或分析。专用 Skill 以固定入口为准，不转成通用 VOC。
- 没有显式变体采集开关时，不要让用户选择工具无法执行的范围，也不要承诺“只含当前子体”
  或“包含全部变体”。按接口实际返回范围说明限制；范围影响结论时再澄清。
- 简短问题优先输出：数据范围、主要问题与评论依据、趋势判断。样本或时间跨度不足时明确说明，
  不把新入库的旧评论说成新发生的趋势；不强制展开完整报告。
- 安装授权步骤见“使用说明.md”；字段和高级命令按需读取 references/reference.md。
  用户未要求技术细节时，不展示内部任务标识、参数清单或命令日志。
- 费用按下方协议和服务端规则处理；用户明确说“只报价，不执行”时，仅调用免费的 quote
  和必要的 collect 报价，不运行可能免确认执行的 voc/analyze，也不擅自修改账户确认设置。

## 工具与入口

- CLI：本 Skill 目录下的 `scripts/ari.py`。在 Skill 根目录执行，例如
  `python scripts/ari.py check`；每次会话先跑一次 `check`。
- API 参考：需要字段、命令或错误码时读取 `references/reference.md`。
- API Key：首次使用运行 `python scripts/ari.py setup`——它会给出一个授权链接，
  用户在浏览器登录（或注册）后点一下「授权」，Key 自动获取并保存到本机，无需复制粘贴。
  也可用环境变量 `ARI_API_KEY`，或 `python scripts/ari.py configure` 手动粘贴。
  `setup` 期间把命令打印的授权链接原样转告用户，等待命令自行完成；**不要**替用户注册或登录。
- 申请 Key（手动方式）：<https://ari.funewa.com/zh/account?ui=d47626f#api-keys>
- 充值/套餐：<https://ari.funewa.com/zh/billing>
- Web 产品管理：<https://ari.funewa.com/zh/products>

## 安全与计费协议

- 所有 API 请求和授权入口仅支持 `https://ari.funewa.com`，禁止重定向。
  `ARI_ENDPOINT_BLOCKED` / `ARI_REDIRECT_BLOCKED` 时停止操作；不要设置其他端点、
  开启旧 `ARI_ALLOW_CUSTOM_BASE` 或关闭 TLS 校验来绕过。详见 references/reference.md。

- 缺少 Key 时立即停止，给出申请链接；不要索要用户密码，不要把 Key 写入报告或命令示例。
- `401 / ARI_UNAUTHENTICATED`：停止并引导重建 Key。
- `402 / ARI_INSUFFICIENT_CREDITS`：保留已有结果，引导充值；不得自动重试付费操作。
- `ARI_EMAIL_NOT_VERIFIED`：引导先到用户中心验证邮箱。
- VOC 默认使用 voc <ASIN>，由命令按服务端免确认规则处理总费用；该调用可能直接生成并扣点，
  不能描述为“只报价、不扣点”。返回 confirmationRequired 时必须先报价并等待用户同意。
- 当前请求已有明确扣点授权时可追加 --confirm；不得伪造授权或为了跳过询问改变确认设置。
  专用运营工作流仍遵守自己的报价和确认协议。
- **付费命令中断后不得直接重试。** `ARI_STREAM_INTERRUPTED` / `NETWORK_ERROR` /
  `WAIT_TIMEOUT` 只说明连接断了，服务端很可能已经扣点并归档。必须先跑免费的
  `reports --asin <ASIN> --limit 1` 确认是否已生成新报告，确认没有生成才可重跑 `--confirm`。
- 非美国站（`amz_uk` 等）采集只能使用付费积点（订阅套餐周期积点与增量包均可），
  赠送积点（注册礼/任务奖励等）不可用。以 `voc` / `collect` 报价里的
  `sufficient` / `usableBalance` 为准，不要用账户总余额判断是否够用。
- `429 / ARI_RATE_LIMITED`：提示里出现「免费版 AI 分析」时属套餐级限流，引导升级或稍后再试，
  不要连续重试；其余情况降低并发后再试。
- `ARI_COLLECTING`：采集尚未产出足够数据，本次未扣点，等待提示的秒数后重试即可。
- 返回 `success:false` 或 `failedPart

README.md

# Amazon-VOC

亚马逊买家之声：评论采集 + VOC 洞察报告

## 一句话开始

安装授权后，把下面这句话发到 AI 客户端对话框，替换示例 ASIN 即可：

~~~text
分析评论，简要说明主要问题和趋势。商品 B0XXXXXXXX（美国站）。
~~~

示例 ASIN 是占位符。AI 会识别商品、站点和目标，无需填写接口参数。
客户端未选中时，在问题前加“使用 $amazon-voc”。
缺少必要资料或目标不唯一时，AI 会说明需要补充什么；专用 Skill 只处理本页对应场景。

## 第一次使用：安装并授权

1. 通过市场安装本 Skill，或使用 ARI 用户中心的安装指令交给 AI 客户端安装。
2. 对 AI 说：“帮我完成 ARI 授权并检查是否可用。”
3. 打开 AI 返回的链接，自己登录或注册并授权；无需在聊天中粘贴 API Key。
4. AI 确认连接、余额和扣点规则后，直接发送你的问题。

需要支持 Skill 和本地 Python 3 的 AI 客户端。安装检查不采集评论、不生成付费报告、不开启监控。

## 会得到什么

- 先回答你提出的问题，附样本范围和评论依据；你说“简短”时先给摘要。
- 评论分析可提炼痛点、购买动机、场景和改进建议，支持竞品对比及趋势分析。
- 生成报告后附在线查看链接；已采集评论可导出 CSV，报告可导出 Markdown / HTML，受套餐权益限制。
- 样本或时间跨度不足时会说明无法判断趋势，不把缺失数据补成结论。

## 费用与数据范围

采集和 AI 分析消耗积点。VOC 等支持免确认的流程命中账户规则时可能直接执行并扣点；
其余情况先报价、等你同意。免确认不是免费，具体规则与余额可让 AI 查询。

可以直接说“以后每次扣点前先问我”，或“只报价，不执行”。
持续监控需要单独确认周期和后续采集成本。非美国站采集不能使用赠送积点。

分析与导出基于 ARI 已采集的数据，不保证覆盖 Amazon 上全部评论或全部变体。
免费读取已有评论、图表和历史报告不扣分析积点。
执行中断时先查询已有任务或报告，避免重复生成和扣点。

## 高级：手动安装、授权与命令

找到解压后同时包含 SKILL.md 和 scripts/ari.py 的目录，以 SKILL.md 顶部的 name
作为安装目录名。当前包的 name 是 amazon-voc，WorkBuddy 用户级目录为
~/.workbuddy/skills/amazon-voc/。版本压缩包的外层目录名不是固定 Skill 名。
更新已有同名安装时保留本地配置。

在安装目录执行：

~~~bash
python scripts/ari.py setup
python scripts/ari.py check
~~~

日常使用只需自然语言。完整命令、计费规则和故障处理见
[使用说明](使用说明.md)；集成参数见 [API 参考](references/reference.md)。

- [账号与授权管理](https://ari.funewa.com/zh/account?ui=d47626f#api-keys)
- [积点与套餐](https://ari.funewa.com/zh/billing)
- [在线报告](https://ari.funewa.com/zh/reports)

## 连接安全

API 与授权入口固定为 https://ari.funewa.com，禁止重定向。生产包不支持自定义端点，ARI_ALLOW_CUSTOM_BASE 不再生效。遇到 ARI_ENDPOINT_BLOCKED 或 ARI_REDIRECT_BLOCKED 时停止操作，清除自定义地址或联系 ARI 支持，不能绕过校验。

_meta.json

{
  "ownerId": "kn7d4ekgxgbth42fthnftjf1tn89w6df",
  "slug": "amazon-variant-analysis",
  "version": "0.1.4",
  "publishedAt": 1789378601752
}

references/reference.md

# ARI CLI 与 API 参考

仅在需要命令参数、响应字段或错误处理时读取本文件。

API 固定地址：`https://ari.funewa.com`，只允许 HTTPS 官方域名与默认端口 443。
生产发行包不支持自建端点；`ARI_BASE_URL` 设置为其他地址时，在读取 Key 和联网前
返回 `ARI_ENDPOINT_BLOCKED`。旧 `ARI_ALLOW_CUSTOM_BASE` 不再生效，`ARI_WEB_URL`
不再改变网页链接。JSON、SSE、下载和设备授权均禁止重定向，返回 `ARI_REDIRECT_BLOCKED`。
遇到这两类错误应停止操作并清除自定义地址或联系 ARI 支持，不能尝试关闭校验。
开发测试使用 mock 传输和虚构凭据，不向其他端点发送生产 Key。
域名严格匹配与系统默认 TLS 证书/主机名校验共同保护连接，不使用 DNS 预查代替 TLS 校验。
认证头示意：`Authorization: Bearer <YOUR_ARI_API_KEY>`，占位符不是可用凭据。统一 JSON 信封为
`{success, code, message, data, error, meta}`；SSE 分析由 CLI 聚合为同类 JSON。

`--compact` 输出单行 JSON，放在子命令前后都可以
（`ari.py --compact check` 与 `ari.py check --compact` 等价）。

## 版本与更新

CLI 在 User-Agent 里带自身版本（`ARI-Review-Skill/<version>`，与 `_meta.json` 一致）。
服务端在每个 API Key 响应上回 `X-ARI-Skill-Latest` / `X-ARI-Skill-Update-Url`；
本地版本更旧时，**任意命令**的输出都会多出一个顶层 `update` 字段：

```json
{"update": {"current": "1.0.4", "latest": "1.0.6", "url": "...", "message": "..."}}
```

`check` 还会额外读取免认证的 `/api/v1/public/config`，把完整的
`release: {latest, minSupported, url, notes}` 一并返回——Key 失效时也能拿到升级入口。

升级一律由用户通过原安装渠道完成。**CLI 不会下载或执行任何远端代码**，
也不要让 agent 代劳去取"新版文件"运行。

## 用户入口

- API Key：<https://ari.funewa.com/zh/account?ui=d47626f#api-keys>
- 充值/套餐：<https://ari.funewa.com/zh/billing>
- 产品管理：<https://ari.funewa.com/zh/products>
- 报告中心：<https://ari.funewa.com/zh/reports>

## CLI 命令

1.4.5 的 voc / analyze 可能根据账户免确认规则直接执行并扣点，不能将“不带 --confirm”
一概解释为“只报价”。用户明确只询价时用免费的 quote；必要的采集费用用 collect
不带 --confirm 查询。不要为这一次询价修改用户长期确认设置。


| 命令 | API | 是否可能扣点 |
|---|---|---|
| `setup` | auth/device/start + poll（免认证），浏览器授权后自动保存 Key | 否 |
| `configure` | 本地保存 Key | 否 |
| `check` | user/me + credits/balance | 否 |
| `products` | asins | 否 |
| `schedule` | asins（`--set`: asins/{id}/schedule） | 否（设置免费；采集本身按页扣点） |
| `competitors` | asins/{id}/competitors（GET/POST/DELETE） | 否（竞品加入后按周自动采集，那部分按页扣点） |
| `radar` | asins/{id}/radar | 否（纯 SQL；套餐未开放时 403） |
| `voc` | pricing + balance + collection/submit/status + analysis/voc + reports | 是；`--confirm` 或服务端免确认规则命中 |
| `collect` | billing/pricing + credits/balance + collection/submit | 是；必须 `--confirm` |
| `status` | collection/status/{taskId} | 否 |
| `reviews` | reviews | 否 |
| `charts` | charts/stars·trend·keywords·flow | 否 |
| `quote` | analysis/quote | 否 |
| `operations capabilities` | product-operations/capabilities | 否 |
| `operations profile` | product-operations/profile | 否 |
| `operations quote` | product-operations/quote | 否 |
| `operations run` | product-operations/quote + run（SSE） | 是；必须 `--confirm` |
| `operations status` | product-operations/runs/{requestId} | 否 |
| `watch list` | product-operations/watches（GET） | 否 |
| `watch create` | product-operations/watches（POST） | 否；受 watch 灰度与套餐额度限制 |
| `watch pause` / `watch resume` | product-operations/watches/{id}（PUT） | 否；只改变监控状态 |
| `watch delete` | product-operations/watches/{id}（DELETE） | 否；不删除商品资料、评论或历史报告 |
| `watch digest` | product-operations/watch-digest（GET） | 否；确定性摘要，`creditsUsed: 0` |
| `watch events` | product-operations/

CHANGELOG.md

# v1.4.10

- 修复「声明范围小于实际能力」：44 个专属运营包改为窄版文档，只保留本包固定的
  workflow/focus 入口；29 个全功能包改为如实声明完整能力集。不再出现「窄声明配全功能正文」
  或「只声明单点能力、正文却含全部能力」的自相矛盾。
- 全部 73 个包补齐 `allowed-tools: Bash`：本系列只运行 `python scripts/ari.py`，
  不写用户文件、不发任意网络请求、不修改商品页，明确最小工具权限。
- 专属包的自然语言示例改为本场景专属文案，不再复用通用 VOC 提问。
- 清理包内悬空引用：母版正文不再提及仅专属包才生成的约束文件，静态分析不再报
  「引用了包内不存在的产物」。
- 构建期新增三条硬闸：专属包不得出现母版全功能词汇、全功能包必须声明完整能力集、
  文档提到的包内相对路径必须真实存在。命令、字段与计费规则一律不变，不提高最低支持版本。

# v1.4.9

- API 请求固定到官方 HTTPS 域名；移除自定义端点双变量绕过，读取 Key 前校验最终地址。
- JSON、SSE、下载与设备授权统一拒绝重定向，安全错误在本地返回且不回显可疑 URL。
- 网页入口固定为官方地址，设备授权链接必须通过域名校验；安全错误中止授权轮询。
- 分发构建增加完整 ARI Key 检查，格式前缀与占位符允许保留，命中时只输出文件位置。
- 新增离线安全回归测试；保留现有报价、扣点确认和报告恢复行为。
- 通用入口文档不再引用仅专属包才生成的约束文件，避免指向包内不存在的产物。

# v1.4.8

- 采集报价改成固定单价口径：报价字段 `credits` = `pricePerPage` × `pages`，附 `pricingNote`；
  不再用 `estimatedCredits` / `estimatedReviews` 这类「预计」措辞（对应字段改为 `credits` / `approxReviews`）。
- `voc --confirm` 的合计字段 `estimatedTotalCredits` 改名 `totalCredits`；余额不足提示去掉「最多」。
- `schedule` 的 `_costNote`：每轮单价写「=」不写「≈」，并说明只按实际采到的页数收费。
- CLI 命令与计费规则不变，不提高最低支持版本。

# v1.4.7

- 新增 `topics` 命令：逐条评论话题标签的汇总与单话题详情（趋势 / 原句 / 本品 vs 竞品 / 标签洞察），免费。
- `reviews` 新增 `--topic` 按话题筛，返回行带 `tags[]`（维度 / 话题 / 原句），引用原句不再靠模型复述。
- 标准工作流第 12 条：用户问「抱怨最多的是什么 / 某问题最近变多了吗 / 竞品在这点上如何」先走 `topics`。
- CLI 接口与计费规则延续 v1.4.6，不提高最低支持版本。

# v1.4.6

- 用一句自然语言发起评论简析、竞品比较、Listing 优化等任务，优先复用对话中的商品与目标。
- 简短请求优先返回数据范围、问题与评论依据、趋势判断；不强制展示技术日志或完整报告。
- 优先读取已有数据；不追问接口没有提供的变体范围选项，不将新入库的历史评论当成近期趋势。
- 安装说明明确浏览器授权、目录识别、配置保留与连接检查；增加可复制的使用示例。
- 写清账户免确认策略、只报价不执行及单独开启持续监控的边界。
- 延续 v1.4.5 的 CLI 接口和计费规则，本次不提高最低支持版本。

Github ReposUpdated 15h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.