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 real-time.

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 dirancang 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, real-time, siap untuk agen.

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

Ringkasan Keterampilan

Repositori ini berisi 10 keterampilan agen yang diorganisir dalam dua tingkatan:

🏗️ Fondasi — akses data dan analisis spektrum penuh:

Keterampilan	Fungsinya	Input	Output	Keunggulan Utama
📦 zoodata/	Akses langsung ke 25 endpoint perdagangan Amazon dan intelijen kata kunci	Kata kunci, kategori, ASIN, atau merek	Data API mentah dengan pemetaan kolom dan dokumentasi keanehan	Referensi API lengkap — setiap keterampilan lain dibangun di atas ini
🎯 amazon-analysis/	13 mode pemilihan bawaan + riset pasar, analisis pesaing, evaluasi ASIN, penetapan harga, riset kategori	Kata kunci/kategori/ASIN + niat	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 nilai kata kunci dan kesehatan lalu lintas produk yang dibangun di atas 11 endpoint intelijen kata kunci	Kata kunci awal, kata kunci target, ASIN, atau ASIN + kata kunci	Tingkat ekspansi, analisis nilai kata kunci, struktur lalu lintas produk, tren, dan diagnosis kesehatan	Alur khusus untuk ekspansi kata kunci, analisis kata kunci, dan analisis lalu lintas produk
📊 amazon-market-analysis/	Temukan kandidat pasar dan produk, evaluasi kondisi masuk, dan lacak perubahan kategori	Pertanyaan pasar, kategori, atau ringkasan peluang produk	Daftar pendek teramati, penilaian masuk bersyarat, atau analisis tren terbatas	Satu cerita terhubung dengan bukti terpisah dan batas keputusan penjual

⚡ Khusus — dibangun khusus untuk alur kerja tertentu:

Keterampilan	Fungsinya	Input	Output	Keunggulan Utama
⚔️ amazon-competitor-intelligence-monitor/	Intelijen pesaing mendalam — Pemindaian Penuh atau Pemeriksaan Cepat dengan peringatan berjenjang	Kata kunci atau ASIN, opsional ASIN Anda + ASIN pesaing	Matriks pesaing, peringkat merek, peta harga, tren 30 hari, skor (1-100), peringatan berjenjang	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 optimasi	ASIN Anda + kata kunci	Skor (X/100, A-F), kartu skor 8 dimensi, celah kata kunci, daftar perbaikan prioritas	Penulisan ulang yang dapat ditindaklanjuti menggunakan bahasa ulasan frekuensi tinggi; dukungan audit massal
💰 amazon-pricing-command-center/	Sinyal penetapan harga berbasis data — mendeteksi kategori daun secara otomatis, menganalisis lanskap penetapan harga	Satu atau lebih ASIN	Sinyal NAIK/TAHAN/TURUN, peta panas rentang harga, peta harga pesaing, analisis BuyBox	Input hanya ASIN (tanpa kata kunci), Rasio Penjualan/Persaingan
💬 amazon-review-intelligence-extractor/	Wawasan konsumen mendalam dari 1 miliar+ ulasan pra-analisis 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 pra-analisis (hemat token 95%), 11 dimensi
🌐 web-extract/	Ekstraksi data terstruktur dari halaman web publik dan hasil pencarian	URL, kueri pencarian, atau situs	JSON terstruktur atau konten halaman	Menangani halaman yang dirender dan perayapan situs terbatas

amazon-market-analysis adalah keterampilan pasar terpadu. Direktori amazon-market-entry-analyzer, amazon-market-trend-scanner, dan amazon-opportunity-discoverer sebelumnya dipertahankan hanya sebagai sumber yang dihentikan; titik masuknya diberi nama RETIRED.md, sehingga penginstal dan penerbit keterampilan tidak menemukannya.

Mulai Cepat

1. Instal Keterampilan

npx skills add SerendipityOneInc/ZooData-Skills

Anda akan diminta untuk memilih keterampilan mana yang akan diinstal:

