APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

Infrastruktur data yang dibangun untuk agen.
Saat ini mendukung perdagangan Amazon dengan 200 juta+ produk, 1 miliar+ ulasan, dan sinyal waktu nyata.

Situs Web • Dapatkan Kunci API • Discord • Mulai Cepat • Referensi API

---

Apa itu ZooData?

ZooData adalah infrastruktur data yang dibangun untuk agen. Bukan API scraping. Bukan dasbor manusia. Lapisan data yang dibangun khusus yang memberikan agen AI Anda akses langsung ke sinyal perdagangan Amazon — 200 juta+ produk terindeks, riwayat 2+ tahun, dan 1 miliar+ ulasan yang telah diproses menjadi wawasan terstruktur. JSON bersih, waktu nyata, siap untuk agen.

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

Ikhtisar Skills

Repositori ini berisi 11 skills agen yang disusun dalam dua tingkatan:

🏗️ Fondasi — akses data dan analisis spektrum penuh:

Skill	Fungsinya	Masukan	Keluaran	Keunggulan Utama
📦 zoodata/	Akses langsung ke semua 11 endpoint API — kategori, pasar, produk, pesaing, waktu nyata, ulasan, pita harga, merek, riwayat	Kata kunci, kategori, ASIN, atau merek	Data API mentah dengan pemetaan bidang dan dokumentasi keanehan	Referensi API lengkap — setiap skill lainnya dibangun di atas ini
🎯 amazon-analysis/	13 mode pemilihan bawaan + riset pasar, analisis pesaing, evaluasi ASIN, penetapan harga, riset kategori	Kata kunci/kategori/ASIN + maksud	Temuan analisis, produk teratas, pendalaman ASIN, wawasan berlabel keyakinan	Perintah gabungan (report, opportunity) menjalankan pipeline multi-endpoint dalam satu langkah
🔎 amazon-keyword-traffic-analysis/	Alur kerja intelijen kata kunci yang dibangun di atas 8 endpoint lalu lintas kata kunci	Kata kunci awal, kata kunci target, ASIN, atau ASIN + kata kunci	Tingkatan ekspansi, putusan kata kunci tunggal, istilah lalu lintas ASIN terbalik, penjelasan anomali	Alur khusus untuk ekspansi kata kunci, ASIN terbalik, dan pemantauan lalu lintas kata kunci

⚡ Spesialisasi — dibangun khusus untuk alur kerja tertentu:

Skill	Fungsinya	Masukan	Keluaran	Keunggulan Utama
⚔️ amazon-competitor-intelligence-monitor/	Intelijen pesaing mendalam — Pemindaian Penuh atau Pemeriksaan Cepat dengan peringatan bertingkat	Kata kunci atau ASIN, opsional ASIN Anda + ASIN pesaing	Matriks pesaing, peringkat merek, peta harga, tren 30 hari, skor (1-100), peringatan bertingkat	Mode ganda (Penuh ~28-35 kredit, Cepat ~5-10) dengan sistem peringatan tiga tingkat
📡 amazon-daily-market-radar/	Pemantauan harian otomatis — perubahan harga, pesaing baru, pergerakan BSR, lonjakan ulasan	ASIN Anda (1-10) + kata kunci	Peringatan MERAH/KUNING/HIJAU, dasbor KPI, pergerakan pesaing, item tindakan	Atur dan lupakan dengan validasi sinyal (tren 7+ hari vs lonjakan satu hari)
✅ amazon-listing-audit-pro/	Pemeriksaan kesehatan daftar 8 dimensi dengan rekomendasi pengoptimalan	ASIN Anda + kata kunci	Skor (X/100, A-F), kartu skor 8 dimensi, kesenjangan kata kunci, daftar perbaikan prioritas	Penulisan ulang yang dapat ditindaklanjuti menggunakan bahasa ulasan frekuensi tinggi; dukungan audit massal
🚪 amazon-market-entry-analyzer/	Viabilitas pasar satu klik — menemukan sub-pasar, memberi skor (1-100), memberikan putusan GO/CAUTION/AVOID	Kata kunci atau jalur kategori	Lanskap sub-pasar, putusan, ikhtisar pasar, lanskap merek, strategi masuk	Penemuan sub-pasar otomatis dengan pemeriksaan CR10 tingkat ganda
📈 amazon-market-trend-scanner/	Pemindaian lanskap kategori — subkategori tren, ceruk yang muncul, pergeseran pasar	1+ jalur kategori atau kata kunci	Dasbor tren, TOP 5 Kategori Panas, pemindaian pendatang baru, peringatan risiko	Analisis tren tingkat kategori di SEMUA subkategori
💎 amazon-opportunity-discoverer/	Pemindai peluang berbasis profil — memilih strategi secara otomatis, memvalidasi dengan data waktu nyata, penilaian 7 dimensi	Anggaran + tingkat pengalaman + kata kunci/kategori	10 peluang teratas (S/A/B/C), analisis 3 teratas terperinci, peringatan risiko	Pemilihan strategi otomatis berbasis profil + Pemindaian Cepat (~10 kredit)
💰 amazon-pricing-command-center/	Sinyal penetapan harga berbasis data — mendeteksi kategori daun secara otomatis, menganalisis lanskap penetapan harga	Satu atau lebih ASIN	Sinyal NAIKKAN/TAHAN/TURUNKAN, peta panas pita harga, peta harga pesaing, analisis BuyBox	Masukan hanya ASIN (tidak perlu kata kunci), Rasio Penjualan/Kompetisi
💬 amazon-review-intelligence-extractor/	Wawasan konsumen mendalam dari 1 miliar+ ulasan yang telah dianalisis sebelumnya di 11 dimensi	ASIN tunggal, beberapa ASIN, atau kata kunci kategori	Poin masalah, faktor pembelian, profil pengguna, pola penggunaan, peta jalan diferensiasi	1 miliar+ ulasan yang telah dianalisis sebelumnya (penghematan token 95%), 11 dimensi

