内容
<p align="right">
<a href="README.md">English</a> | <a href="README.zh-CN.md">中文</a>
</p>
<p align="center">
<h1 align="center">ZooData 技能</h1>
</p>
<p align="center">
<b>为智能体构建的数据基础设施。</b><br/>
目前为亚马逊商业提供支持，拥有 2 亿+ 产品，10 亿+ 评论和实时信号。
</p>
<p align="center">
<a href="https://github.com/SerendipityOneInc/ZooData-Skills/actions/workflows/test-zoodata.yml"><img src="https://github.com/SerendipityOneInc/ZooData-Skills/actions/workflows/test-zoodata.yml/badge.svg" alt="测试" /></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="许可证" /></a>
<a href="https://zoodata.ai"><img src="https://img.shields.io/badge/API-zoodata.ai-orange" alt="API" /></a>
<a href="https://discord.gg/YfDFU9BDp5"><img src="https://img.shields.io/badge/Discord-Join-7289da?logo=discord&logoColor=white" alt="Discord" /></a>
<a href="https://github.com/SerendipityOneInc/ZooData-Skills/stargazers"><img src="https://img.shields.io/github/stars/SerendipityOneInc/ZooData-Skills?style=social" alt="星标" /></a>
</p>
<p align="center">
<a href="https://zoodata.ai">官网</a> •
<a href="https://zoodata.ai/en/api-keys">获取 API 密钥</a> •
<a href="https://discord.gg/YfDFU9BDp5">Discord</a> •
<a href="#quick-start">快速开始</a> •
<a href="#api-endpoints">API 参考</a>
</p>
---
## 什么是 ZooData？
[ZooData](https://zoodata.ai) 是为智能体构建的数据基础设施。不是一个爬虫 API。不是一个人工仪表盘。一个为您的 AI 智能体提供直接访问亚马逊商业信号的数据层 — 2 亿+ 索引产品，2+ 年历史和 10 亿+ 预处理的评论。干净的 JSON，实时，智能体就绪。
## 技能概览
此仓库包含 **11 种智能体技能**，分为两个层级：
**🏗️ 基础层** — 数据访问和全频谱分析：
| 技能 | 功能 | 输入 | 输出 | 关键优势 |
|-------|-------------|-------|--------|---------------|
| 📦 [`zoodata/`](zoodata/) | 直接访问所有 11 个 API 端点 — 类别，市场，产品，竞争对手，实时，评论，价格带，品牌，历史 | 关键词，类别，ASIN 或品牌 | 原始 API 数据，字段映射和文档说明 | 完整的 API 参考 — 其他技能都基于此构建 |
| 🎯 [`amazon-analysis/`](amazon-analysis/) | 13 种内置选择模式 + 市场研究，竞争对手分析，ASIN 评估，定价，类别研究 | 关键词/类别/ASIN + 意图 | 分析结果，顶级产品，ASIN 深入分析，带有置信度标签的洞察 | 复合命令（`report`，`opportunity`）一键运行多端点管道 |
| 🔎 [`amazon-keywords/`](amazon-keywords/) | 基于 6 个关键词端点的关键词智能工作流 | 种子关键词，目标关键词，ASIN 或 ASIN + 关键词 | 扩展层级，单一关键词裁决，反向 ASIN 流量术语，异常解释 | 关键词扩展，反向 ASIN 和关键词监控的专用流程 |
**⚡ 专业技能** — 为特定工作流而构建：
| 技能 | 功能 | 输入 | 输出 | 关键优势 |
|-------|-------------|-------|--------|---------------|
| ⚔️ [`amazon-competitor-intelligence-monitor/`](amazon-competitor-intelligence-monitor/) | 深入竞争对手情报 — 全扫描或快速检查，带有分级警报 | 关键词或 ASIN（s），可选您的 ASIN + 竞争对手 ASIN | 竞争对手矩阵，品牌排名，价格地图，30 天趋势，分数（1-100），分级警报 | 双模式（完整 ~28-35 积分，快速 ~5-10）带有三级警报系统 |
| 📡 [`amazon-daily-market-radar/`](amazon-daily-market-radar/) | 自动每日监控 — 价格变化，新竞争对手，BSR 变动，评论激增 | 您的 ASIN（1-10）+ 关键词 | 红/黄/绿警报，KPI 仪表盘，竞争对手变动，行动项目 | 设置后忘记，带有信号验证（7+ 天趋势 vs 单日激增） |
| ✅ [`amazon-listing-audit-pro/`](amazon-listing-audit-pro/) | 8 维列表健康检查，带有优化建议 | 您的 ASIN + 关键词 | 分数（X/100，A-F），8 维记分卡，关键词缺口，优先级修复列表 | 使用高频评论语言的可行重写；批量审计支持 |
| 🚪 [`amazon-market-entry-analyzer/`](amazon-market-entry-analyzer/) | 一键市场可行性 — 发现子市场，评分（1-100），提供 GO/CAUTION/AVOID | 关键词或类别路径 | 子市场景观，裁决，市场概览，品牌景观，进入策略 | 自动子市场发现，带有双级 CR10 检查 |
| 📈 [`amazon-market-trend-scanner/`](amazon-market-trend-scanner/) | 类别景观扫描 — 趋势子类，新兴市场，市场变化 | 1+ 类别路径或关键词 | 趋势仪表盘，热门类别 TOP 5，新进入者扫描，风险警报 | 跨所有子类别的类别级趋势分析 |
| 💎 [`amazon-opportunity-discoverer/`](amazon-opportunity-discoverer/) | 配置驱动的机会扫描器 — 自动选择策略，实时数据验证，7 维评分 | 预算 + 经验水平 + 关键词/类别 | 前 10 个机会（S/A/B/C），详细的前 3 个分析，风险警报 | 配置驱动的策略自动选择 + 快速扫描（~10 积分） |
| 💰 [`amazon-pricing-command-center/`](amazon-pricing-command-center/) | 数据驱动的定价信号 — 自动检测叶类别，分析定价景观 | 一个或多个 ASIN | 提高/保持/降低信号，价格带热图，竞争对手价格地图，BuyBox 分析 | 仅 ASIN 输入（无需关键词），销售/竞争比率 |
| 💬 [`amazon-review-intelligence-extractor/`](amazon-review-intelligence-extractor/) | 来自 10 亿+ 预分析评论的深入消费者洞察 — 11 维 | 单个 ASIN，多个 ASIN 或类别关键词 | 痛点，购买因素，用户配置文件，使用模式，差异化路线图 | 10 亿+ 预分析评论（95% token 节省），11 维 |
## 快速开始
### 1. 安装技能
```bash
npx skills add SerendipityOneInc/ZooData-Skills
```
您将被提示选择要安装的技能：
**🏗️ 基础层：**
- **ZooData — 亚马逊商业数据，11 个端点**
- **亚马逊分析 — 全频谱研究和卖家情报**
- **亚马逊关键词情报 — 扩展，反向 ASIN 和监控**
**⚡ 专业技能：**
- **亚马逊竞争对手情报监控器** — 双模式竞争情报，带有分级警报
- **亚马逊每日市场雷达 — 自动监控和警报**
- **亚马逊列表审计专业版 — 8 维健康检查**
- **亚马逊市场进入分析器 — GO/CAUTION/AVOID 裁决**
- **亚马逊市场趋势扫描器 — 每日类别雷达**
- **亚马逊机会发现者 — 市场扫描和评分**
- **亚马逊定价指挥中心 — RAISE/HOLD/LOWER 信号**
- **亚马逊评论情报提取器 — 来自 10 亿+ 评论的消费者洞察**
或手动克隆：
```bash
git clone https://github.com/SerendipityOneInc/ZooData-Skills.git
```
### 2. 设置您的 API 密钥
```bash
export ZOODATA_API_KEY='hms_live_xxx' # 在 zoodata.ai/en/api-keys 上免费获取
```
> 🎁 **免费层级**：注册即可获得 1,000 积分。1 积分 = 1 API 调用。无需信用卡。
### 3. 试用
询问您的 AI 智能体：
> *"分析亚马逊美国市场上低于 50 美元的无线耳塞的竞争格局"*
或直接使用 CLI：
```bash
python amazon-analysis/scripts/zoodata.py products --keyword "wireless earbuds" --mode competitive_landscape
```
## API 端点
**基准 URL：** `https://api.zoodata.ai/openapi/v2`
**身份验证：** `Authorization: Bearer $ZOODATA_API_KEY`
**方法：** 所有端点都使用带有 JSON 正文的 `POST`
| 端点 | 描述 | 示例用例 |
|----------|-------------|-----------------|
| 🔍 `products/search` | 产品搜索，13 种预设模式，20+ 过滤器 | *"查找价格低于 80 美元且评分 4+ 的跑鞋"* |
| 📊 `markets/search` | 市场级指标 — 集中度，品牌份额，定价 | *"瑜伽垫市场竞争有多激烈？"* |
| 🏷️ `products/competitors` | 按关键词，品牌或 ASIN 发现竞争对手 | *"这个细分市场的主要卖家是谁？"* |
| ⚡ `realtime/product` | 实时产品详情 — 评论，功能，变体 | *"获取 ASIN B0D5CRV4KL 的当前详情"* |
| 💬 `reviews/analysis` | AI 驱动的评论洞察 — 情绪，痛点 | *"客户喜欢/讨厌该产品的什么？"* |
| 📁 `categories` | 亚马逊类别树导航 | *"显示电子产品下的子类别"* |
| 📈 `products/price-band-overview` | 价格带摘要，带有最佳机会带 | *"瑜伽垫的最佳价格范围是什么？"* |
| 📊 `products/price-band-detail` | 完整的 5 带价格分布分析 | *"显示无线耳塞的详细价格带分解"* |
| 🏢 `products/brand-overview` | 顶级品牌集中度指标（CR10） | *"品牌格局有多集中？"* |
| 🏷️ `products/brand-detail` | 按品牌分类，带有顶级产品 | *"哪些品牌主导该类别？"* |
| 📅 `products/history` | ASIN 的历史每日快照 | *"显示该 ASIN 的价格和 BSR 历史"* |
## 13 种产品搜索模式
`products/search` 端点支持 13 种预设模式，用于不同的研究策略：
| 模式 | 策略 | 目标 |
|------|----------|--------|
| `fast-movers` | 高销售速度 | 快速收入 |
| `emerging` | 上升趋势，低饱和度 | 早期进入者 |
| `long-tail` | 细分关键词，稳定需求 | 可持续收入 |
| `underserved` | 高需求，少量卖家 | 市场空白 |
| `new-release` | 最近发布的产品 | 趋势商品 |
| `fbm-friendly` | 适合商家履约 | 低投资启动 |
| `low-price` | 经济实惠的产品 | 批量策略 |
| `single-variant` | 简单的列表，无变体 | 轻松管理 |
| `high-demand-low-barrier` | 高销量，低评论门槛 | 可扩展进入 |
| `broad-catalog` | 宽产品范围分析 | 类别概览 |
| `selective-catalog` | 精选的高质量产品 | 高端选择 |
| `speculative` | 高风险，高回报机会 | 激进策略 |
| `top-bsr` | 最佳卖家排名领导者 | 市场领导者 |
## 项目结构
```
├── zoodata/ # 数据层技能（轻量级）
│ ├── SKILL.md # 11 个端点，快速开始
│ └── 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 # 列表编写，优化
│ └── scripts/
│ └── zoodata.py # CLI — 8 个子命令，13 种预设模式
│
├── amazon-keywords/ # 关键词情报和流量分析
│ ├── SKILL.md
│ ├── README.md
│ └── references/
│ ├── reference.md # 关键词端点参考
│ ├── execution-guide.md # 执行和监控规则
│ ├── scenarios-expand.md # 关键词扩展
│ ├── scenarios-keyword-analysis.md # 单关键词评估
│ ├── scenarios-reverse-asin.md # 反向 ASIN 分析
│ └── scenarios-keyword-traffic-diagnosis.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/ # 列表质量审计和优化
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-market-entry-analyzer/ # 市场可行性评估
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-opportunity-discoverer/ # 市场和机会识别
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-market-trend-scanner/ # 类别景观扫描和趋势发现
│ ├── 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
│
├── scoring-methodology.md # 统一质量评分框架
├── CHANGELOG.md
└── README.md
```
## 要求
- Python 3.8+（仅标准库，无 pip 依赖）
- ZooData API 密钥（[免费获取](https://zoodata.ai/en/api-keys)）
## 贡献
我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
## 社区
- 💬 [Discord](https://discord.gg/YfDFU9BDp5) — 聊天，获取帮助，分享您的作品
- 🐛 [问题](https://github.com/SerendipityOneInc/ZooData-Skills/issues) — 错误报告和功能请求
- 📖 [API 文档](https://zoodata.ai) — 完整的 API 文档
## 许可证
[MIT](LICENSE) © [SerendipityOne Inc.](https://zoodata.ai)
连接信息
猜你喜欢
暂无推荐服务器