APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

A infraestrutura de dados construída para agentes.
Atualmente alimentando o comércio da Amazon com 200M+ produtos, 1B+ avaliações e sinais em tempo real.

Site • Obter Chave de API • Discord • Início Rápido • Referência da API

---

O que é o ZooData?

ZooData é a infraestrutura de dados construída para agentes. Não é uma API de scraping. Não é um dashboard para humanos. É uma camada de dados criada especificamente para dar aos seus agentes de IA acesso direto aos sinais de comércio da Amazon — 200M+ produtos indexados, 2+ anos de histórico e 1B+ avaliações pré-processadas em insights estruturados. JSON limpo, em tempo real, pronto para agentes.

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

Visão Geral das Skills

Este repositório contém 11 skills de agente organizadas em dois níveis:

🏗️ Fundação — acesso a dados e análise de espectro completo:

Skill	O que faz	Entrada	Saída	Vantagem principal
📦 zoodata/	Acesso direto a todos os 22 endpoints da API — 12 endpoints de comércio mais 10 endpoints de inteligência de palavras-chave	Palavra-chave, categoria, ASIN ou marca	Dados brutos da API com mapeamento de campos e documentação de peculiaridades	Referência completa da API — todas as outras skills se baseiam nisso
🎯 amazon-analysis/	13 modos de seleção integrados + pesquisa de mercado, análise de concorrentes, avaliação de ASIN, precificação, pesquisa de categoria	Palavra-chave/categoria/ASIN + intenção	Resultados da análise, principais produtos, análises aprofundadas de ASIN, insights com nível de confiança	Comandos compostos (report, opportunity) executam pipelines multi-endpoint de uma só vez
🔎 amazon-keyword-traffic-analysis/	Fluxos de trabalho de valor de palavra-chave e saúde de tráfego de produto baseados em 10 endpoints de inteligência de palavras-chave	Palavra-chave inicial, palavra-chave alvo, ASIN ou ASIN + palavra-chave	Níveis de expansão, análise de valor de palavra-chave, estrutura de tráfego do produto, tendências e diagnóstico de saúde	Fluxos dedicados para expansão de palavras-chave, análise de palavras-chave e análise de tráfego de produto

⚡ Especializadas — construídas para fluxos de trabalho específicos:

Skill	O que faz	Entrada	Saída	Vantagem principal
⚔️ amazon-competitor-intelligence-monitor/	Inteligência profunda de concorrentes — Full Scan ou Quick Check com alertas em níveis	Palavra-chave ou ASIN(s), opcionalmente seu ASIN + ASINs de concorrentes	Matriz de concorrentes, ranking de marcas, mapa de preços, tendências de 30 dias, pontuações (1-100), alertas em níveis	Modo duplo (Full ~28-35 créditos, Quick ~5-10) com sistema de alerta de três níveis
📡 amazon-daily-market-radar/	Monitoramento diário automatizado — mudanças de preço, novos concorrentes, movimentos de BSR, picos de avaliações	Seus ASINs (1-10) + palavra-chave	Alertas VERMELHO/AMARELO/VERDE, painel de KPIs, movimentação de concorrentes, itens de ação	Configure e esqueça com validação de sinais (tendências de 7+ dias vs picos de um único dia)
✅ amazon-listing-audit-pro/	Verificação de saúde de listing em 8 dimensões com recomendações de otimização	Seu ASIN + palavra-chave	Pontuação (X/100, A-F), scorecard de 8 dimensões, lacunas de palavras-chave, lista de correções prioritárias	Reescritas acionáveis usando linguagem de alta frequência em avaliações; suporte a auditoria em lote
🚪 amazon-market-entry-analyzer/	Viabilidade de mercado com um clique — descobre submercados, pontua (1-100), entrega veredictos GO/CAUTION/AVOID	Palavra-chave ou caminho de categoria	Panorama de submercados, veredicto, visão geral do mercado, panorama de marcas, estratégia de entrada	Descoberta automática de submercados com verificação CR10 em dois níveis
📈 amazon-market-trend-scanner/	Varredura do panorama de categorias — subcategorias em alta, nichos emergentes, mudanças de mercado	1+ caminhos de categoria ou palavras-chave	Painel de tendências, TOP 5 Categorias Quentes, varredura de novos entrantes, alertas de risco	Análise de tendências em nível de categoria em TODAS as subcategorias
💎 amazon-opportunity-discoverer/	Scanner de oportunidades orientado por perfil — seleciona estratégias automaticamente, valida com dados em tempo real, pontuação em 7 dimensões	Orçamento + nível de experiência + palavra-chave/categoria	Top 10 oportunidades (S/A/B/C), análise detalhada do top 3, alertas de risco	Seleção automática de estratégia orientada por perfil + Quick-Scan (~10 créditos)
💰 amazon-pricing-command-center/	Sinais de precificação orientados por dados — detecta automaticamente a categoria folha, analisa o panorama de preços	Um ou mais ASINs	Sinal RAISE/HOLD/LOWER, heatmap de faixas de preço, mapa de preços de concorrentes, análise de BuyBox	Entrada apenas com ASIN (sem necessidade de palavra-chave), Sales/Competition Ratio
💬 amazon-review-intelligence-extractor/	Insights profundos do consumidor a partir de 1B+ avaliações pré-analisadas em 11 dimensões	ASIN único, múltiplos ASINs ou palavra-chave de categoria	Pontos de dor, fatores de compra, perfis de usuário, padrões de uso, roteiro de diferenciação	1B+ avaliações pré-analisadas (economia de 95% de tokens), 11 dimensões