Mulai Cepat

1. Instal Skills

npx skills add SerendipityOneInc/ZooData-Skills

Anda akan diminta untuk memilih skills mana yang akan diinstal:

🏗️ Fondasi:

• ZooData — Data Perdagangan Amazon, 11 Endpoint
• Analisis Amazon — Riset Spektrum Penuh & Intelijen Penjual
• Intelijen Kata Kunci Amazon — Ekspansi, ASIN Terbalik & Pemantauan

⚡ Spesialisasi:

• Monitor Intelijen Pesaing Amazon — Intelijen kompetitif mode ganda dengan peringatan bertingkat
• Radar Pasar Harian Amazon — Pemantauan & Peringatan Otomatis
• Audit Daftar Amazon Pro — Pemeriksaan Kesehatan 8 Dimensi
• Penganalisis Masuk Pasar Amazon — Putusan GO/CAUTION/AVOID
• Pemindai Tren Pasar Amazon — Radar Kategori Harian
• Penemu Peluang Amazon — Pemindai Ceruk & Penilaian
• Pusat Komando Penetapan Harga Amazon — Sinyal NAIKKAN/TAHAN/TURUNKAN
• Ekstraktor Intelijen Ulasan Amazon — Wawasan Konsumen dari 1 Miliar+ Ulasan

Atau kloning secara manual:

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

2. Atur Kunci API Anda

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

🎁 Tingkat gratis: 1.000 kredit saat mendaftar. 1 kredit = 1 panggilan API. Tidak perlu kartu kredit.

3. Cobalah

Tanyakan agen AI Anda:

"Analisis lanskap kompetitif untuk earbud nirkabel di bawah $50 di Amazon AS"

Atau gunakan CLI secara langsung:

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

Endpoint API

URL Dasar: https://api.zoodata.ai/openapi/v2 Auth: Authorization: Bearer $ZOODATA_API_KEY Metode: Semua endpoint menggunakan POST dengan isi JSON

Endpoint	Deskripsi	Contoh Kasus Penggunaan
🔍 products/search	Pencarian produk dengan 13 mode prasetel, 20+ filter	"Temukan sepatu lari di bawah $80 dengan bintang 4+"
📊 markets/search	Metrik tingkat pasar — konsentrasi, pangsa merek, penetapan harga	"Seberapa kompetitif pasar matras yoga?"
🏷️ products/competitors	Penemuan pesaing berdasarkan kata kunci, merek, atau ASIN	"Siapa penjual teratas di ceruk ini?"
⚡ realtime/product	Detail produk waktu nyata — ulasan, fitur, varian	"Dapatkan detail terkini untuk ASIN B0D5CRV4KL"
💬 reviews/analysis	Wawasan ulasan bertenaga AI — sentimen, poin masalah	"Apa yang disukai/dibenci pelanggan tentang produk ini?"
📁 categories	Navigasi pohon kategori Amazon	"Tampilkan subkategori di bawah Elektronik"
📈 products/price-band-overview	Ringkasan pita harga dengan pita peluang terbaik	"Berapa kisaran harga terbaik untuk matras yoga?"
📊 products/price-band-detail	Analisis distribusi harga 5 pita penuh	"Tampilkan rincian pita harga terperinci untuk earbud nirkabel"
🏢 products/brand-overview	Metrik konsentrasi merek teratas (CR10)	"Seberapa terkonsentrasi lanskap merek?"
🏷️ products/brand-detail	Rincian per merek dengan produk teratas	"Merek mana yang mendominasi kategori ini?"
📅 products/history	Cuplikan harian historis untuk ASIN	"Tampilkan riwayat harga dan BSR untuk ASIN ini"

13 Mode Pencarian Produk

Endpoint products/search mendukung 13 mode prasetel untuk berbagai strategi riset:

Mode	Strategi	Target
fast-movers	Kecepatan penjualan tinggi	Pendapatan cepat
emerging	Tren meningkat, saturasi rendah	Penggerak awal
long-tail	Kata kunci ceruk, permintaan stabil	Pendapatan berkelanjutan
underserved	Permintaan tinggi, sedikit penjual	Kesenjangan pasar
new-release	Produk yang baru diluncurkan	Item tren
fbm-friendly	Cocok untuk pemenuhan pedagang	Awal investasi rendah
low-price	Produk ramah anggaran	Strategi volume
single-variant	Daftar sederhana, tanpa varian	Manajemen mudah
high-demand-low-barrier	Penjualan tinggi, hambatan ulasan rendah	Masuk yang dapat diskalakan
broad-catalog	Analisis rentang produk luas	Ikhtisar kategori
selective-catalog	Pilihan berkualitas tinggi yang dikurasi	Pilihan premium
speculative	Peluang berisiko tinggi, imbalan tinggi	Strategi agresif
top-bsr	Pemimpin Peringkat Penjual Terbaik	Pemimpin pasar

Struktur Proyek

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

Persyaratan

• Python 3.8+ (hanya stdlib, nol dependensi pip)
• Kunci API ZooData (dapatkan yang gratis)

Berkontribusi

Kami menyambut kontribusi! Silakan lihat CONTRIBUTING.md untuk panduan.

Komunitas

• 💬 Discord — Mengobrol, dapatkan bantuan, bagikan apa yang Anda bangun
• 🐛 Masalah — Laporan bug dan permintaan fitur
• 📖 Dokumentasi API — Dokumentasi API lengkap

Lisensi

MIT © SerendipityOne Inc.