APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

Инфраструктура данных, созданная для агентов.
В настоящее время обеспечивает работу Amazon commerce с 200M+ товарами, 1B+ отзывами и сигналами в реальном времени.

Веб-сайт • Получить API-ключ • Discord • Быстрый старт • Справочник API

---

Что такое ZooData?

ZooData — это инфраструктура данных, созданная для агентов. Не скрейпинг-API. Не панель для людей. Специализированный слой данных, который дает вашим AI-агентам прямой доступ к сигналам Amazon commerce — 200M+ индексированных товаров, более 2 лет истории и 1B+ отзывов, предварительно обработанных в структурированные инсайты. Чистый JSON, реальное время, готово для агентов.

https://github.com/user-attachments/assets/305a161b-7a53-49b8-afdc-4469a4fbf361

Обзор навыков

Этот репозиторий содержит 11 агентских навыков, организованных в два уровня:

🏗️ Фундаментальные — доступ к данным и анализ полного спектра:

Навык	Что делает	Вход	Выход	Ключевое преимущество
📦 zoodata/	Прямой доступ ко всем 22 конечным точкам API — 12 коммерческих конечных точек плюс 10 конечных точек интеллекта по ключевым словам	Ключевое слово, категория, ASIN или бренд	Сырые данные API с сопоставлением полей и документацией по особенностям	Полный справочник API — каждый другой навык строится на этом
🎯 amazon-analysis/	13 встроенных режимов выбора + исследование рынка, анализ конкурентов, оценка ASIN, ценообразование, исследование категорий	Ключевое слово/категория/ASIN + намерение	Результаты анализа, лучшие товары, глубокие погружения в ASIN, инсайты с тегами уверенности	Составные команды (report, opportunity) запускают многоконечные конвейеры одним выстрелом
🔎 amazon-keyword-traffic-analysis/	Рабочие процессы ценности ключевых слов и здоровья трафика товаров на основе 10 конечных точек интеллекта по ключевым словам	Исходное ключевое слово, целевое ключевое слово, ASIN или ASIN + ключевое слово	Уровни расширения, анализ ценности ключевых слов, структура трафика товара, тренды и диагностика здоровья	Выделенные потоки для расширения ключевых слов, анализа ключевых слов и анализа трафика товаров

⚡ Специализированные — созданы для конкретных рабочих процессов:

Навык	Что делает	Вход	Выход	Ключевое преимущество
⚔️ amazon-competitor-intelligence-monitor/	Глубокая разведка конкурентов — полное сканирование или быстрая проверка с многоуровневыми оповещениями	Ключевое слово или ASIN(ы), опционально ваш ASIN + ASIN конкурентов	Матрица конкурентов, рейтинг брендов, карта цен, 30-дневные тренды, оценки (1-100), многоуровневые оповещения	Двойной режим (полный ~28-35 кредитов, быстрый ~5-10) с трехъярусной системой оповещений
📡 amazon-daily-market-radar/	Автоматический ежедневный мониторинг — изменения цен, новые конкуренты, движения BSR, всплески отзывов	Ваши ASIN (1-10) + ключевое слово	Оповещения RED/YELLOW/GREEN, панель KPI, движения конкурентов, пункты действий	Настрой и забудь с проверкой сигналов (тренды за 7+ дней против однодневных всплесков)
✅ amazon-listing-audit-pro/	Проверка здоровья листинга по 8 измерениям с рекомендациями по оптимизации	Ваш ASIN + ключевое слово	Оценка (X/100, A-F), карточка по 8 измерениям, пробелы в ключевых словах, приоритетный список исправлений	Действенные переписывания с использованием высокочастотного языка отзывов; поддержка массового аудита
🚪 amazon-market-entry-analyzer/	Проверка жизнеспособности рынка в один клик — обнаруживает суб-рынки, оценивает (1-100), выдает вердикты GO/CAUTION/AVOID	Ключевое слово или путь категории	Ландшафт суб-рынка, вердикт, обзор рынка, ландшафт брендов, стратегия входа	Автоматическое обнаружение суб-рынков с двухуровневой проверкой CR10
📈 amazon-market-trend-scanner/	Сканирование ландшафта категорий — трендовые субкатегории, новые ниши, сдвиги на рынке	1+ путей категорий или ключевых слов	Панель трендов, горячие категории TOP 5, сканирование новых участников, предупреждения о рисках	Анализ трендов на уровне категорий по ВСЕМ субкатегориям
💎 amazon-opportunity-discoverer/	Сканер возможностей на основе профиля — автоматически выбирает стратегии, проверяет данными в реальном времени, оценка по 7 измерениям	Бюджет + уровень опыта + ключевое слово/категория	Топ-10 возможностей (S/A/B/C), детальный анализ топ-3, предупреждения о рисках	Автоматический выбор стратегии на основе профиля + быстрое сканирование (~10 кредитов)
💰 amazon-pricing-command-center/	Сигналы ценообразования на основе данных — автоматически определяет листовую категорию, анализирует ценовой ландшафт	Один или несколько ASIN	Сигнал RAISE/HOLD/LOWER, тепловая карта ценовых диапазонов, карта цен конкурентов, анализ BuyBox	Только ввод ASIN (ключевое слово не требуется), соотношение продаж/конкуренции
💬 amazon-review-intelligence-extractor/	Глубокие потребительские инсайты из 1B+ предварительно проанализированных отзывов по 11 измерениям	Один ASIN, несколько ASIN или ключевое слово категории	Болевые точки, факторы покупки, профили пользователей, паттерны использования, дорожная карта дифференциации	1B+ предварительно проанализированных отзывов (экономия 95% токенов), 11 измерений

