APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

La infraestructura de datos construida para agentes.
Actualmente impulsa el comercio de Amazon con más de 200M de productos, más de 1B de reseñas y señales en tiempo real.

Sitio web • Obtener clave API • Discord • Inicio rápido • Referencia de API

---

¿Qué es ZooData?

ZooData es la infraestructura de datos construida para agentes. No es una API de scraping. No es un panel para humanos. Es una capa de datos diseñada específicamente que da a tus agentes de IA acceso directo a las señales de comercio de Amazon — más de 200M de productos indexados, más de 2 años de historial y más de 1B de reseñas pre-procesadas en insights estructurados. JSON limpio, en tiempo real, listo para agentes.

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

Resumen de habilidades

Este repositorio contiene 11 habilidades de agente organizadas en dos niveles:

🏗️ Fundación — acceso a datos y análisis de espectro completo:

Habilidad	Qué hace	Entrada	Salida	Ventaja clave
📦 zoodata/	Acceso directo a los 22 endpoints de API — 12 endpoints de comercio más 10 endpoints de inteligencia de palabras clave	Palabra clave, categoría, ASIN o marca	Datos brutos de API con mapeo de campos y documentación de peculiaridades	Referencia completa de API — todas las demás habilidades se basan en esta
🎯 amazon-analysis/	13 modos de selección integrados + investigación de mercado, análisis de competidores, evaluación de ASIN, precios, investigación de categorías	Palabra clave/categoría/ASIN + intención	Hallazgos de análisis, productos principales, análisis profundos de ASIN, insights etiquetados con confianza	Comandos compuestos (report, opportunity) ejecutan pipelines multi-endpoint de una sola vez
🔎 amazon-keyword-traffic-analysis/	Flujos de trabajo de valor de palabras clave y salud de tráfico de productos basados en 10 endpoints de inteligencia de palabras clave	Palabra clave semilla, palabra clave objetivo, ASIN o ASIN + palabra clave	Niveles de expansión, análisis de valor de palabras clave, estructura de tráfico de productos, tendencias y diagnóstico de salud	Flujos dedicados para expansión de palabras clave, análisis de palabras clave y análisis de tráfico de productos

⚡ Especializado — diseñado para flujos de trabajo específicos:

Habilidad	Qué hace	Entrada	Salida	Ventaja clave
⚔️ amazon-competitor-intelligence-monitor/	Inteligencia profunda de competidores — Escaneo completo o Verificación rápida con alertas por niveles	Palabra clave o ASIN(s), opcionalmente tu ASIN + ASINs de competidores	Matriz de competidores, ranking de marcas, mapa de precios, tendencias de 30 días, puntuaciones (1-100), alertas por niveles	Modo dual (Completo ~28-35 créditos, Rápido ~5-10) con sistema de alertas de tres niveles
📡 amazon-daily-market-radar/	Monitoreo diario automatizado — cambios de precios, nuevos competidores, movimientos de BSR, picos de reseñas	Tus ASINs (1-10) + palabra clave	Alertas ROJO/AMARILLO/VERDE, panel de KPI, movimiento de competidores, elementos de acción	Configurar y olvidar con validación de señales (tendencias de 7+ días vs picos de un solo día)
✅ amazon-listing-audit-pro/	Verificación de salud de listado en 8 dimensiones con recomendaciones de optimización	Tu ASIN + palabra clave	Puntuación (X/100, A-F), tarjeta de puntuación de 8 dimensiones, brechas de palabras clave, lista de correcciones prioritarias	Reescrituras accionables usando lenguaje de reseñas de alta frecuencia; soporte de auditoría masiva
🚪 amazon-market-entry-analyzer/	Viabilidad de mercado con un clic — descubre submercados, puntúa (1-100), entrega veredictos IR/PRECAUCIÓN/EVITAR	Palabra clave o ruta de categoría	Panorama de submercados, veredicto, visión general del mercado, panorama de marcas, estrategia de entrada	Descubrimiento automático de submercados con verificación CR10 de doble nivel
📈 amazon-market-trend-scanner/	Escaneo del panorama de categorías — subcategorías en tendencia, nichos emergentes, cambios de mercado	1+ rutas de categoría o palabras clave	Panel de tendencias, Categorías populares TOP 5, escaneo de nuevos participantes, alertas de riesgo	Análisis de tendencias a nivel de categoría en TODAS las subcategorías
💎 amazon-opportunity-discoverer/	Escáner de oportunidades basado en perfil — selecciona estrategias automáticamente, valida con datos en tiempo real, puntuación de 7 dimensiones	Presupuesto + nivel de experiencia + palabra clave/categoría	Top 10 oportunidades (S/A/B/C), análisis detallado del top 3, alertas de riesgo	Auto-selección de estrategia basada en perfil + Escaneo rápido (~10 créditos)
💰 amazon-pricing-command-center/	Señales de precios basadas en datos — detecta automáticamente la categoría hoja, analiza el panorama de precios	Uno o más ASINs	Señal SUBIR/MANTENER/BAJAR, mapa de calor de bandas de precios, mapa de precios de competidores, análisis de BuyBox	Entrada solo con ASIN (sin necesidad de palabra clave), Ratio de Ventas/Competencia
💬 amazon-review-intelligence-extractor/	Insights profundos de consumidores a partir de más de 1B de reseñas pre-analizadas en 11 dimensiones	ASIN único, múltiples ASINs o palabra clave de categoría	Puntos de dolor, factores de compra, perfiles de usuario, patrones de uso, hoja de ruta de diferenciación	Más de 1B de reseñas pre-analizadas (95% de ahorro de tokens), 11 dimensiones

