APIClaw — Amazon Data API for AI Agents

Français | 中文

Compétences ZooData

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 insights structurés. 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 10 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 à 25 endpoints de commerce Amazon et 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 — toutes les autres compétences s'appuient sur celle-ci
🎯 amazon-analysis/	13 modes de sélection intégrés + étude de marché, analyse concurrentielle, évaluation ASIN, tarification, recherche par catégorie	Mot-clé/catégorie/ASIN + intention	Résultats d'analyse, meilleurs produits, analyses approfondies ASIN, insights avec niveau de confiance	Commandes composites (report, opportunity) exécutent des pipelines multi-endpoints en une seule fois
🔎 amazon-keyword-traffic-analysis/	Workflows de valeur de mot-clé et de santé du trafic produit basés sur 11 endpoints d'intelligence de mots-clés	Mot-clé de départ, mot-clé cible, ASIN ou ASIN + mot-clé	Niveaux d'expansion, analyse de valeur de mot-clé, 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
📊 amazon-market-analysis/	Découvrir les candidats de marché et de produit, évaluer les conditions d'entrée et suivre les changements de catégorie	Question de marché, catégorie ou brief d'opportunité produit	Liste restreinte observée, évaluation conditionnelle d'entrée ou analyse de tendance bornée	Une histoire connectée avec des preuves distinctes et des limites de décision pour les vendeurs

⚡ 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 concurrentielle, 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, actions recommandées	Configurez et oubliez avec validation des signaux (tendances sur 7+ jours vs pics sur un jour)
✅ amazon-listing-audit-pro/	Contrôle 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 prioritaire de corrections	Réécritures actionnables utilisant le langage des avis à haute fréquence ; prise en charge des audits groupés
💰 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 concurrents, analyse BuyBox	Entrée ASIN uniquement (pas de mot-clé nécessaire), ratio Ventes/Concurrence
💬 amazon-review-intelligence-extractor/	Insights consommateurs approfondis à 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 (95 % d'économies de tokens), 11 dimensions
🌐 web-extract/	Extraction structurée de données à partir de pages web publiques et de résultats de recherche	URL, requête de recherche ou site	JSON structuré ou contenu de page	Gère les pages rendues et les explorations de sites limitées

amazon-market-analysis est la compétence de marché unifiée. Les anciens répertoires amazon-market-entry-analyzer, amazon-market-trend-scanner et amazon-opportunity-discoverer sont conservés uniquement comme source retirée ; leurs points d'entrée sont nommés RETIRED.md, afin que les installateurs et éditeurs de compétences ne les découvrent pas.

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 — 25 endpoints de commerce Amazon et d'intelligence de mots-clés
• Analyse Amazon — Recherche à spectre complet et intelligence vendeur
• Intelligence de mots-clés Amazon — Expansion, ASIN inversé et surveillance
• Analyse de marché Amazon — Découverte, entrée et changement

⚡ 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 Amazon Pro — Contrôle de santé sur 8 dimensions
• Centre de commande de tarification Amazon — Signaux AUGMENTER/MAINTENIR/BAISSER
• Extracteur d'intelligence d'avis Amazon — Insights consommateurs à partir de plus d'un milliard d'avis
• Extraction web — Extraction structurée de données web publiques

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-le

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

Endpoints API

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

Endpoint	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	Découverte de catégorie et instantané exact — taille, concentration, tarification sélectionnée du Top 100	"À quel point le marché des tapis de yoga est-il concurrentiel ?"
🧩 markets/structure-profile	Distributions de marque, de prix et autres distributions du Top 100	"Quelles fourchettes de prix expliquent les ventes ?"
📅 markets/history	Tendances de marché par catégorie disponibles en fin de mois	"Comment cette catégorie a-t-elle évolué par mois ?"
🏷️ 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	Insights d'avis propulsés 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 bande d'opportunité	"Quelle est la meilleure fourchette de prix pour les tapis de yoga ?"
📊 products/price-band-detail	Analyse complète de la distribution des prix sur 5 bandes	"Afficher la répartition détaillée des fourchettes de prix pour les écouteurs sans fil"
🏢 products/brand-overview	Métriques de concentration des grandes marques (CR10)	"À quel point le paysage des marques est-il concentré ?"
🏷️ products/brand-detail	Répartition par marque avec les meilleurs produits	"Quelles marques dominent cette catégorie ?"
📅 products/history	Instantanés historiques quotidiens 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, barrière d'avis faible	Entrée évolutive
broad-catalog	Analyse large de la gamme de produits	Vue d'ensemble de la catégorie
selective-catalog	Sélections de haute qualité soigneusement choisies	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                            # 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

Prérequis

• 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.