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

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

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

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

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

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

Навык	Что делает	Вход	Выход	Ключевое преимущество
⚔️ 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-pricing-command-center/	Сигналы ценообразования на основе данных — автоматически определяет листовую категорию, анализирует ценовой ландшафт	Один или несколько ASIN	Сигнал RAISE/HOLD/LOWER, тепловая карта ценовых диапазонов, карта цен конкурентов, анализ BuyBox	Только ASIN на входе (ключевое слово не нужно), коэффициент продаж/конкуренции
💬 amazon-review-intelligence-extractor/	Глубокие потребительские инсайты из 1B+ предварительно проанализированных отзывов по 11 измерениям	Один ASIN, несколько ASIN или ключевое слово категории	Болевые точки, факторы покупки, профили пользователей, паттерны использования, дорожная карта дифференциации	1B+ предварительно проанализированных отзывов (экономия 95% токенов), 11 измерений
🌐 web-extract/	Структурированное извлечение данных из публичных веб-страниц и результатов поиска	URL, поисковый запрос или сайт	Структурированный JSON или содержимое страницы	Обрабатывает отрисованные страницы и ограниченные обходы сайтов

amazon-market-analysis — это унифицированный рыночный навык. Бывшие каталоги amazon-market-entry-analyzer, amazon-market-trend-scanner и amazon-opportunity-discoverer сохранены только как устаревший исходный код; их точки входа названы RETIRED.md, поэтому установщики навыков и издатели их не обнаруживают.

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

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

npx skills add SerendipityOneInc/ZooData-Skills

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

🏗️ Базовые:

• ZooData — 25 Amazon Commerce и Keyword Intelligence эндпоинтов
• Amazon Analysis — исследование полного спектра и разведка продавца
• Amazon Keyword Intelligence — расширение, обратный ASIN и мониторинг
• Amazon Market Analysis — обнаружение, вход и изменения

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

• Amazon Competitor Intelligence Monitor — двухрежимная конкурентная разведка с многоуровневыми оповещениями
• Amazon Daily Market Radar — автоматический мониторинг и оповещения
• Amazon Listing Audit Pro — проверка здоровья по 8 измерениям
• Amazon Pricing Command Center — сигналы RAISE/HOLD/LOWER
• Amazon Review Intelligence Extractor — потребительские инсайты из 1B+ отзывов
• Web Extract — структурированное извлечение публичных веб-данных

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

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	Обнаружение категорий и точный снимок — размер, концентрация, ценообразование выбранных Top 100	"Насколько конкурентен рынок ковриков для йоги?"
🧩 markets/structure-profile	Распределения брендов, цен и другие распределения Top 100	"Какие ценовые диапазоны обеспечивают продажи?"
📅 markets/history	Доступные тренды категорийного рынка на конец месяца	"Как эта категория менялась по месяцам?"
🏷️ 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	Лидеры рынка

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

├── zoodata/                              # Data layer skill (lightweight)
│   ├── SKILL.md                            # 25 Amazon and keyword 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-analysis/               # Market discovery, entry assessment & change
│   ├── 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
│
├── web-extract/                          # Structured public web extraction
│   ├── SKILL.md
│   └── scripts/
│       └── webtools.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.