Быстрый старт

1. Установите навыки

npx skills add SerendipityOneInc/ZooData-Skills

Вам будет предложено выбрать, какие навыки установить:

🏗️ Фундаментальные:

• ZooData — Amazon Commerce Data, 11 Endpoints
• Amazon Analysis — Full-Spectrum Research & Seller Intelligence
• Amazon Keyword Intelligence — Expansion, Reverse ASIN & Monitoring

⚡ Специализированные:

• Amazon Competitor Intelligence Monitor — Двухрежимная конкурентная разведка с многоуровневыми оповещениями
• Amazon Daily Market Radar — Automated Monitoring & Alerts
• Amazon Listing Audit Pro — 8-Dimension Health Check
• Amazon Market Entry Analyzer — GO/CAUTION/AVOID Verdicts
• Amazon Market Trend Scanner — Daily Category Radar
• Amazon Opportunity Discoverer — Niche Scanner & Scoring
• Amazon Pricing Command Center — RAISE/HOLD/LOWER Signals
• Amazon Review Intelligence Extractor — Consumer Insights from 1B+ Reviews

Или клонируйте вручную:

git clone https://github.com/SerendipityOneInc/ZooData-Skills.git

2. Установите ваш API-ключ

export ZOODATA_API_KEY='hms_live_xxx'   # Get yours free at zoodata.ai/en/api-keys

🎁 Бесплатный тариф: 1,000 кредитов при регистрации. 1 кредит = 1 вызов API. Кредитная карта не требуется.

3. Попробуйте

Спросите вашего AI-агента:

"Проанализируй конкурентный ландшафт для беспроводных наушников дешевле $50 на Amazon US"

Или используйте CLI напрямую:

python amazon-analysis/scripts/zoodata.py products --keyword "wireless earbuds" --mode fast-movers

Конечные точки API

Базовый URL: https://api.zoodata.ai/openapi/v2 Аутентификация: Authorization: Bearer $ZOODATA_API_KEY Метод: Все конечные точки используют POST с JSON-телом