Inicio rápido

1. Instala las habilidades

npx skills add SerendipityOneInc/ZooData-Skills

Se te pedirá que selecciones qué habilidades instalar:

🏗️ Fundación:

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

⚡ Especializado:

• Amazon Competitor Intelligence Monitor — Inteligencia competitiva de modo dual con alertas por niveles
• Amazon Daily Market Radar — Monitoreo y alertas automatizados
• Amazon Listing Audit Pro — Verificación de salud en 8 dimensiones
• Amazon Market Entry Analyzer — Veredictos IR/PRECAUCIÓN/EVITAR
• Amazon Market Trend Scanner — Radar diario de categorías
• Amazon Opportunity Discoverer — Escáner y puntuación de nichos
• Amazon Pricing Command Center — Señales SUBIR/MANTENER/BAJAR
• Amazon Review Intelligence Extractor — Insights de consumidores de más de 1B de reseñas

O clona manualmente:

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

2. Configura tu clave API

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

🎁 Nivel gratuito: 1,000 créditos al registrarte. 1 crédito = 1 llamada API. No se requiere tarjeta de crédito.

3. Pruébalo

Pregunta a tu agente de IA:

"Analiza el panorama competitivo de los auriculares inalámbricos de menos de $50 en Amazon US"

O usa la CLI directamente:

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

Endpoints de API

URL base: https://api.zoodata.ai/openapi/v2 Autenticación: Authorization: Bearer $ZOODATA_API_KEY Método: Todos los endpoints usan POST con cuerpo JSON

Endpoint	Descripción	Caso de uso de ejemplo
🔍 products/search	Búsqueda de productos con más de 20 filtros (13 modos predefinidos vía CLI)	"Encuentra zapatillas para correr de menos de $80 con 4+ estrellas"
📊 markets/search	Métricas a nivel de mercado — concentración, participación de marca, precios	"¿Qué tan competitivo es el mercado de esterillas de yoga?"
🏷️ products/competitors	Descubrimiento de competidores por palabra clave, marca o ASIN	"¿Quiénes son los principales vendedores en este nicho?"
⚡ realtime/product	Detalles de producto en tiempo real — reseñas, características, variantes	"Obtén los detalles actuales del ASIN B0D5CRV4KL"
💬 reviews/analysis	Insights de reseñas impulsados por IA — sentimiento, puntos de dolor	"¿Qué aman/odian los clientes de este producto?"
📁 categories	Navegación del árbol de categorías de Amazon	"Muestra las subcategorías de Electrónica"
📈 products/price-band-overview	Resumen de bandas de precios con la mejor banda de oportunidad	"¿Cuál es el mejor rango de precios para esterillas de yoga?"
📊 products/price-band-detail	Análisis completo de distribución de precios en 5 bandas	"Muestra el desglose detallado de bandas de precios para auriculares inalámbricos"
🏢 products/brand-overview	Métricas de concentración de marcas principales (CR10)	"¿Qué tan concentrado está el panorama de marcas?"
🏷️ products/brand-detail	Desglose por marca con productos principales	"¿Qué marcas dominan esta categoría?"
📅 products/history	Instantáneas diarias históricas para ASINs	"Muestra el historial de precios y BSR para este ASIN"

13 Modos de búsqueda de productos

La CLI de la habilidad (zoodata.py --mode) proporciona 13 modos predefinidos para diferentes estrategias de investigación. Los modos se expanden en campos de filtro concretos (monthlySalesMin, salesGrowthRateMin, …) en el lado del cliente — mode no es un parámetro de API, y enviarlo a /openapi/v2/products/search devuelve 422:

Modo	Estrategia	Objetivo
fast-movers	Alta velocidad de ventas	Ingresos rápidos
emerging	Tendencias al alza, baja saturación	Primeros en moverse
long-tail	Palabras clave de nicho, demanda constante	Ingresos sostenibles
underserved	Alta demanda, pocos vendedores	Brechas de mercado
new-release	Productos lanzados recientemente	Artículos en tendencia
fbm-friendly	Adecuado para cumplimiento del vendedor	Inicio de baja inversión
low-price	Productos económicos	Estrategia de volumen
single-variant	Listados simples, sin variantes	Gestión fácil
high-demand-low-barrier	Altas ventas, baja barrera de reseñas	Entrada escalable
broad-catalog	Análisis de amplia gama de productos	Visión general de categoría
selective-catalog	Selecciones curadas de alta calidad	Selección premium
speculative	Oportunidades de alto riesgo, alta recompensa	Estrategia agresiva
top-bsr	Líderes de Best Seller Rank	Líderes del mercado

Estructura del proyecto

├── 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

Requisitos

• Python 3.8+ (solo stdlib, cero dependencias pip)
• Clave API de ZooData (obtén una gratis)

Contribuciones

¡Agradecemos las contribuciones! Consulta CONTRIBUTING.md para conocer las pautas.

Comunidad

• 💬 Discord — Chatea, obtén ayuda, comparte lo que estás construyendo
• 🐛 Issues — Informes de errores y solicitudes de funciones
• 📖 API Docs — Documentación completa de la API

Licencia

MIT © SerendipityOne Inc.