APIClaw — Amazon Data API for AI Agents

Deutsch | 中文

ZooData Skills

Die Dateninfrastruktur, die für Agenten gebaut wurde.
Versorgt aktuell den Amazon-Handel mit über 200 Mio. Produkten, über 1 Mrd. Bewertungen und Echtzeit-Signalen.

Website • API-Schlüssel erhalten • Discord • Schnellstart • API-Referenz

---

Was ist ZooData?

ZooData ist die Dateninfrastruktur, die für Agenten gebaut wurde. Keine Scraping-API. Kein Dashboard für Menschen. Eine zweckgebundene Datenschicht, die deinen KI-Agenten direkten Zugriff auf Amazon-Handelssignale bietet – über 200 Mio. indexierte Produkte, über 2 Jahre Verlauf und über 1 Mrd. Bewertungen, die zu strukturierten Erkenntnissen vorverarbeitet wurden. Sauberes JSON, in Echtzeit, agentenbereit.

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

Übersicht der Skills

Dieses Repository enthält 10 Agenten-Skills, organisiert in zwei Stufen:

🏗️ Fundament – Datenzugriff und Analyse über das gesamte Spektrum:

Skill	Was er tut	Eingabe	Ausgabe	Hauptvorteil
📦 zoodata/	Direkter Zugriff auf 25 Amazon-Commerce- und Keyword-Intelligence-Endpunkte	Keyword, Kategorie, ASIN oder Marke	Rohe API-Daten mit Feldzuordnung und Dokumentation der Besonderheiten	Vollständige API-Referenz – jeder andere Skill baut darauf auf
🎯 amazon-analysis/	13 integrierte Auswahlmodi + Marktforschung, Wettbewerbsanalyse, ASIN-Bewertung, Preisgestaltung, Kategorieforschung	Keyword/Kategorie/ASIN + Absicht	Analyseergebnisse, Top-Produkte, ASIN-Tiefenanalysen, mit Konfidenz gekennzeichnete Erkenntnisse	Zusammengesetzte Befehle (report, opportunity) führen Multi-Endpunkt-Pipelines in einem Durchgang aus
🔎 amazon-keyword-traffic-analysis/	Workflows für Keyword-Wert und Produkt-Traffic-Gesundheit, aufgebaut auf 11 Keyword-Intelligence-Endpunkten	Start-Keyword, Ziel-Keyword, ASIN oder ASIN + Keyword	Erweiterungsstufen, Keyword-Wert-Analyse, Produkt-Traffic-Struktur, Trends und Gesundheitsdiagnose	Dedizierte Abläufe für Keyword-Erweiterung, Keyword-Analyse und Produkt-Traffic-Analyse
📊 amazon-market-analysis/	Markt- und Produktkandidaten entdecken, Eintrittsbedingungen bewerten und Kategorieänderungen verfolgen	Marktfrage, Kategorie oder Produktchancen-Kurzprofil	Beobachtete Shortlist, bedingte Eintrittsbewertung oder begrenzte Trendanalyse	Eine zusammenhängende Geschichte mit getrennten Evidenz- und Verkäufer-Entscheidungsgrenzen

⚡ Spezialisiert – zweckgebunden für bestimmte Workflows:

