APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

L'infrastructure de données conçue pour les agents.
Alimente actuellement le commerce Amazon avec plus de 200 millions de produits, plus d'un milliard d'avis et des signaux en temps réel.

Site web • Obtenir une clé API • Discord • Démarrage rapide • Référence API

---

Qu'est-ce que ZooData ?

ZooData est l'infrastructure de données conçue pour les agents. Pas une API de scraping. Pas un tableau de bord humain. Une couche de données spécialement conçue qui donne à vos agents IA un accès direct aux signaux du commerce Amazon — plus de 200 millions de produits indexés, plus de 2 ans d'historique et plus d'un milliard d'avis pré-traités en informations structurées. JSON propre, temps réel, prêt pour les agents.

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

Aperçu des compétences

Ce dépôt contient 11 compétences d'agent organisées en deux niveaux :

🏗️ Fondation — accès aux données et analyse à spectre complet :

Compétence	Ce qu'elle fait	Entrée	Sortie	Avantage clé
📦 zoodata/	Accès direct aux 22 points de terminaison API — 12 points de terminaison commerce plus 10 points de terminaison d'intelligence de mots-clés	Mot-clé, catégorie, ASIN ou marque	Données API brutes avec mappage de champs et documentation des particularités	Référence API complète — chaque autre compétence s'appuie sur celle-ci
🎯 amazon-analysis/	13 modes de sélection intégrés + étude de marché, analyse des concurrents, évaluation ASIN, tarification, recherche par catégorie	Mot-clé/catégorie/ASIN + intention	Résultats d'analyse, meilleurs produits, analyses approfondies ASIN, informations avec niveau de confiance	Commandes composites (report, opportunity) exécutent des pipelines multi-points de terminaison en une seule fois
🔎 amazon-keyword-traffic-analysis/	Flux de travail sur la valeur des mots-clés et la santé du trafic produit, basés sur 10 points de terminaison d'intelligence de mots-clés	Mot-clé de départ, mot-clé cible, ASIN ou ASIN + mot-clé	Niveaux d'expansion, analyse de la valeur des mots-clés, structure du trafic produit, tendances et diagnostic de santé	Flux dédiés pour l'expansion de mots-clés, l'analyse de mots-clés et l'analyse du trafic produit

⚡ Spécialisée — conçue pour des flux de travail spécifiques :

Compétence	Ce qu'elle fait	Entrée	Sortie	Avantage clé
⚔️ amazon-competitor-intelligence-monitor/	Intelligence concurrentielle approfondie — analyse complète ou vérification rapide avec alertes à plusieurs niveaux	Mot-clé ou ASIN(s), éventuellement votre ASIN + ASINs concurrents	Matrice des concurrents, classement des marques, carte des prix, tendances sur 30 jours, scores (1-100), alertes à plusieurs niveaux	Double mode (Complet ~28-35 crédits, Rapide ~5-10) avec système d'alerte à trois niveaux
📡 amazon-daily-market-radar/	Surveillance quotidienne automatisée — changements de prix, nouveaux concurrents, mouvements BSR, pics d'avis	Vos ASINs (1-10) + mot-clé	Alertes ROUGE/JAUNE/VERT, tableau de bord KPI, mouvements des concurrents, éléments d'action	Configurez et oubliez avec validation des signaux (tendances sur 7+ jours vs pics sur un jour)
✅ amazon-listing-audit-pro/	Vérification de santé de la fiche produit sur 8 dimensions avec recommandations d'optimisation	Votre ASIN + mot-clé	Score (X/100, A-F), tableau de bord sur 8 dimensions, lacunes de mots-clés, liste de correctifs prioritaires	Réécritures exploitables utilisant le langage des avis à haute fréquence ; prise en charge de l'audit en masse
🚪 amazon-market-entry-analyzer/	Viabilité du marché en un clic — découvre les sous-marchés, score (1-100), verdict GO/PRUDENCE/ÉVITER	Mot-clé ou chemin de catégorie	Paysage des sous-marchés, verdict, aperçu du marché, paysage des marques, stratégie d'entrée	Découverte automatique des sous-marchés avec vérification CR10 à deux niveaux
📈 amazon-market-trend-scanner/	Analyse du paysage des catégories — sous-catégories tendance, niches émergentes, évolutions du marché	1+ chemin de catégorie ou mots-clés	Tableau de bord des tendances, TOP 5 des catégories populaires, analyse des nouveaux entrants, alertes de risque	Analyse des tendances au niveau de la catégorie sur TOUTES les sous-catégories
💎 amazon-opportunity-discoverer/	Scanner d'opportunités basé sur le profil — sélection automatique des stratégies, validation avec données en temps réel, score sur 7 dimensions	Budget + niveau d'expérience + mot-clé/catégorie	Top 10 des opportunités (S/A/B/C), analyse détaillée du top 3, alertes de risque	Sélection automatique de stratégie basée sur le profil + analyse rapide (~10 crédits)
💰 amazon-pricing-command-center/	Signaux de tarification basés sur les données — détection automatique de la catégorie feuille, analyse du paysage tarifaire	Un ou plusieurs ASINs	Signal AUGMENTER/MAINTENIR/BAISSER, carte thermique des fourchettes de prix, carte des prix des concurrents, analyse BuyBox	Entrée uniquement par ASIN (aucun mot-clé requis), ratio ventes/concurrence
💬 amazon-review-intelligence-extractor/	Informations consommateurs approfondies à partir de plus d'un milliard d'avis pré-analysés sur 11 dimensions	ASIN unique, plusieurs ASINs ou mot-clé de catégorie	Points de douleur, facteurs d'achat, profils d'utilisateurs, modèles d'utilisation, feuille de route de différenciation	Plus d'un milliard d'avis pré-analysés (économie de 95 % de jetons), 11 dimensions

