APIClaw — Amazon Data API for AI Agents

Español | 中文

Habilidades de ZooData

La infraestructura de datos construida para agentes.
Actualmente impulsa el comercio de Amazon con más de 200 millones de productos, más de 1 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 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 brinda a tus agentes de IA acceso directo a las señales de comercio de Amazon: más de 200 millones de productos indexados, más de 2 años de historial y más de 1 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

Resumen de habilidades

Este repositorio contiene 10 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 25 endpoints de comercio de Amazon e inteligencia de palabras clave	Palabra clave, categoría, ASIN o marca	Datos API sin procesar 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, información etiquetada con confianza	Comandos compuestos (report, opportunity) ejecutan pipelines de múltiples endpoints en una sola operación
🔎 amazon-keyword-traffic-analysis/	Flujos de trabajo de valor de palabras clave y salud de tráfico de productos basados en 11 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
📊 amazon-market-analysis/	Descubre candidatos de mercado y productos, evalúa condiciones de entrada y rastrea cambios de categoría	Pregunta de mercado, categoría o breve oportunidad de producto	Lista corta observada, evaluación condicional de entrada o análisis de tendencias acotado	Una historia conectada con evidencia separada y límites de decisión del vendedor

⚡ 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 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 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-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/	Información profunda del consumidor a partir de más de 1 mil millones de reseñas preanalizadas en 11 dimensiones	ASIN único, múltiples ASINs o palabra clave de categoría	Puntos de dolor, factores de compra, perfiles de usuarios, patrones de uso, hoja de ruta de diferenciación	Más de 1 mil millones de reseñas preanalizadas (95% de ahorro de tokens), 11 dimensiones
🌐 web-extract/	Extracción de datos estructurados de páginas web públicas y resultados de búsqueda	URL, consulta de búsqueda o sitio	JSON estructurado o contenido de página	Maneja páginas renderizadas y rastreos de sitios acotados

amazon-market-analysis es la habilidad de mercado unificada. Los antiguos directorios amazon-market-entry-analyzer, amazon-market-trend-scanner y amazon-opportunity-discoverer se conservan solo como fuente retirada; sus puntos de entrada se llaman RETIRED.md, por lo que los instaladores y publicadores de habilidades no los descubren.

Inicio rápido

1. Instala las habilidades

npx skills add SerendipityOneInc/ZooData-Skills

Se te pedirá que selecciones qué habilidades instalar:

🏗️ Fundación:

• ZooData — 25 Endpoints de Comercio de Amazon e Inteligencia de Palabras Clave
• Análisis de Amazon — Investigación de Espectro Completo e Inteligencia de Vendedores
• Inteligencia de Palabras Clave de Amazon — Expansión, ASIN Inverso y Monitoreo
• Análisis de Mercado de Amazon — Descubrimiento, Entrada y Cambio

⚡ Especializadas:

• Monitor de Inteligencia de Competidores de Amazon — Inteligencia competitiva de modo dual con alertas por niveles
• Radar de Mercado Diario de Amazon — Monitoreo y Alertas Automatizados
• Pro de Auditoría de Listados de Amazon — Verificación de Salud en 8 Dimensiones
• Centro de Comando de Precios de Amazon — Señales SUBIR/MANTENER/BAJAR
• Extractor de Inteligencia de Reseñas de Amazon — Información del Consumidor a partir de más de 1 mil millones de Reseñas
• Extracción Web — Extracción de datos web públicos estructurados

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 EE. UU."

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 preestablecidos a través de la CLI)	"Encuentra zapatos para correr de menos de $80 con 4+ estrellas"
📊 markets/search	Descubrimiento de categorías y instantánea exacta: tamaño, concentración, precios seleccionados del Top 100	"¿Qué tan competitivo es el mercado de tapetes de yoga?"
🧩 markets/structure-profile	Distribuciones de marca, precio y otras del Top 100	"¿Qué bandas de precios explican las ventas?"
📅 markets/history	Tendencias disponibles de mercado por categoría a fin de mes	"¿Cómo ha cambiado esta categoría por mes?"
🏷️ products/competitors	Descubrimiento de competidores por palabra clave, marca o ASIN	"¿Quiénes son los principales vendedores en este nicho?"
⚡ realtime/product	Detalles de productos en tiempo real: reseñas, características, variantes	"Obtén detalles actuales para el ASIN B0D5CRV4KL"
💬 reviews/analysis	Información de reseñas impulsada 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 subcategorías bajo 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 tapetes 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 preestablecidos 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 de 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 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                            # 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

Requisitos

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

Contribuciones

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

Comunidad

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

Licencia

MIT © SerendipityOne Inc.