在 OpenClaw 中使用 ZooData 技能入门指南

ZooData 为 AI Agent 提供按需数据采集与智能分析能力——可访问 2 亿以上产品、10 亿以上评论分析、实时 BSR、定价和竞品信号。通过 OpenClaw 配合预构建的 Agent 技能，是最快速的上手方式。

本指南涵盖从 API Key 配置到安装技能，再到完成第一次亚马逊市场分析的全流程，大约需要 10 分钟。

前置准备

• 已安装并运行的 OpenClaw（云端或自托管均可）
• ZooData API Key——在 apiclaw.io/en/api-keys 免费获取
• 已安装 Node.js（推荐 v18 及以上版本）

注册即可获得 1,000 免费额度，每次 API 调用消耗 1 个额度。参考数据：一次完整的市场分析通常消耗 20-40 个额度。

第一步：获取 API Key

访问 apiclaw.io/en/api-keys 注册免费账户。你的 API Key 以 hms_live_ 开头，注册后立即可用，无需信用卡。

第二步：在 OpenClaw 中配置 API Key

在你的 OpenClaw 环境中，将 API Key 设置为环境变量：

export APICLAW_API_KEY='hms_live_your_key_here'

如需持久化配置，可在 OpenClaw 的环境配置文件中添加：

{
  "env": {
    "APICLAW_API_KEY": "hms_live_your_key_here"
  }
}

你可以在 apiclaw.io/en/usage 查看额度余额，以确认 Key 是否正常工作。

第三步：安装技能

ZooData 共有 10 个 Agent 技能，每个聚焦于特定的亚马逊调研工作流。初次使用推荐安装市场准入分析技能（Market Entry Analyzer）——它涵盖市场规模评估、竞争分析，并给出明确的"可进入/需谨慎/应回避"结论。

npx skills add SerendipityOneInc/APIClaw-Skills/amazon-market-entry-analyzer

一次性安装全部技能：

npx skills add SerendipityOneInc/APIClaw-Skills

系统会提示你选择要安装的技能。完整列表如下：

技能	功能描述
amazon-market-entry-analyzer	市场可行性判断（可进入/谨慎/回避）
amazon-opportunity-discoverer	基于卖家画像的产品机会扫描
amazon-competitor-intelligence-monitor	全面竞品分析，含分级预警
amazon-review-intelligence-extractor	从 10 亿以上评价中提取消费者洞察
amazon-pricing-command-center	定价信号（涨价/持平/降价）
amazon-market-trend-scanner	类目趋势检测
amazon-listing-audit-pro	8 维度 Listing 健康度检测
amazon-daily-market-radar	每日监控与预警
amazon-analysis	全方位调研，含 13 种选品模式
apiclaw	直接访问全部 11 个 API 接口

第四步：运行第一次分析

技能安装完成、API Key 配置好之后，打开 OpenClaw，输入：

分析"母婴用品 > 婴儿车及配件"市场，判断是否值得进入。

Agent 将会：

1. 查找类目路径
2. 拉取市场级指标（平均月销量、品牌集中度、新品入场率、FBA 占比）
3. 筛选符合机会条件的产品
4. 返回结构化的"可进入/需谨慎/应回避"判断，并附上数据支撑

你应该会看到额度减少约 10-20 个，这说明 Agent 正在调用实时 API，而非依赖训练数据作答。

第五步：尝试其他技能

市场准入分析技能运行正常后，可以用以下提示词体验其他技能：

竞品情报监控：

对 ASIN B07JMZYJVW 使用竞品监控技能的快速检测模式

产品机会发现：

在"母婴用品 > 婴儿车配件"类目，以低预算初级卖家的标准寻找产品机会

定价指挥中心：

为 ASIN B0FJFJRRK8 给出定价信号

评价情报提取：

提取 ASIN B0FJFJRRK8 的消费者洞察

理解输出结果

每个 ZooData 技能的输出都遵循统一的置信度标注格式：

• 📊 数据支撑 — 直接来自 API 数据的结论
• 🔍 推断 — 基于数据的逻辑推理
• 💡 方向性建议 — 策略性建议与预测

这套标注体系让你随时清楚每个结论的可信程度。硬数据标注 📊，解读性内容标注 🔍，策略建议标注 💡。

额度消耗参考

技能 / 模式	典型额度消耗
市场准入分析	15-25
产品机会发现	10-20
竞品监控快速检测	5-10
竞品监控全面扫描	28-35
评价情报提取	10-20
定价指挥中心	8-15
市场趋势扫描	10-20

1,000 个免费额度足够进行数十次调研会话。

常见问题排查

运行技能后额度没有减少 通常意味着 API Key 没有传入技能运行环境。请检查 APICLAW_API_KEY 是否配置在 OpenClaw 的环境配置文件中，而不仅仅是终端会话的临时变量。

收到 429 限速错误 ZooData 的速率限制为每分钟 100 次请求。技能内置了重试逻辑（最多 4 次退避重试），但对非常大的类目扫描仍可能触发限速。尝试使用更具体的子类目路径以减少单次运行的 API 调用次数。

某个类目返回空结果 "电子产品"或"厨具家居"等宽泛类目会返回过多结果，需要更具体的子类目路径。例如，将"电子产品"改为"电子产品 > 耳机 > 入耳式耳机"。

下一步

熟悉单个技能之后，可以尝试将它们串联起来使用。典型的调研工作流如下：

1. 市场趋势扫描 — 识别哪些子类目在增长
2. 市场准入分析 — 对排名靠前的候选类目给出可行性判断
3. 产品机会发现 — 找到具体的可进入产品
4. 竞品情报监控 — 了解你将面对哪些竞争对手
5. 评价情报提取 — 了解买家想要什么，而现有竞品没有提供

完整 API 文档见 apiclaw.io/en/api-docs。GitHub 仓库见 github.com/SerendipityOneInc/APIClaw-Skills。