APIClaw Skills
APIClaw — это инфраструктура данных, созданная специально для AI-агентов. В отличие от обычных парсинговых API или дашбордов, APIClaw предоставляет структурированный доступ к коммерческим сигналам Amazon: более 200 миллионов товаров, 1+ миллиард отзывов, два года истории и актуальные данные в реальном времени. Всё возвращается в чистом JSON, готовом для обработки агентом.
Репозиторий содержит 10 готовых навыков (skills), разделённых на два уровня: Foundation (базовый доступ к данным) и Specialized (специализированные сценарии).
Установка
Самый простой способ — использовать менеджер навыков:
npx skills add SerendipityOneInc/APIClaw-Skills
Вас попросят выбрать, какие навыки установить. Можно установить все сразу или только нужные.
Если предпочитаете ручную установку:
git clone https://github.com/SerendipityOneInc/APIClaw-Skills.git
Настройка
Зарегистрируйтесь на apiclaw.io и получите бесплатный ключ (1000 кредитов, без привязки карты). Затем укажите его в окружении:
export APICLAW_API_KEY='hms_live_xxx'
Быстрый старт
После установки и настройки ключа можно сразу обращаться к своему AI-агенту, например:
«Проанализируй конкурентную среду для беспроводных наушников до $50 на Amazon US»
Или используйте CLI напрямую:
python amazon-analysis/scripts/apiclaw.py products --keyword "wireless earbuds" --mode competitive_landscape
Навыки (Skills)
Foundation
- apiclaw/ — прямой доступ ко всем 11 конечным точкам API. Базовый слой, на котором строятся остальные навыки.
- amazon-analysis/ — универсальный анализ Amazon: 13 встроенных режимов поиска, исследование рынка, конкурентов, оценка ASIN, ценообразование и подбор товаров.
Specialized
- amazon-competitor-intelligence-monitor/ — глубокий мониторинг конкурентов: полное сканирование или быстрая проверка с трехуровневой системой оповещений (Full ~28-35 кредитов, Quick ~5-10).
- amazon-daily-market-radar/ — автоматическое ежедневное отслеживание: изменения цен, появление новых конкурентов, движение BSR, всплески отзывов. Работает по принципу «установил и забыл».
- amazon-listing-audit-pro/ — проверка качества листинга по 8 измерениям с рекомендациями по оптимизации. Оценка от A до F, приоритетный список исправлений.
- amazon-market-entry-analyzer/ — оценка привлекательности рынка одним кликом: обнаруживает суб-рынки, выдаёт вердикт GO/CAUTION/AVOID и стратегию входа.
- amazon-market-trend-scanner/ — сканирование категорий: трендовые подкатегории, новые ниши, риски. Анализирует все подкатегории сразу.
- amazon-opportunity-discoverer/ — поиск возможностей с учётом профиля (бюджет, опыт). Автоматически подбирает стратегию и оценивает по 7 критериям.
- amazon-pricing-command-center/ — рекомендации по ценообразованию: RAISE/HOLD/LOWER, тепловая карта цен, анализ BuyBox. Достаточно указать ASIN, ключевое слово не нужно.
- amazon-review-intelligence-extractor/ — извлечение потребительских инсайтов из 1+ миллиарда отзывов по 11 измерениям (боли, факторы покупки, профили пользователей и т.д.). Экономит до 95% токенов за счёт предварительной обработки.
API Endpoints
Базовый URL: https://api.apiclaw.io/openapi/v2
Аутентификация: заголовок Authorization: Bearer $APICLAW_API_KEY
Все запросы — POST с JSON-телом.
| Endpoint |
Описание |
products/search |
Поиск товаров с 13 режимами и 20+ фильтрами |
markets/search |
Метрики рынка: концентрация, доли брендов, цены |
products/competitors |
Поиск конкурентов по ключевому слову, бренду или ASIN |
realtime/product |
Детальная информация о товаре в реальном времени |
reviews/analysis |
AI-анализ отзывов: тональность, боли, пожелания |
categories |
Древовидная навигация по категориям Amazon |
products/price-band-overview |
Сводка по ценовым сегментам с лучшим сегментом |
products/price-band-detail |
Полное распределение по 5 ценовым группам |
products/brand-overview |
Концентрация брендов (CR10) |
products/brand-detail |
Детализация по каждому бренду с топ-товарами |
products/history |
Исторические ежедневные снимки ASIN (цена, BSR) |
Требования
- Python 3.8+ (только стандартная библиотека, сторонних зависимостей нет)
- Ключ API (бесплатно на apiclaw.io)
Структура репозитория
Каждый навык находится в отдельной директории и содержит:
SKILL.md — описание, инструкции и примеры.
references/ — справочные файлы (API reference, гайды).
scripts/ — CLI-скрипты (apiclaw.py).
Корневая директория также включает scoring-methodology.md — единую методику оценки качества, и CHANGELOG.md.
Сообщество и лицензия
Проект поддерживается компанией SerendipityOne Inc.
Комментарии
Комментариев пока нет. Будьте первым.