APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

A infraestrutura de dados criada para agentes.
Atualmente impulsionando o comércio da Amazon com mais de 200 milhões de produtos, 1 bilhão de avaliações e sinais em tempo real.

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

---

O que é ZooData?

ZooData é a infraestrutura de dados criada para agentes. Não é uma API de scraping. Não é um painel para humanos. É uma camada de dados criada especificamente para dar aos seus agentes de IA acesso direto aos sinais de comércio da Amazon — mais de 200 milhões de produtos indexados, mais de 2 anos de histórico e mais de 1 bilhão de 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 para agentes organizadas em dois níveis:

🏗️ Fundamentos — acesso a dados e análise de espectro completo:

Skill	O que faz	Entrada	Saída	Vantagem Principal
📦 zoodata/	Acesso direto a todos os 11 endpoints da API — categorias, mercados, produtos, concorrentes, tempo real, avaliações, faixas de preço, marcas, histórico	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 são construídas sobre esta
🎯 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 de análise, principais produtos, análises detalhadas de ASIN, insights com tags de confiança	Comandos compostos (report, opportunity) executam pipelines de múltiplos endpoints de uma só vez
🔎 amazon-keyword-traffic-analysis/	Fluxos de trabalho de inteligência de palavras-chave construídos sobre 8 endpoints de tráfego de palavras-chave	Palavra-chave semente, palavra-chave alvo, ASIN ou ASIN + palavra-chave	Níveis de expansão, vereditos de palavra-chave única, termos de tráfego de ASIN reverso, explicações de anomalias	Fluxos dedicados para expansão de palavras-chave, ASIN reverso e monitoramento de tráfego de palavras-chave

⚡ Especializadas — criadas para fluxos de trabalho específicos:

Skill	O que faz	Entrada	Saída	Vantagem Principal
⚔️ amazon-competitor-intelligence-monitor/	Inteligência profunda de concorrentes — Varredura Completa ou Verificação Rápida 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 (Completo ~28-35 créditos, Rápido ~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, movimento de concorrentes, itens de ação	Configurar e esquecer com validação de sinal (tendências de mais de 7 dias vs. picos de um único dia)
✅ amazon-listing-audit-pro/	Verificação de saúde do anúncio 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 das avaliações; suporte a auditoria em lote
🚪 amazon-market-entry-analyzer/	Viabilidade de mercado com um clique — descobre submercados, pontua (1-100), entrega veredito IR/CUIDADO/EVITAR	Palavra-chave ou caminho de categoria	Cenário de submercados, veredito, visão geral do mercado, cenário de marcas, estratégia de entrada	Descoberta automática de submercados com verificação CR10 de dois níveis
📈 amazon-market-trend-scanner/	Varredura do cenário de categorias — subcategorias em tendência, nichos emergentes, mudanças de mercado	1 ou mais 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 das 3 principais, alertas de risco	Seleção automática de estratégia orientada por perfil + Varredura Rápida (~10 créditos)
💰 amazon-pricing-command-center/	Sinais de precificação baseados em dados — detecta automaticamente a categoria folha, analisa o cenário de precificação	Um ou mais ASINs	Sinal AUMENTAR/MANTER/REDUZIR, mapa de calor de faixas de preço, mapa de preços de concorrentes, análise de BuyBox	Entrada apenas de ASIN (sem necessidade de palavra-chave), Relação Vendas/Concorrência
💬 amazon-review-intelligence-extractor/	Insights profundos do consumidor a partir de mais de 1 bilhão de 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	Mais de 1 bilhão de avaliações pré-analisadas (95% de economia 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:

🏗️ Fundamentos:

• ZooData — Dados de Comércio da Amazon, 11 Endpoints
• Análise da Amazon — Pesquisa de Espectro Completo e Inteligência para Vendedores
• Inteligência de Palavras-chave da Amazon — Expansão, ASIN Reverso e Monitoramento

⚡ Especializadas:

• Monitor de Inteligência de Concorrentes da Amazon — Inteligência competitiva de modo duplo com alertas em níveis
• Radar Diário de Mercado da Amazon — Monitoramento e Alertas Automatizados
• Auditoria Profissional de Anúncios da Amazon — Verificação de Saúde em 8 Dimensões
• Analisador de Entrada no Mercado da Amazon — Vereditos IR/CUIDADO/EVITAR
• Scanner de Tendências de Mercado da Amazon — Radar Diário de Categorias
• Descobridor de Oportunidades da Amazon — Scanner e Pontuação de Nichos
• Centro de Comando de Precificação da Amazon — Sinais AUMENTAR/MANTER/REDUZIR
• Extrator de Inteligência de Avaliações da Amazon — Insights do Consumidor de Mais de 1 Bilhão de Avaliações

Ou clone manualmente:

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

2. Configure 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 ao se inscrever. 1 crédito = 1 chamada de API. Não é necessário cartão de crédito.

3. Experimente

Pergunte ao seu agente de IA:

"Analise o cenário competitivo para fones de ouvido sem fio abaixo de R$250 na Amazon Brasil"

Ou use a CLI diretamente:

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

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	Pesquisa de produtos com 13 modos predefinidos, mais de 20 filtros	"Encontre tênis de corrida abaixo de R$400 com mais de 4 estrelas"
📊 markets/search	Métricas em nível de mercado — concentração, participação de marca, 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, características, variantes	"Obtenha detalhes atuais para o 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 na árvore de categorias da Amazon	"Mostre as 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 a divisão detalhada de faixas de preço para fones de ouvido sem fio"
🏢 products/brand-overview	Métricas de concentração das principais marcas (CR10)	"Quão concentrado é o cenário de marcas?"
🏷️ products/brand-detail	Detalhamento por marca com principais produtos	"Quais marcas dominam esta categoria?"
📅 products/history	Capturas instantâneas diárias históricas para ASINs	"Mostre o histórico de preço e BSR para este ASIN"

13 Modos de Pesquisa de Produtos

O endpoint products/search suporta 13 modos predefinidos para diferentes estratégias de pesquisa:

Modo	Estratégia	Alvo
fast-movers	Alta velocidade de vendas	Receita rápida
emerging	Tendências em alta, baixa saturação	Pioneiros
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 pelo comerciante	Início de baixo investimento
low-price	Produtos econômicos	Estratégia de volume
single-variant	Anúncios simples, sem variantes	Fácil gerenciamento
high-demand-low-barrier	Altas vendas, baixa barreira de avaliações	Entrada escalável
broad-catalog	Análise de ampla gama de produtos	Visão geral da categoria
selective-catalog	Seleções curadas de alta qualidade	Seleção premium
speculative	Oportunidades de alto risco, alta recompensa	Estratégia agressiva
top-bsr	Líderes do ranking de Best Seller	Líderes de mercado

Estrutura do Projeto

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

Contribuindo

Contribuições são bem-vindas! Por favor, veja CONTRIBUTING.md para orientações.

Comunidade

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

Licença

MIT © SerendipityOne Inc.