面向 AI Agent 的亚马逊电商数据层技能包。
200M+ 商品、1B+ 评论、实时信号 — 为 AI 结构化，而非为人类设计。
官网 • 获取 API Key • Discord • 快速开始 • API 参考
--- ## 什么是 ZooData？ [ZooData](https://zoodata.ai) 是专为 Agent 构建的数据基础设施。模型正在商品化，真正稀缺的是 Agent 能直接消费的结构化数据。ZooData 提供实时电商信号，让你的 Agent 每天能分析 10,000+ 商品，而不是 100 个。 当前已接入亚马逊，提供 36 个商品与关键词 API 接口，覆盖产品搜索、市场分析、竞品情报、实时追踪、评论洞察、类目导航、价格带、品牌和历史数据。干净 JSON，Agent 即用。 SPU 市场接口需要对应服务部署及已安装技能更新，见[市场接口迁移说明](docs/market-spu-migration.md)。 ## 技能概览 本仓库包含 **10 个 Agent 技能**，分为两个层级： **🏗️ 基础层** — 数据接入与全方位分析： | 技能 | 说明 | 输入 | 输出 | 核心优势 | |------|------|------|------|----------| | 📦 [`zoodata/`](zoodata/) | 直接调用全部 36 个 Amazon 商品与关键词 API 端点 | 关键词/品类/ASIN/品牌 | 原始 API 数据 + 字段映射文档 | 所有其他 skill 的底层依赖 | | 🎯 [`amazon-analysis/`](amazon-analysis/) | 13 种选品模式 + 市场/竞品/ASIN/定价/品类研究 | 关键词/品类/ASIN + 意图 | 分析发现、Top 产品、深度报告、置信度标签 | report/opportunity 复合命令一键跑完 | | 🔎 [`amazon-keyword-traffic-analysis/`](amazon-keyword-traffic-analysis/) | 基于 11 个关键词 intelligence 接口的关键词价值与商品流量健康工作流 | 种子词、目标词、ASIN 或 ASIN + 关键词 | 拓词分层、关键词价值分析、商品流量结构、趋势与健康诊断 | 专门覆盖关键词拓展、关键词分析和商品流量分析 | | 📊 [`amazon-market-analysis/`](amazon-market-analysis/) | 发现市场与产品候选、评估进入条件、追踪品类变化 | 市场问题、品类或选品需求 | 候选清单、条件性进入判断或趋势分析 | 一条故事线，明确区分市场证据与卖家决策 | **⚡ 专项层** — 面向特定工作流的专用技能： | 技能 | 说明 | 输入 | 输出 | 核心优势 | |------|------|------|------|----------| | ⚔️ [`amazon-competitor-intelligence-monitor/`](amazon-competitor-intelligence-monitor/) | 深度竞品情报 — Full Scan + Quick Check 双模式 | 关键词或 ASIN，可选竞品 ASIN | 竞品矩阵、品牌排名、价格地图、竞争力评分(1-100)、三级告警 | 双模式 + 自动监控调度 | | 📡 [`amazon-daily-market-radar/`](amazon-daily-market-radar/) | 自动化日常监控 — 价格变化、新竞品、BSR 波动、评论飙升 | 你的 ASIN(1-10) + 关键词 | 分级告警(RED/YELLOW/GREEN)、KPI 仪表盘、行动建议 | 区分持续趋势 vs 单日波动 | | ✅ [`amazon-listing-audit-pro/`](amazon-listing-audit-pro/) | 8 维度 Listing 健康检查 + 优化建议 | 你的 ASIN + 关键词 | 总分(X/100, A-F)、8 维度评分卡、关键词差距、修改清单 | 基于高频评论语言的改写建议 | | 💰 [`amazon-pricing-command-center/`](amazon-pricing-command-center/) | 数据驱动定价信号 — RAISE/HOLD/LOWER | 一个或多个 ASIN | 价格信号、价格带热力图、竞品价格地图、BuyBox 分析 | 只需 ASIN 不需关键词 | | 💬 [`amazon-review-intelligence-extractor/`](amazon-review-intelligence-extractor/) | 从 10 亿+评论中提取消费者洞察，11 个分析维度 | 单个/多个 ASIN 或品类关键词 | 痛点、购买因素、用户画像、差异化路线图 | 省 95% token + 11 维度 | | 🌐 [`web-extract/`](web-extract/) | 从公开网页和搜索结果提取结构化数据 | URL、搜索词或网站 | 结构化 JSON 或网页内容 | 支持渲染网页和限定范围的网站爬取 | `amazon-market-analysis` 是统一市场 Skill。原 `amazon-market-entry-analyzer`、`amazon-market-trend-scanner` 和 `amazon-opportunity-discoverer` 目录仅保留为下线源码；其入口文件已改名为 `RETIRED.md`，不会被 Skill 安装器或发布器发现。 ## 快速开始 ### 1. 安装技能包 ```bash npx skills add SerendipityOneInc/ZooData-Skills ``` 安装时会提示选择技能： **🏗️ 基础层：** - **ZooData** — 36 个 Amazon 商品与关键词 Intelligence API 接口 - **Amazon Analysis** — 13 种选品模式，市场验证，竞品情报 - **Amazon Keyword Intelligence** — 关键词拓展、关键词价值分析、商品流量健康诊断 - **Amazon Market Analysis** — 市场发现、进入评估与趋势追踪 **⚡ 专项层：** - **Amazon Competitor Intelligence Monitor** — 双模式竞品情报与三级告警 - **Amazon Daily Market Radar** — 每日市场脉搏与异常检测 - **Amazon Listing Audit Pro** — 8 维度 Listing 健康检查与优化 - **Amazon Pricing Command Center** — 数据驱动定价信号，RAISE/HOLD/LOWER - **Amazon Review Intelligence Extractor** — 10 亿+评论消费者洞察，11 个分析维度 - **Web Extract** — 公开网页结构化数据提取 也可以手动克隆： ```bash git clone https://github.com/SerendipityOneInc/ZooData-Skills.git ``` ### 2. 设置 API Key ```bash export ZOODATA_API_KEY='hms_live_xxx' # 在 zoodata.ai/en/api-keys 免费获取 ``` > 🎁 **免费额度**：注册即送 1,000 credits，1 credit = 1 次 API 调用，无需信用卡。 ### 3. 试一试 让你的 AI Agent 试试： > *"分析一下美国亚马逊上 50 美元以下无线耳机的竞争格局"* 或者直接用命令行： ```bash python amazon-analysis/scripts/zoodata.py products --keyword "wireless earbuds" --mode fast-movers ``` ## API 接口 **Base URL：** `https://api.zoodata.ai/openapi/v2` **认证方式：** `Authorization: Bearer $ZOODATA_API_KEY` **请求方法：** 所有接口均使用 `POST`，请求体为 JSON | 接口 | 说明 | 使用场景 | |------|------|----------| | 🔍 `products/search` | 商品搜索，20+ 筛选条件（CLI 另提供 13 种预设模式） | *"找 80 美元以下、4 星以上的跑步鞋"* | | 📊 `markets/search` | 类目发现与指定类目的市场概览——规模、集中度与 Top 100 定价 | *"瑜伽垫市场竞争激烈吗？"* | | 🧩 `markets/profile` | SPU 概况及独立分布、集中度接口 | *"销售额集中在哪些价格带？"* | | 📅 `markets/history` | 类目市场的月末历史快照 | *"这个类目近几个月如何变化？"* | | 🏷️ `products/competitor-lookup` | 按关键词、品牌或 ASIN 发现竞品 | *"这个细分类目的头部卖家有哪些？"* | | ⚡ `realtime/product` | 实时商品详情——评论、功能、变体 | *"查一下 ASIN B0D5CRV4KL 的最新信息"* | | 💬 `reviews/analysis` | AI 驱动的评论洞察——情感分析、痛点提取 | *"消费者对这个产品的好评和差评分别集中在哪里？"* | | 📁 `categories` | 亚马逊类目树导航 | *"看看 Electronics 下面有哪些子类目"* | | 📈 `products/price-band-overview` | 价格带概览与最佳机会带 | *"瑜伽垫最适合的价格区间是哪个？"* | | 📊 `products/price-band-detail` | 5 档价格带详细分布分析 | *"无线耳机各价格带的详细数据"* | | 🏢 `products/brand-overview` | 头部品牌集中度指标（CR10） | *"这个类目品牌集中度如何？"* | | 🏷️ `products/brand-detail` | 各品牌拆解与头部商品 | *"哪些品牌占据了这个类目？"* | | 📅 `products/history` | ASIN 历史每日快照 | *"查看这个 ASIN 的价格和 BSR 历史"* | ## 13 种选品模式 技能 CLI（`zoodata.py --mode`）提供 13 种预设模式，覆盖不同的选品策略。模式在客户端展开为真实筛选字段（`monthlySalesMin`、`salesGrowthRateMin` 等）——`mode` **不是** API 参数，直接发给 `/openapi/v2/products/search` 会返回 422： | 模式 | 策略 | 适用人群 | |------|------|----------| | `fast-movers` | 高销售速率 | 追求快速出单 | | `emerging` | 上升趋势，低饱和度 | 抢占先机 | | `long-tail` | 长尾关键词，稳定需求 | 追求持续收益 | | `underserved` | 高需求，卖家少 | 市场空白 | | `new-release` | 最近上架的商品 | 追踪趋势 | | `fbm-friendly` | 适合自发货 | 低投入起步 | | `low-price` | 低价商品 | 走量策略 | | `single-variant` | 简单 Listing，无变体 | 方便管理 | | `high-demand-low-barrier` | 高销量，低评论门槛 | 可规模化入场 | | `broad-catalog` | 宽品类范围分析 | 类目全景 | | `selective-catalog` | 精选高质量商品 | 精品路线 | | `speculative` | 高风险高回报机会 | 激进策略 | | `top-bsr` | BSR 排行榜头部 | 研究头部玩家 | ## 项目结构 ``` ├── zoodata/ # 数据层技能（轻量版） │ ├── SKILL.md # 36 个接口，快速入门 │ └── references/ │ └── openapi-reference.md # API 字段参考 │ ├── amazon-analysis/ # 深度分析技能 │ ├── SKILL.md # 意图路由，工作流，评估标准 │ ├── references/ │ │ ├── reference.md # 完整 API 参考 │ │ ├── execution-guide.md # 分步执行手册 │ │ ├── scenarios-composite.md # 综合推荐 │ │ ├── scenarios-eval.md # 商品评估、风险分析、评论 │ │ ├── scenarios-pricing.md # 定价策略 │ │ ├── scenarios-ops.md # 市场监控、预警 │ │ ├── scenarios-expand.md # 扩展、趋势 │ │ └── scenarios-listing.md # Listing 撰写与优化 │ └── scripts/ │ └── zoodata.py # CLI 工具 — 8 个子命令，13 种预设模式 │ ├── amazon-keyword-traffic-analysis/ # 关键词 intelligence 与流量分析 │ ├── SKILL.md │ ├── README.md │ └── references/ │ ├── reference.md # 关键词接口与字段参考 │ ├── execution-guide.md # 执行与监控规则 │ ├── scenarios-expand.md # 关键词拓词 │ ├── scenarios-keyword-analysis.md # 关键词价值与趋势分析 │ └── scenarios-product-traffic-analysis.md # 商品流量健康分析 │ ├── amazon-competitor-intelligence-monitor/ # 竞品情报监控 │ ├── SKILL.md │ ├── references/ │ │ └── reference.md │ └── scripts/ │ └── zoodata.py │ ├── amazon-daily-market-radar/ # 每日市场脉搏与异常检测 │ ├── SKILL.md │ ├── references/ │ │ └── reference.md │ └── scripts/ │ └── zoodata.py │ ├── amazon-listing-audit-pro/ # Listing 质量审计与优化 │ ├── SKILL.md │ ├── references/ │ │ └── reference.md │ └── scripts/ │ └── zoodata.py │ ├── amazon-market-analysis/ # 市场发现、进入评估与趋势追踪 │ ├── SKILL.md │ ├── references/ │ │ └── reference.md │ └── scripts/ │ └── zoodata.py │ ├── amazon-pricing-command-center/ # 定价策略与竞争信号 │ ├── SKILL.md │ ├── references/ │ │ └── reference.md │ └── scripts/ │ └── zoodata.py │ ├── amazon-review-intelligence-extractor/ # 评论智能分析与洞察提取 │ ├── SKILL.md │ ├── references/ │ │ └── reference.md │ └── scripts/ │ └── zoodata.py │ ├── web-extract/ # 公开网页结构化提取 │ ├── SKILL.md │ └── scripts/ │ └── webtools.py │ ├── scoring-methodology.md # 统一质量评分框架 ├── CHANGELOG.md └── README.md ``` ## 环境要求 - Python 3.8+（仅依赖标准库，零 pip 依赖） - ZooData API Key（[免费获取](https://zoodata.ai/en/api-keys)） ## 参与贡献 欢迎贡献！请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 了解贡献指南。 ## 社区 - 💬 [Discord](https://discord.gg/YfDFU9BDp5) — 聊天、提问、分享你在做的东西 - 🐛 [Issues](https://github.com/SerendipityOneInc/ZooData-Skills/issues) — Bug 反馈和功能建议 - 📖 [API 文档](https://zoodata.ai) — 完整 API 文档 - 📱 企业微信交流群 — 扫码加入：