🏗️ Fondasi:

• ZooData — 25 Endpoint Perdagangan Amazon dan Intelijen Kata Kunci
• Analisis Amazon — Riset Spektrum Penuh & Intelijen Penjual
• Intelijen Kata Kunci Amazon — Ekspansi, Reverse ASIN & Pemantauan
• Analisis Pasar Amazon — Penemuan, Masuk & Perubahan

⚡ Khusus:

• Monitor Intelijen Pesaing Amazon — Intelijen kompetitif mode ganda dengan peringatan berjenjang
• Radar Pasar Harian Amazon — Pemantauan & Peringatan Otomatis
• Audit Daftar Pro Amazon — Pemeriksaan Kesehatan 8 Dimensi
• Pusat Komando Penetapan Harga Amazon — Sinyal NAIK/TAHAN/TURUN
• Ekstraktor Intelijen Ulasan Amazon — Wawasan Konsumen dari 1 Miliar+ Ulasan
• Ekstraksi Web — Ekstraksi data web publik terstruktur

Atau klon 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. Coba

Tanyakan agen AI Anda:

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

Atau gunakan CLI secara langsung:

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

Endpoint API

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

Endpoint	Deskripsi	Contoh Kasus Penggunaan
🔍 products/search	Pencarian produk dengan 20+ filter (13 mode preset melalui CLI)	"Temukan sepatu lari di bawah $80 dengan bintang 4+"
📊 markets/search	Penemuan kategori dan snapshot tepat — ukuran, konsentrasi, penetapan harga Top 100 terpilih	"Seberapa kompetitif pasar alas yoga?"
🧩 markets/structure-profile	Distribusi merek, harga, dan Top 100 lainnya	"Rentang harga mana yang menyumbang penjualan?"
📅 markets/history	Tren pasar kategori akhir bulan yang tersedia	"Bagaimana kategori ini berubah per bulan?"
🏷️ products/competitors	Penemuan pesaing berdasarkan kata kunci, merek, atau ASIN	"Siapa penjual teratas di niche ini?"
⚡ realtime/product	Detail produk real-time — ulasan, fitur, varian	"Dapatkan detail saat ini untuk ASIN B0D5CRV4KL"
💬 reviews/analysis	Wawasan ulasan bertenaga AI — sentimen, poin masalah	"Apa yang disukai/tidak disukai pelanggan tentang produk ini?"
📁 categories	Navigasi pohon kategori Amazon	"Tampilkan subkategori di bawah Elektronik"
📈 products/price-band-overview	Ringkasan rentang harga dengan peluang terbaik	"Berapa kisaran harga terbaik untuk alas yoga?"
📊 products/price-band-detail	Analisis distribusi harga 5 pita lengkap	"Tampilkan rincian rentang harga untuk earbuds 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	Snapshot harian historis untuk ASIN	"Tampilkan riwayat harga dan BSR untuk ASIN ini"

13 Mode Pencarian Produk

CLI keterampilan (zoodata.py --mode) menyediakan 13 mode preset untuk berbagai strategi riset. Mode diperluas menjadi kolom filter konkret (monthlySalesMin, salesGrowthRateMin, …) di sisi klien — mode bukan parameter API, dan mengirimkannya ke /openapi/v2/products/search mengembalikan 422:

Mode	Strategi	Target
fast-movers	Kecepatan penjualan tinggi	Pendapatan cepat
emerging	Tren naik, saturasi rendah	Penggerak awal
long-tail	Kata kunci niche, permintaan stabil	Pendapatan berkelanjutan
underserved	Permintaan tinggi, sedikit penjual	Celah pasar
new-release	Produk yang baru diluncurkan	Item tren
fbm-friendly	Cocok untuk pemenuhan pedagang	Mulai 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	Gambaran kategori
selective-catalog	Pilihan berkualitas tinggi yang dikurasi	Seleksi 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                            # 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

Persyaratan

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

Kontribusi

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

Komunitas

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

Lisensi

MIT © SerendipityOne Inc.