Démarrage rapide

1. Installer les compétences

npx skills add SerendipityOneInc/ZooData-Skills

Vous serez invité à sélectionner les compétences à installer :

🏗️ Fondation :

• ZooData — Données de commerce Amazon, 11 points de terminaison
• Analyse Amazon — Recherche à spectre complet et intelligence vendeur
• Intelligence de mots-clés Amazon — Expansion, ASIN inversé et surveillance

⚡ Spécialisée :

• Moniteur d'intelligence concurrentielle Amazon — Intelligence concurrentielle à double mode avec alertes à plusieurs niveaux
• Radar de marché quotidien Amazon — Surveillance et alertes automatisées
• Audit de fiche produit Amazon Pro — Vérification de santé sur 8 dimensions
• Analyseur d'entrée sur le marché Amazon — Verdicts GO/PRUDENCE/ÉVITER
• Scanner de tendances de marché Amazon — Radar de catégorie quotidien
• Découvreur d'opportunités Amazon — Scanner de niches et score
• Centre de commande de tarification Amazon — Signaux AUGMENTER/MAINTENIR/BAISSER
• Extracteur d'intelligence des avis Amazon — Informations consommateurs à partir de plus d'un milliard d'avis

Ou clonez manuellement :

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

2. Définir votre clé API

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

🎁 Niveau gratuit : 1 000 crédits à l'inscription. 1 crédit = 1 appel API. Aucune carte de crédit requise.

3. Essayez

Demandez à votre agent IA :

"Analysez le paysage concurrentiel des écouteurs sans fil à moins de 50 $ sur Amazon US"

Ou utilisez directement le CLI :

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

Points de terminaison API

URL de base : https://api.zoodata.ai/openapi/v2 Authentification : Authorization: Bearer $ZOODATA_API_KEY Méthode : Tous les points de terminaison utilisent POST avec un corps JSON

Point de terminaison	Description	Exemple d'utilisation
🔍 products/search	Recherche de produits avec plus de 20 filtres (13 modes prédéfinis via le CLI)	"Trouver des chaussures de course à moins de 80 $ avec 4+ étoiles"
📊 markets/search	Métriques au niveau du marché — concentration, part de marque, tarification	"Quel est le niveau de concurrence sur le marché des tapis de yoga ?"
🏷️ products/competitors	Découverte de concurrents par mot-clé, marque ou ASIN	"Qui sont les meilleurs vendeurs dans cette niche ?"
⚡ realtime/product	Détails produits en temps réel — avis, caractéristiques, variantes	"Obtenir les détails actuels pour l'ASIN B0D5CRV4KL"
💬 reviews/analysis	Informations sur les avis propulsées par l'IA — sentiment, points de douleur	"Qu'est-ce que les clients aiment/détestent à propos de ce produit ?"
📁 categories	Navigation dans l'arborescence des catégories Amazon	"Afficher les sous-catégories sous Électronique"
📈 products/price-band-overview	Résumé des fourchettes de prix avec la meilleure fourchette d'opportunité	"Quelle est la meilleure fourchette de prix pour les tapis de yoga ?"
📊 products/price-band-detail	Analyse complète de la distribution sur 5 fourchettes de prix	"Afficher la répartition détaillée des fourchettes de prix pour les écouteurs sans fil"
🏢 products/brand-overview	Métriques de concentration des meilleures marques (CR10)	"Quel est le niveau de concentration du paysage des marques ?"
🏷️ products/brand-detail	Répartition par marque avec les meilleurs produits	"Quelles marques dominent cette catégorie ?"
📅 products/history	Instantanés quotidiens historiques pour les ASINs	"Afficher l'historique des prix et du BSR pour cet ASIN"

13 modes de recherche de produits

Le CLI de la compétence (zoodata.py --mode) fournit 13 modes prédéfinis pour différentes stratégies de recherche. Les modes sont développés en champs de filtre concrets (monthlySalesMin, salesGrowthRateMin, …) côté client — mode n'est pas un paramètre API, et l'envoyer à /openapi/v2/products/search renvoie 422 :

Mode	Stratégie	Cible
fast-movers	Vitesse de vente élevée	Revenu rapide
emerging	Tendances montantes, faible saturation	Premiers entrants
long-tail	Mots-clés de niche, demande stable	Revenu durable
underserved	Demande élevée, peu de vendeurs	Lacunes du marché
new-release	Produits récemment lancés	Articles tendance
fbm-friendly	Adapté à l'exécution par le marchand	Démarrage à faible investissement
low-price	Produits économiques	Stratégie de volume
single-variant	Fiches simples, sans variantes	Gestion facile
high-demand-low-barrier	Ventes élevées, faible barrière d'avis	Entrée évolutive
broad-catalog	Analyse large de la gamme de produits	Aperçu de la catégorie
selective-catalog	Sélections de haute qualité organisées	Sélection premium
speculative	Opportunités à haut risque, haute récompense	Stratégie agressive
top-bsr	Leaders du classement des meilleures ventes	Leaders du marché

Structure du projet

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

Exigences

• Python 3.8+ (bibliothèque standard uniquement, zéro dépendance pip)
• Clé API ZooData (obtenez-en une gratuitement)

Contribution

Nous accueillons les contributions ! Veuillez consulter CONTRIBUTING.md pour les directives.

Communauté

• 💬 Discord — Discutez, obtenez de l'aide, partagez ce que vous construisez
• 🐛 Problèmes — Rapports de bugs et demandes de fonctionnalités
• 📖 Documentation API — Documentation API complète

Licence

MIT © SerendipityOne Inc.