Конечная точка	Описание	Пример использования
🔍 products/search	Поиск товаров с 20+ фильтрами (13 предустановленных режимов через CLI)	"Найди беговые кроссовки дешевле $80 с рейтингом 4+ звезды"
📊 markets/search	Метрики на уровне рынка — концентрация, доля брендов, ценообразование	"Насколько конкурентен рынок ковриков для йоги?"
🏷️ products/competitors	Обнаружение конкурентов по ключевому слову, бренду или ASIN	"Кто лучшие продавцы в этой нише?"
⚡ realtime/product	Детали товара в реальном времени — отзывы, характеристики, варианты	"Получи текущие детали для ASIN B0D5CRV4KL"
💬 reviews/analysis	Инсайты из отзывов на основе AI — тональность, болевые точки	"Что клиенты любят/ненавидят в этом товаре?"
📁 categories	Навигация по дереву категорий Amazon	"Покажи субкатегории в разделе Electronics"
📈 products/price-band-overview	Сводка ценовых диапазонов с лучшим диапазоном возможностей	"Какой лучший ценовой диапазон для ковриков для йоги?"
📊 products/price-band-detail	Полный анализ распределения цен по 5 диапазонам	"Покажи детальную разбивку ценовых диапазонов для беспроводных наушников"
🏢 products/brand-overview	Метрики концентрации топ-брендов (CR10)	"Насколько концентрирован ландшафт брендов?"
🏷️ products/brand-detail	Разбивка по брендам с лучшими товарами	"Какие бренды доминируют в этой категории?"
📅 products/history	Исторические ежедневные снимки для ASIN	"Покажи историю цены и BSR для этого ASIN"

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	Простые листинги, без вариантов	Легкое управление
high-demand-low-barrier	Высокие продажи, низкий барьер отзывов	Масштабируемый вход
broad-catalog	Анализ широкого ассортимента товаров	Обзор категории
selective-catalog	Курируемые высококачественные подборки	Премиальный выбор
speculative	Возможности с высоким риском и высокой наградой	Агрессивная стратегия
top-bsr	Лидеры рейтинга Best Seller Rank	Лидеры рынка

Структура проекта

├── zoodata/                              # Data layer skill (lightweight)
│   ├── SKILL.md                            # 22 endpoints, quick start
│   └── references/
│       └── openapi-reference.md            # API field reference
│
├── amazon-analysis/                      # Deep analysis skill
│   ├── SKILL.md                            # Intent routing, workflows, evaluation criteria
│   ├── references/
│   │   ├── reference.md                    # Full API reference
│   │   ├── execution-guide.md              # Step-by-step execution playbook
│   │   ├── scenarios-composite.md          # Comprehensive recommendations
│   │   ├── scenarios-eval.md               # Product evaluation, risk, reviews
│   │   ├── scenarios-pricing.md            # Pricing strategy
│   │   ├── scenarios-ops.md                # Market monitoring, alerts
│   │   ├── scenarios-expand.md             # Expansion, trends
│   │   └── scenarios-listing.md            # Listing writing, optimization
│   └── scripts/
│       └── zoodata.py                      # CLI — 8 subcommands, 13 preset modes
│
├── amazon-keyword-traffic-analysis/      # Keyword intelligence & traffic analysis
│   ├── SKILL.md
│   ├── README.md
│   └── references/
│       ├── reference.md                    # Keyword endpoint reference
│       ├── execution-guide.md              # Execution and monitoring rules
│       ├── scenarios-expand.md             # Keyword expansion
│       ├── scenarios-keyword-analysis.md   # Keyword value and trend analysis
│       └── scenarios-product-traffic-analysis.md # Product traffic health analysis
│
├── amazon-competitor-intelligence-monitor/  # Competitor intelligence & monitoring
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-daily-market-radar/            # Daily market pulse & anomaly detection
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-listing-audit-pro/             # Listing quality audit & optimization
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-market-entry-analyzer/         # Market viability assessment
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-opportunity-discoverer/        # Niche & opportunity identification
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-market-trend-scanner/           # Category landscape scanning & trend discovery
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-pricing-command-center/        # Pricing strategy & competitive signals
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── amazon-review-intelligence-extractor/    # Review intelligence & insight extraction
│   ├── SKILL.md
│   ├── references/
│   │   └── reference.md
│   └── scripts/
│       └── zoodata.py
│
├── scoring-methodology.md                # Unified quality scoring framework
├── CHANGELOG.md
└── README.md

Требования

• Python 3.8+ (только стандартная библиотека, ноль pip-зависимостей)
• ZooData API-ключ (получите бесплатно)

Вклад

Мы приветствуем вклад! Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения рекомендаций.

Сообщество

• 💬 Discord — Общайтесь, получайте помощь, делитесь тем, что вы создаете
• 🐛 Issues — Отчеты об ошибках и запросы функций
• 📖 API Docs — Полная документация API

Лицензия

MIT © SerendipityOne Inc.