APIClaw — Amazon Data API for AI Agents

Português | 中文

Habilidades ZooData

A infraestrutura de dados construída para agentes.
Atualmente alimentando o comércio da Amazon com mais de 200 milhões de produtos, mais de 1 bilhão de 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 painel humano. É uma camada de dados criada especificamente para dar aos seus agentes de IA acesso direto aos sinais do 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 Habilidades

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

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

Habilidade	O Que Faz	Entrada	Saída	Vantagem Principal
📦 zoodata/	Acesso direto a 25 endpoints de comércio da Amazon e 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 habilidades se baseiam nela
🎯 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	Descobertas de análise, principais produtos, análises aprofundadas de ASIN, insights com marcação 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 valor de palavra-chave e saúde de tráfego de produto baseados em 11 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
📊 amazon-market-analysis/	Descubra candidatos de mercado e produto, avalie condições de entrada e acompanhe mudanças de categoria	Pergunta de mercado, categoria ou breve oportunidade de produto	Lista curta observada, avaliação condicional de entrada ou análise de tendência limitada	Uma história conectada com evidências separadas e limites de decisão do vendedor

⚡ Especializada — criada especificamente para fluxos de trabalho específicos:

Habilidade	O Que Faz	Entrada	Saída	Vantagem Principal
⚔️ amazon-competitor-intelligence-monitor/	Inteligência profunda de concorrentes — Verificação 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, 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 dia)
✅ amazon-listing-audit-pro/	Verificação de saúde de listagem 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 avaliações de alta frequência; suporte a auditoria em lote
💰 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 de AUMENTAR/MANTER/REDUZIR, mapa de calor de faixa de preço, mapa de preços de concorrentes, análise de BuyBox	Entrada apenas com ASIN (sem necessidade de palavra-chave), Índice de 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ários, padrões de uso, roteiro de diferenciação	Mais de 1 bilhão de avaliações pré-analisadas (economia de 95% em tokens), 11 dimensões
🌐 web-extract/	Extração estruturada de dados de páginas web públicas e resultados de busca	URL, consulta de busca ou site	JSON estruturado ou conteúdo de página	Lida com páginas renderizadas e rastreamentos de sites limitados

amazon-market-analysis é a habilidade unificada de mercado. Os antigos diretórios amazon-market-entry-analyzer, amazon-market-trend-scanner e amazon-opportunity-discoverer são mantidos apenas como fonte aposentada; seus pontos de entrada são nomeados RETIRED.md, para que instaladores e publicadores de habilidades não os descubram.

Início Rápido

1. Instale as Habilidades

npx skills add SerendipityOneInc/ZooData-Skills

Você será solicitado a selecionar quais habilidades instalar:

🏗️ Fundação:

• ZooData — 25 Endpoints de Comércio da Amazon e Inteligência de Palavras-Chave
• Análise Amazon — Pesquisa de Espectro Completo e Inteligência de Vendedor
• Inteligência de Palavras-Chave Amazon — Expansão, ASIN Reverso e Monitoramento
• Análise de Mercado Amazon — Descoberta, Entrada e Mudança

⚡ Especializada:

• Monitor de Inteligência de Concorrentes Amazon — Inteligência competitiva em modo duplo com alertas em níveis
• Radar de Mercado Diário Amazon — Monitoramento e Alertas Automatizados
• Auditoria de Listagem Amazon Pro — Verificação de Saúde em 8 Dimensões
• Central de Comando de Precificação Amazon — Sinais de AUMENTAR/MANTER/REDUZIR
• Extrator de Inteligência de Avaliações Amazon — Insights do Consumidor a partir de Mais de 1 Bilhão de Avaliações
• Extração Web — Extração estruturada de dados públicos da web

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 de ouvido sem fio abaixo de US$ 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 Uso
🔍 products/search	Busca de produtos com mais de 20 filtros (13 modos predefinidos via CLI)	"Encontre tênis de corrida abaixo de US$ 80 com 4+ estrelas"
📊 markets/search	Descoberta de categoria e snapshot exato — tamanho, concentração, precificação selecionada do Top 100	"Quão competitivo é o mercado de tapetes de yoga?"
🧩 markets/structure-profile	Distribuições de marca, preço e outras do Top 100	"Quais faixas de preço respondem pelas vendas?"
📅 markets/history	Tendências de mercado por categoria disponíveis no final do mês	"Como esta categoria mudou mês a mês?"
🏷️ products/competitors	Descoberta de concorrentes por palavra-chave, marca ou ASIN	"Quem são os principais vendedores neste nicho?"
⚡ realtime/product	Detalhes de produto em tempo real — avaliações, recursos, variações	"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 pela árvore de categorias da Amazon	"Mostre subcategorias em Eletrônicos"
📈 products/price-band-overview	Resumo de faixa de preço com melhor faixa de oportunidade	"Qual é a melhor faixa de preço para tapetes de yoga?"
📊 products/price-band-detail	Análise completa de 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 de principais marcas (CR10)	"Quão concentrado é o cenário de marcas?"
🏷️ products/brand-detail	Divisão por marca com principais produtos	"Quais marcas dominam esta categoria?"
📅 products/history	Snapshots 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 habilidade (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	Alvo
fast-movers	Alta velocidade de vendas	Receita rápida
emerging	Tendências em alta, baixa saturação	Primeiros movimentadores
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 de baixo investimento
low-price	Produtos econômicos	Estratégia de volume
single-variant	Listagens simples, sem variações	Gestão fácil
high-demand-low-barrier	Altas vendas, baixa barreira de avaliações	Entrada escalável
broad-catalog	Análise ampla de linha 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                            # 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+ (apenas stdlib, zero dependências pip)
• Chave de API 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
• 📖 Docs da API — Documentação completa da API

Licença

MIT © SerendipityOne Inc.