APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

La infraestructura de datos creada para agentes.
Actualmente impulsando el comercio de Amazon con más de 200 millones de productos, más de mil millones 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 creada para agentes. No es una API de scraping. No es un panel de control para humanos. Es una capa de datos diseñada específicamente para que tus agentes de IA accedan directamente a las señales del comercio de Amazon: más de 200 millones de productos indexados, más de 2 años de historial y más de mil millones de reseñas preprocesadas en información estructurada. JSON limpio, en tiempo real, listo para agentes.

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

Descripción general de las habilidades

Este repositorio contiene 11 habilidades para agentes organizadas en dos niveles:

🏗️ Fundamentos — acceso a datos y análisis de espectro completo:

Habilidad	Qué hace	Entrada	Salida	Ventaja clave
📦 zoodata/	Acceso directo a los 11 endpoints de la API: categorías, mercados, productos, competidores, tiempo real, reseñas, bandas de precios, marcas, historial	Palabra clave, categoría, ASIN o marca	Datos brutos de la API con mapeo de campos y documentación de peculiaridades	Referencia completa de la 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 del análisis, mejores productos, análisis profundos de ASIN, información etiquetada con nivel de confianza	Comandos compuestos (report, opportunity) ejecutan flujos de trabajo de múltiples endpoints de una sola vez
🔎 amazon-keyword-traffic-analysis/	Flujos de trabajo de inteligencia de palabras clave basados en 8 endpoints de tráfico de palabras clave	Palabra clave inicial, palabra clave objetivo, ASIN o ASIN + palabra clave	Niveles de expansión, veredictos de palabra clave única, términos de tráfico de ASIN inverso, explicaciones de anomalías	Flujos dedicados para expansión de palabras clave, ASIN inverso y monitoreo de tráfico de palabras clave

⚡ Especializadas — diseñadas 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 precio, 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 más de 7 días frente a picos de un solo día)
✅ amazon-listing-audit-pro/	Verificación de salud del listado en 8 dimensiones con recomendaciones de optimización	Tu ASIN + palabra clave	Puntuación (X/100, A-F), cuadro de mando de 8 dimensiones, brechas de palabras clave, lista de correcciones prioritarias	Reescrituras procesables utilizando lenguaje de reseñas de alta frecuencia; soporte para 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, descripció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, TOP 5 de Categorías en Auge, escaneo de nuevos entrantes, 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 perfiles: selecciona estrategias automáticamente, valida con datos en tiempo real, puntuación en 7 dimensiones	Presupuesto + nivel de experiencia + palabra clave/categoría	Top 10 oportunidades (S/A/B/C), análisis detallado de las 3 principales, alertas de riesgo	Selección automática de estrategias 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 de ASIN (no se necesita palabra clave), Ratio de Ventas/Competencia
💬 amazon-review-intelligence-extractor/	Información profunda del consumidor a partir de más de mil millones de reseñas preanalizadas en 11 dimensiones	Un solo ASIN, 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 mil millones de reseñas preanalizadas (ahorro del 95% en tokens), 11 dimensiones

Inicio rápido

1. Instalar las habilidades

npx skills add SerendipityOneInc/ZooData-Skills

Se te pedirá que selecciones qué habilidades instalar:

🏗️ Fundamentos:

• ZooData — Datos de Comercio de Amazon, 11 Endpoints
• Análisis de Amazon — Investigación de Espectro Completo e Inteligencia para Vendedores
• Inteligencia de Palabras Clave de Amazon — Expansión, ASIN Inverso y Monitoreo

⚡ Especializadas:

• Monitor de Inteligencia Competitiva de Amazon — Inteligencia competitiva de modo dual con alertas por niveles
• Radar Diario de Mercado de Amazon — Monitoreo y Alertas Automatizadas
• Auditoría Profesional de Listados de Amazon — Verificación de Salud en 8 Dimensiones
• Analizador de Entrada al Mercado de Amazon — Veredictos IR/PRECAUCIÓN/EVITAR
• Escáner de Tendencias de Mercado de Amazon — Radar Diario de Categorías
• Descubridor de Oportunidades de Amazon — Escáner y Puntuación de Nichos
• Centro de Comando de Precios de Amazon — Señales SUBIR/MANTENER/BAJAR
• Extractor de Inteligencia de Reseñas de Amazon — Información del Consumidor de más de Mil Millones de Reseñas

O clonar manualmente:

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

2. Configurar 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 registrarse. 1 crédito = 1 llamada a la API. No se requiere tarjeta de crédito.

3. Pruébalo

Pregúntale a tu agente de IA:

"Analiza el panorama competitivo de auriculares inalámbricos por menos de $50 en Amazon EE. UU."

O usa la CLI directamente:

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

Endpoints de la 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 13 modos predefinidos, más de 20 filtros	"Encuentra zapatillas para correr por menos de $80 con más de 4 estrellas"
📊 markets/search	Métricas a nivel de mercado: concentración, cuota 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 del producto en tiempo real: reseñas, características, variantes	"Obtén los detalles actuales del ASIN B0D5CRV4KL"
💬 reviews/analysis	Información de reseñas impulsada por IA: sentimiento, puntos de dolor	"¿Qué es lo que más y menos gusta a los clientes de este producto?"
📁 categories	Navegación por el árbol de categorías de Amazon	"Muestra las subcategorías dentro 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 las principales marcas (CR10)	"¿Qué tan concentrado está el panorama de marcas?"
🏷️ products/brand-detail	Desglose por marca con los mejores productos	"¿Qué marcas dominan esta categoría?"
📅 products/history	Instantáneas diarias históricas para ASINs	"Muestra el historial de precios y BSR de este ASIN"

13 modos de búsqueda de productos

El endpoint products/search admite 13 modos predefinidos para diferentes estrategias de investigación:

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 estable	Ingresos sostenibles
underserved	Alta demanda, pocos vendedores	Brechas de mercado
new-release	Productos lanzados recientemente	Artículos de tendencia
fbm-friendly	Adecuado para logística del vendedor	Inicio de baja inversión
low-price	Productos económicos	Estrategia de volumen
single-variant	Listados simples, sin variantes	Gestión sencilla
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 y alta recompensa	Estrategia agresiva
top-bsr	Líderes del ranking de Best Seller	Líderes del mercado

Estructura del proyecto

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

Requisitos

• Python 3.8+ (solo biblioteca estándar, cero dependencias de pip)
• Clave API de ZooData (consigue 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
• 📖 Documentación de la API — Documentación completa de la API

Licencia

MIT © SerendipityOne Inc.