Skill	Was er tut	Eingabe	Ausgabe	Hauptvorteil
⚔️ amazon-competitor-intelligence-monitor/	Tiefe Wettbewerbs-Intelligence – Vollscan oder Schnellcheck mit abgestuften Warnungen	Keyword oder ASIN(s), optional deine ASIN + Wettbewerber-ASINs	Wettbewerbsmatrix, Markenranking, Preiskarte, 30-Tage-Trends, Bewertungen (1–100), abgestufte Warnungen	Dual-Modus (Voll ~28–35 Credits, Schnell ~5–10) mit Drei-Stufen-Warnsystem
📡 amazon-daily-market-radar/	Automatisierte tägliche Überwachung – Preisänderungen, neue Wettbewerber, BSR-Bewegungen, Bewertungsspitzen	Deine ASINs (1–10) + Keyword	ROTE/GELBE/GRÜNE Warnungen, KPI-Dashboard, Wettbewerbsbewegungen, Aktionspunkte	Einmal einrichten und vergessen, mit Signalvalidierung (7+ Tage Trends vs. Ein-Tages-Spitzen)
✅ amazon-listing-audit-pro/	8-dimensionale Listing-Gesundheitsprüfung mit Optimierungsempfehlungen	Deine ASIN + Keyword	Bewertung (X/100, A–F), 8-dimensionale Scorecard, Keyword-Lücken, priorisierte Korrekturliste	Umsetzbare Neuschreibungen mit häufig verwendeter Bewertungssprache; Massenprüfungsunterstützung
💰 amazon-pricing-command-center/	Datengesteuerte Preissignale – erkennt automatisch die Blattkategorie, analysiert die Preislandschaft	Eine oder mehrere ASINs	ERHÖHEN/HALTEN/SENKEN-Signal, Preisband-Wärmekarte, Wettbewerbspreiskarte, BuyBox-Analyse	Nur ASIN-Eingabe (kein Keyword nötig), Umsatz-/Wettbewerbsverhältnis
💬 amazon-review-intelligence-extractor/	Tiefe Verbrauchereinblicke aus über 1 Mrd. voranalysierten Bewertungen über 11 Dimensionen	Einzelne ASIN, mehrere ASINs oder Kategorie-Keyword	Schmerzpunkte, Kaufentscheidungsfaktoren, Nutzerprofile, Nutzungsmuster, Differenzierungsfahrplan	Über 1 Mrd. voranalysierte Bewertungen (95 % Token-Ersparnis), 11 Dimensionen
🌐 web-extract/	Strukturierte Datenextraktion aus öffentlichen Webseiten und Suchergebnissen	URL, Suchanfrage oder Website	Strukturiertes JSON oder Seiteninhalt	Verarbeitet gerenderte Seiten und begrenzte Website-Crawls

amazon-market-analysis ist der vereinheitlichte Markt-Skill. Die früheren Verzeichnisse amazon-market-entry-analyzer, amazon-market-trend-scanner und amazon-opportunity-discoverer werden nur als zurückgezogene Quelle beibehalten; ihre Einstiegspunkte sind als RETIRED.md benannt, sodass Skill-Installer und -Publisher sie nicht entdecken.

Schnellstart

1. Die Skills installieren

npx skills add SerendipityOneInc/ZooData-Skills

Du wirst aufgefordert, auszuwählen, welche Skills installiert werden sollen:

🏗️ Fundament:

• ZooData – 25 Amazon-Commerce- und Keyword-Intelligence-Endpunkte
• Amazon-Analyse – Forschung und Verkäufer-Intelligence über das gesamte Spektrum
• Amazon-Keyword-Intelligence – Erweiterung, Reverse-ASIN und Überwachung
• Amazon-Marktanalyse – Entdeckung, Eintritt und Veränderung

⚡ Spezialisiert:

• Amazon-Wettbewerbs-Intelligence-Monitor – Dual-Modus-Wettbewerbsintelligenz mit abgestuften Warnungen
• Amazon-Tagesmarkt-Radar – Automatisierte Überwachung und Warnungen
• Amazon-Listing-Audit-Pro – 8-dimensionale Gesundheitsprüfung
• Amazon-Preis-Kommandozentrale – ERHÖHEN/HALTEN/SENKEN-Signale
• Amazon-Bewertungs-Intelligence-Extraktor – Verbrauchereinblicke aus über 1 Mrd. Bewertungen
• Web-Extraktion – Strukturierte Extraktion öffentlicher Webdaten

Oder manuell klonen:

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

2. Deinen API-Schlüssel festlegen

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

🎁 Kostenlose Stufe: 1.000 Credits bei der Anmeldung. 1 Credit = 1 API-Aufruf. Keine Kreditkarte erforderlich.

3. Ausprobieren

Frag deinen KI-Agenten:

„Analysiere die Wettbewerbslandschaft für kabellose Ohrhörer unter 50 $ auf Amazon US"

Oder nutze die CLI direkt:

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

API-Endpunkte

Basis-URL: https://api.zoodata.ai/openapi/v2 Authentifizierung: Authorization: Bearer $ZOODATA_API_KEY Methode: Alle Endpunkte verwenden POST mit JSON-Body

