APIClaw — Amazon Data API for AI Agents

English | 中文

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 pour humains. 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, en 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 complète :

Compétence	Ce qu'elle fait	Entrée	Sortie	Avantage clé
📦 zoodata/	Accès direct aux 11 points de terminaison API — catégories, marchés, produits, concurrents, temps réel, avis, tranches de prix, marques, historique	Mot-clé, catégorie, ASIN ou marque	Données brutes de l'API avec mappage des 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 d'ASIN, informations étiquetées 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 d'intelligence de mots-clés basés sur 8 points de terminaison de trafic de mots-clés	Mot-clé de départ, mot-clé cible, ASIN ou ASIN + mot-clé	Niveaux d'expansion, verdicts sur un seul mot-clé, termes de trafic ASIN inversé, explications des anomalies	Flux dédiés pour l'expansion de mots-clés, l'ASIN inversé et la surveillance du trafic des mots-clés

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

Compétence	Ce qu'elle fait	Entrée	Sortie	Avantage clé
⚔️ amazon-competitor-intelligence-monitor/	Renseignement concurrentiel approfondi — Analyse complète ou Vérification rapide avec alertes graduées	Mot-clé ou ASIN(s), éventuellement votre ASIN + les ASIN des concurrents	Matrice des concurrents, classement des marques, carte des prix, tendances sur 30 jours, scores (1-100), alertes graduées	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 ASIN (1-10) + mot-clé	Alertes ROUGE/JAUNE/VERT, tableau de bord KPI, mouvement des concurrents, actions à mener	Configurer et oublier avec validation des signaux (tendances sur plus de 7 jours vs pics quotidiens)
✅ amazon-listing-audit-pro/	Vérification de l'état de la fiche produit sur 8 dimensions avec recommandations d'optimisation	Votre ASIN + mot-clé	Score (X/100, A-F), carte de score sur 8 dimensions, lacunes de mots-clés, liste de corrections 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, note (1-100), délivre un verdict GO/CAUTION/AVOID	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 double vérification CR10
📈 amazon-market-trend-scanner/	Analyse du paysage des catégories — sous-catégories tendance, niches émergentes, évolutions du marché	1+ chemins de catégorie ou mots-clés	Tableau de bord des tendances, TOP 5 des catégories en vogue, analyse des nouveaux entrants, alertes de risque	Analyse des tendances au niveau de la catégorie pour TOUTES les sous-catégories
💎 amazon-opportunity-discoverer/	Scanner d'opportunités piloté par profil — sélectionne automatiquement les stratégies, valide avec des données en temps réel, notation 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 pilotée par profil + Analyse rapide (~10 crédits)
💰 amazon-pricing-command-center/	Signaux de tarification basés sur les données — détecte automatiquement la catégorie feuille, analyse le paysage tarifaire	Un ou plusieurs ASIN	Signal AUGMENTER/MAINTENIR/BAISSER, carte thermique des tranches de prix, carte des prix des concurrents, analyse BuyBox	Entrée ASIN uniquement (pas besoin de mot-clé), Ratio Ventes/Concurrence
💬 amazon-review-intelligence-extractor/	Informations consommateurs approfondies à partir de plus d'un milliard d'avis pré-analysés sur 11 dimensions	Un seul ASIN, plusieurs ASIN ou mot-clé de catégorie	Points de friction, 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'économie de tokens), 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 du commerce Amazon, 11 points de terminaison
• Analyse Amazon — Recherche complète et intelligence vendeur
• Intelligence de mots-clés Amazon — Expansion, ASIN inversé et surveillance

⚡ Spécialisé :

• Moniteur de renseignement concurrentiel Amazon — Renseignement concurrentiel bimodal avec alertes graduées
• Radar quotidien du marché Amazon — Surveillance et alertes automatisées
• Audit Pro de fiche Amazon — Vérification de l'état sur 8 dimensions
• Analyseur d'entrée sur le marché Amazon — Verdicts GO/CAUTION/AVOID
• Scanner de tendances du marché Amazon — Radar quotidien des catégories
• Découvreur d'opportunités Amazon — Scanner de niches et notation
• Centre de commande des prix Amazon — Signaux AUGMENTER/MAINTENIR/BAISSER
• Extracteur d'intelligence des avis Amazon — Informations consommateurs à partir de plus d'un milliard d'avis

Ou cloner 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. Essayer

Demandez à votre agent IA :

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

Ou utilisez directement l'interface en ligne de commande :

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

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 de cas d'utilisation
🔍 products/search	Recherche de produits avec 13 modes prédéfinis, plus de 20 filtres	"Trouver des chaussures de course à moins de 80 $ avec plus de 4 étoiles"
📊 markets/search	Indicateurs au niveau du marché — concentration, part de marque, tarification	"Quelle est la compétitivité du 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 produit en temps réel — avis, caractéristiques, variantes	"Obtenir les détails actuels pour l'ASIN B0D5CRV4KL"
💬 reviews/analysis	Informations sur les avis alimentées par l'IA — sentiment, points de friction	"Qu'est-ce que les clients aiment/n'aiment pas à 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 tranches de prix avec la meilleure tranche d'opportunité	"Quelle est la meilleure gamme de prix pour les tapis de yoga ?"
📊 products/price-band-detail	Analyse complète de la distribution des prix sur 5 tranches	"Afficher la répartition détaillée des tranches de prix pour les écouteurs sans fil"
🏢 products/brand-overview	Indicateurs de concentration des principales marques (CR10)	"Quelle est la 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 ASIN	"Afficher l'historique des prix et du BSR pour cet ASIN"

13 modes de recherche de produits

Le point de terminaison products/search prend en charge 13 modes prédéfinis pour différentes stratégies de recherche :

Mode	Stratégie	Cible
fast-movers	Vitesse de vente élevée	Revenus rapides
emerging	Tendances à la hausse, faible saturation	Adoption précoce
long-tail	Mots-clés de niche, demande stable	Revenus durables
underserved	Forte demande, peu de vendeurs	Lacunes du marché
new-release	Produits lancés récemment	Articles tendance
fbm-friendly	Adapté à l'exécution par le commerçant	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 d'une large gamme de produits	Aperçu de la catégorie
selective-catalog	Sélections organisées de haute qualité	Sélection premium
speculative	Opportunités à haut risque et 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                            # 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

Prérequis

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

Contribuer

Les contributions sont les bienvenues ! Veuillez consulter CONTRIBUTING.md pour les directives.

Communauté

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

Licence

MIT © SerendipityOne Inc.