Início Rápido

1. Instale as Skills

npx skills add SerendipityOneInc/ZooData-Skills

Você será solicitado a selecionar quais skills instalar:

🏗️ Fundação:

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

⚡ Especializadas:

• Amazon Competitor Intelligence Monitor — Dual-mode competitive intelligence with tiered alerts
• Amazon Daily Market Radar — Automated Monitoring & Alerts
• Amazon Listing Audit Pro — 8-Dimension Health Check
• Amazon Market Entry Analyzer — GO/CAUTION/AVOID Verdicts
• Amazon Market Trend Scanner — Daily Category Radar
• Amazon Opportunity Discoverer — Niche Scanner & Scoring
• Amazon Pricing Command Center — RAISE/HOLD/LOWER Signals
• Amazon Review Intelligence Extractor — Consumer Insights from 1B+ Reviews

Ou clone manualmente:

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

2. Defina Sua Chave de API

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

🎁 Nível gratuito: 1.000 créditos no cadastro. 1 crédito = 1 chamada de API. Sem necessidade de cartão de crédito.

3. Experimente

Pergunte ao seu agente de IA:

"Analise o cenário competitivo de fones sem fio abaixo de $50 na Amazon dos EUA"

Ou use a CLI diretamente:

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

Endpoints da API

URL base: https://api.zoodata.ai/openapi/v2 Autenticação: Authorization: Bearer $ZOODATA_API_KEY Método: Todos os endpoints usam POST com corpo JSON

Endpoint	Descrição	Exemplo de caso de uso
🔍 products/search	Busca de produtos com 20+ filtros (13 modos predefinidos via CLI)	"Encontre tênis de corrida abaixo de $80 com 4+ estrelas"
📊 markets/search	Métricas em nível de mercado — concentração, participação de marcas, precificação	"Quão competitivo é o mercado de tapetes de yoga?"
🏷️ products/competitors	Descoberta de concorrentes por palavra-chave, marca ou ASIN	"Quem são os principais vendedores neste nicho?"
⚡ realtime/product	Detalhes do produto em tempo real — avaliações, recursos, variantes	"Obtenha detalhes atuais do ASIN B0D5CRV4KL"
💬 reviews/analysis	Insights de avaliações com IA — sentimento, pontos de dor	"O que os clientes amam/odeiam neste produto?"
📁 categories	Navegação pela árvore de categorias da Amazon	"Mostre subcategorias em Eletrônicos"
📈 products/price-band-overview	Resumo de faixas de preço com a melhor faixa de oportunidade	"Qual é a melhor faixa de preço para tapetes de yoga?"
📊 products/price-band-detail	Análise completa da distribuição de preços em 5 faixas	"Mostre o detalhamento das faixas de preço para fones sem fio"
🏢 products/brand-overview	Métricas de concentração das principais marcas (CR10)	"Quão concentrado é o panorama de marcas?"
🏷️ products/brand-detail	Detalhamento por marca com principais produtos	"Quais marcas dominam esta categoria?"
📅 products/history	Instantâneos diários históricos para ASINs	"Mostre o histórico de preço e BSR para este ASIN"

13 Modos de Busca de Produtos

A CLI da skill (zoodata.py --mode) fornece 13 modos predefinidos para diferentes estratégias de pesquisa. Os modos são expandidos em campos de filtro concretos (monthlySalesMin, salesGrowthRateMin, …) no lado do cliente — mode não é um parâmetro da API, e enviá-lo para /openapi/v2/products/search retorna 422:

Modo	Estratégia	Objetivo
fast-movers	Alta velocidade de vendas	Receita rápida
emerging	Tendências em alta, baixa saturação	Primeiros movimentos
long-tail	Palavras-chave de nicho, demanda estável	Renda sustentável
underserved	Alta demanda, poucos vendedores	Lacunas de mercado
new-release	Produtos lançados recentemente	Itens em tendência
fbm-friendly	Adequado para fulfillment do vendedor	Início com baixo investimento
low-price	Produtos com preço acessível	Estratégia de volume
single-variant	Listings simples, sem variantes	Gestão fácil
high-demand-low-barrier	Altas vendas, baixa barreira de avaliações	Entrada escalável
broad-catalog	Análise ampla de gama de produtos	Visão geral da categoria
selective-catalog	Seleções curadas de alta qualidade	Seleção premium
speculative	Oportunidades de alto risco e alta recompensa	Estratégia agressiva
top-bsr	Líderes do Best Seller Rank	Líderes de mercado

Estrutura do Projeto

├── 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+ (apenas stdlib, zero dependências pip)
• Chave de API do ZooData (obtenha uma gratuitamente)

Contribuindo

Aceitamos contribuições! Consulte CONTRIBUTING.md para diretrizes.

Comunidade

• 💬 Discord — Converse, obtenha ajuda, compartilhe o que você está construindo
• 🐛 Issues — Relatórios de bugs e solicitações de recursos
• 📖 API Docs — Documentação completa da API

Licença

MIT © SerendipityOne Inc.