Endpunkt	Beschreibung	Beispiel-Anwendungsfall
🔍 products/search	Produktsuche mit über 20 Filtern (13 voreingestellte Modi über die CLI)	„Laufschuhe unter 80 $ mit 4+ Sternen finden"
📊 markets/search	Kategorieentdeckung und exakte Momentaufnahme – Größe, Konzentration, ausgewählte Top-100-Preise	„Wie wettbewerbsintensiv ist der Markt für Yogamatten?"
🧩 markets/structure-profile	Marken-, Preis- und andere Top-100-Verteilungen	„Welche Preisbänder machen den Umsatz aus?"
📅 markets/history	Verfügbare Monatsend-Trends für Kategoriemärkte	„Wie hat sich diese Kategorie monatlich verändert?"
🏷️ products/competitors	Wettbewerberentdeckung nach Keyword, Marke oder ASIN	„Wer sind die Top-Verkäufer in dieser Nische?"
⚡ realtime/product	Echtzeit-Produktdetails – Bewertungen, Funktionen, Varianten	„Aktuelle Details für ASIN B0D5CRV4KL abrufen"
💬 reviews/analysis	KI-gestützte Bewertungseinblicke – Stimmung, Schmerzpunkte	„Was lieben/hassen Kunden an diesem Produkt?"
📁 categories	Navigation im Amazon-Kategoriebaum	„Unterkategorien unter Elektronik anzeigen"
📈 products/price-band-overview	Preisband-Zusammenfassung mit bestem Chancenband	„Was ist der beste Preisbereich für Yogamatten?"
📊 products/price-band-detail	Vollständige 5-Band-Preisverteilungsanalyse	„Detaillierte Preisband-Aufschlüsselung für kabellose Ohrhörer anzeigen"
🏢 products/brand-overview	Konzentrationskennzahlen für Top-Marken (CR10)	„Wie konzentriert ist die Markenlandschaft?"
🏷️ products/brand-detail	Aufschlüsselung pro Marke mit Top-Produkten	„Welche Marken dominieren diese Kategorie?"
📅 products/history	Historische tägliche Momentaufnahmen für ASINs	„Preis- und BSR-Verlauf für diese ASIN anzeigen"

13 Produktsuchmodi

Die Skill-CLI (zoodata.py --mode) bietet 13 voreingestellte Modi für verschiedene Forschungsstrategien. Modi werden clientseitig in konkrete Filterfelder (monthlySalesMin, salesGrowthRateMin, …) erweitert – mode ist kein API-Parameter, und das Senden an /openapi/v2/products/search gibt 422 zurück:

Modus	Strategie	Ziel
fast-movers	Hohe Verkaufsgeschwindigkeit	Schneller Umsatz
emerging	Steigende Trends, geringe Sättigung	Frühe Bewegungen
long-tail	Nischen-Keywords, stabile Nachfrage	Nachhaltiges Einkommen
underserved	Hohe Nachfrage, wenige Verkäufer	Marktlücken
new-release	Kürzlich gestartete Produkte	Trendartikel
fbm-friendly	Geeignet für Händlerabwicklung	Start mit geringer Investition
low-price	Preisgünstige Produkte	Mengenstrategie
single-variant	Einfache Listings, keine Varianten	Einfache Verwaltung
high-demand-low-barrier	Hoher Umsatz, niedrige Bewertungshürde	Skalierbarer Einstieg
broad-catalog	Breite Produktbereichsanalyse	Kategorieübersicht
selective-catalog	Kuratierte hochwertige Auswahl	Premium-Auswahl
speculative	Chancen mit hohem Risiko und hoher Belohnung	Aggressive Strategie
top-bsr	Best-Seller-Rank-Führer	Marktführer

Projektstruktur

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

Anforderungen

• Python 3.8+ (nur Standardbibliothek, null pip-Abhängigkeiten)
• ZooData-API-Schlüssel (kostenlos erhalten)

Mitwirken

Wir freuen uns über Beiträge! Bitte beachte CONTRIBUTING.md für Richtlinien.

Community

• 💬 Discord – Chatten, Hilfe erhalten, teilen, was du baust
• 🐛 Issues – Fehlerberichte und Funktionsanfragen
• 📖 API-Dokumentation – Vollständige API-Dokumentation

Lizenz

MIT © SerendipityOne Inc.