APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

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

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

---

Что такое ZooData?

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

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

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

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

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

Навык	Что делает	Входные данные	Выходные данные	Ключевое преимущество
📦 zoodata/	Прямой доступ ко всем 11 конечным точкам API — категории, рынки, товары, конкуренты, realtime, отзывы, ценовые диапазоны, бренды, история	Ключевое слово, категория, ASIN или бренд	Необработанные данные API с сопоставлением полей и документацией особенностей	Полный справочник API — на этом навыке строятся все остальные
🎯 amazon-analysis/	13 встроенных режимов выбора + исследование рынка, анализ конкурентов, оценка ASIN, ценообразование, исследование категорий	Ключевое слово/категория/ASIN + намерение	Результаты анализа, лучшие товары, углубленный анализ ASIN, инсайты с оценкой достоверности	Составные команды (report, opportunity) запускают конвейеры с несколькими конечными точками за один раз
🔎 amazon-keyword-traffic-analysis/	Рабочие процессы анализа ключевых слов, построенные на 8 конечных точках трафика ключевых слов	Исходное ключевое слово, целевое ключевое слово, ASIN или ASIN + ключевое слово	Уровни расширения, вердикты по отдельным ключевым словам, условия обратного трафика 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+ путей категорий или ключевых слов	Панель трендов, ТОП-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/	Глубокие потребительские инсайты из более чем 1 млрд предварительно проанализированных отзывов по 11 параметрам	Один ASIN, несколько ASIN или ключевое слово категории	Болевые точки, факторы покупки, профили пользователей, модели использования, дорожная карта дифференциации	Более 1 млрд предварительно проанализированных отзывов (экономия токенов 95%), 11 параметров

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

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

npx skills add SerendipityOneInc/ZooData-Skills

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

🏗️ Базовый:

• ZooData — данные коммерции Amazon, 11 конечных точек
• Amazon Analysis — полноспектральное исследование и аналитика для продавцов
• Amazon Keyword Intelligence — расширение, обратный ASIN и мониторинг

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

• Amazon Competitor Intelligence Monitor — двухрежимная конкурентная разведка с многоуровневыми оповещениями
• Amazon Daily Market Radar — автоматический мониторинг и оповещения
• Amazon Listing Audit Pro — проверка состояния по 8 параметрам
• Amazon Market Entry Analyzer — вердикты GO/CAUTION/AVOID
• Amazon Market Trend Scanner — ежедневный радар категорий
• Amazon Opportunity Discoverer — сканер ниш и оценка
• Amazon Pricing Command Center — сигналы RAISE/HOLD/LOWER
• Amazon Review Intelligence Extractor — потребительские инсайты из более чем 1 млрд отзывов

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

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

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

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

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

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

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

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 Метод: Все конечные точки используют POST с телом JSON

Конечная точка	Описание	Пример использования
🔍 products/search	Поиск товаров с 13 предустановленными режимами, 20+ фильтрами	"Найди кроссовки для бега до $80 с рейтингом 4+ звезды"
📊 markets/search	Метрики на уровне рынка — концентрация, доля бренда, ценообразование	"Насколько конкурентен рынок ковриков для йоги?"
🏷️ products/competitors	Поиск конкурентов по ключевому слову, бренду или ASIN	"Кто лидеры продаж в этой нише?"
⚡ realtime/product	Детали товара в реальном времени — отзывы, характеристики, варианты	"Получи текущие детали для ASIN B0D5CRV4KL"
💬 reviews/analysis	Инсайты отзывов на базе ИИ — тональность, болевые точки	"Что клиентам нравится/не нравится в этом товаре?"
📁 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 режимов поиска товаров

Конечная точка 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/                              # Data layer skill (lightweight)
│   ├── SKILL.md                            # 11 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   # Single-keyword evaluation
│       ├── scenarios-reverse-asin.md       # Reverse ASIN analysis
│       └── scenarios-keyword-traffic-diagnosis.md # Keyword traffic anomaly diagnosis
│
├── 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+ (только stdlib, никаких зависимостей pip)
• Ключ API ZooData (получить бесплатно)

Участие в разработке

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

Сообщество

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

Лицензия

MIT © SerendipityOne Inc.