APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

Ajanlar için inşa edilmiş veri altyapısı.
Şu anda 200M+ ürün, 1B+ yorum ve gerçek zamanlı sinyallerle Amazon ticaretini güçlendiriyor.

Website • Get API Key • Discord • Quick Start • API Reference

---

ZooData Nedir?

ZooData, ajanlar için inşa edilmiş veri altyapısıdır. Bir kazıma API'si değil. Bir insan panosu değil. AI ajanlarınıza Amazon ticaret sinyallerine doğrudan erişim sağlayan özel olarak tasarlanmış bir veri katmanı — 200M+ endeksli ürün, 2+ yıllık geçmiş ve yapılandırılmış içgörülere önceden işlenmiş 1B+ yorum. Temiz JSON, gerçek zamanlı, ajana hazır.

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

Yeteneklere Genel Bakış

Bu depo iki kademede düzenlenmiş 11 ajan yeteneği içerir:

🏗️ Temel — veri erişimi ve tam spektrumlu analiz:

Yetenek	Ne Yapar	Girdi	Çıktı	Temel Avantaj
📦 zoodata/	22 API uç noktasının tamamına doğrudan erişim — 12 ticaret uç noktası artı 10 anahtar kelime istihbaratı uç noktası	Anahtar kelime, kategori, ASIN veya marka	Alan eşleme ve tuhaflık dokümantasyonu ile ham API verisi	Eksiksiz API referansı — diğer tüm yetenekler bunun üzerine inşa edilir
🎯 amazon-analysis/	13 yerleşik seçim modu + pazar araştırması, rakip analizi, ASIN değerlendirmesi, fiyatlandırma, kategori araştırması	Anahtar kelime/kategori/ASIN + niyet	Analiz bulguları, en iyi ürünler, ASIN derinlemesine incelemeleri, güven etiketli içgörüler	Bileşik komutlar (report, opportunity) tek seferde çok uç noktalı işlem hatlarını çalıştırır
🔎 amazon-keyword-traffic-analysis/	10 anahtar kelime istihbaratı uç noktası üzerine inşa edilmiş anahtar kelime değeri ve ürün trafik sağlığı iş akışları	Tohum anahtar kelime, hedef anahtar kelime, ASIN veya ASIN + anahtar kelime	Genişletme kademeleri, anahtar kelime değeri analizi, ürün trafik yapısı, trendler ve sağlık teşhisi	Anahtar kelime genişletme, anahtar kelime analizi ve ürün trafik analizi için özel akışlar

⚡ Özel — belirli iş akışları için özel olarak tasarlanmış:

Yetenek	Ne Yapar	Girdi	Çıktı	Temel Avantaj
⚔️ amazon-competitor-intelligence-monitor/	Derin rakip istihbaratı — kademeli uyarılarla Tam Tarama veya Hızlı Kontrol	Anahtar kelime veya ASIN(ler), isteğe bağlı olarak sizin ASIN'iniz + rakip ASIN'ler	Rakip matrisi, marka sıralaması, fiyat haritası, 30 günlük trendler, puanlar (1-100), kademeli uyarılar	Üç kademeli uyarı sistemiyle çift mod (Tam ~28-35 kredi, Hızlı ~5-10)
📡 amazon-daily-market-radar/	Otomatik günlük izleme — fiyat değişiklikleri, yeni rakipler, BSR hareketleri, yorum artışları	ASIN'leriniz (1-10) + anahtar kelime	KIRMIZI/SARI/YEŞİL uyarılar, KPI panosu, rakip hareketleri, aksiyon maddeleri	Sinyal doğrulama ile kur ve unut (7+ günlük trendler vs tek günlük ani artışlar)
✅ amazon-listing-audit-pro/	Optimizasyon önerileriyle 8 boyutlu liste sağlık kontrolü	ASIN'iniz + anahtar kelime	Puan (X/100, A-F), 8 boyutlu skor kartı, anahtar kelime boşlukları, öncelikli düzeltme listesi	Yüksek frekanslı yorum dilini kullanan uygulanabilir yeniden yazımlar; toplu denetim desteği
🚪 amazon-market-entry-analyzer/	Tek tıkla pazar uygulanabilirliği — alt pazarları keşfeder, puanlar (1-100), GİT/DİKKAT/KAÇIN sonucu verir	Anahtar kelime veya kategori yolu	Alt pazar görünümü, karar, pazar genel bakışı, marka görünümü, giriş stratejisi	Çift seviyeli CR10 kontrolü ile otomatik alt pazar keşfi
📈 amazon-market-trend-scanner/	Kategori görünümü taraması — trend olan alt kategoriler, yükselen nişler, pazar değişimleri	1+ kategori yolu veya anahtar kelime	Trend panosu, En Popüler Kategoriler TOP 5, yeni giren taraması, risk uyarıları	TÜM alt kategorilerde kategori düzeyinde trend analizi
💎 amazon-opportunity-discoverer/	Profil odaklı fırsat tarayıcı — stratejileri otomatik seçer, gerçek zamanlı verilerle doğrular, 7 boyutlu puanlama	Bütçe + deneyim seviyesi + anahtar kelime/kategori	En iyi 10 fırsat (S/A/B/C), detaylı ilk 3 analizi, risk uyarıları	Profil odaklı strateji otomatik seçimi + Hızlı Tarama (~10 kredi)
💰 amazon-pricing-command-center/	Veri odaklı fiyatlandırma sinyalleri — yaprak kategoriyi otomatik tespit eder, fiyatlandırma görünümünü analiz eder	Bir veya daha fazla ASIN	YÜKSELT/TUT/DÜŞÜR sinyali, fiyat bandı ısı haritası, rakip fiyat haritası, BuyBox analizi	Yalnızca ASIN girişi (anahtar kelime gerekmez), Satış/Rekabet Oranı
💬 amazon-review-intelligence-extractor/	11 boyutta 1B+ önceden analiz edilmiş yorumdan derin tüketici içgörüleri	Tek ASIN, birden fazla ASIN veya kategori anahtar kelimesi	Sorun noktaları, satın alma faktörleri, kullanıcı profilleri, kullanım desenleri, farklılaşma yol haritası	1B+ önceden analiz edilmiş yorum (%95 token tasarrufu), 11 boyut

Hızlı Başlangıç

1. Yetenekleri Kurun

npx skills add SerendipityOneInc/ZooData-Skills

Hangi yetenekleri kuracağınızı seçmeniz istenecek:

🏗️ Temel:

• ZooData — Amazon Commerce Data, 11 Endpoints
• Amazon Analysis — Full-Spectrum Research & Seller Intelligence
• Amazon Keyword Intelligence — Expansion, Reverse ASIN & Monitoring

⚡ Özel:

• Amazon Competitor Intelligence Monitor — Dual-mode competitive intelligence with tiered alerts
• Amazon Daily Market Radar — Automated Monitoring & Alerts
• Amazon Listing Audit Pro — 8-Dimension Health Check
• Amazon Market Entry Analyzer — GO/CAUTION/AVOID Verdicts
• Amazon Market Trend Scanner — Daily Category Radar
• Amazon Opportunity Discoverer — Niche Scanner & Scoring
• Amazon Pricing Command Center — RAISE/HOLD/LOWER Signals
• Amazon Review Intelligence Extractor — Consumer Insights from 1B+ Reviews

Veya manuel olarak klonlayın:

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

2. API Anahtarınızı Ayarlayın

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

🎁 Ücretsiz katman: Kayıtta 1.000 kredi. 1 kredi = 1 API çağrısı. Kredi kartı gerekmez.

3. Deneyin

AI ajanınıza sorun:

"Amazon ABD'de 50$ altı kablosuz kulaklıklar için rekabet ortamını analiz et"

Veya CLI'ı doğrudan kullanın:

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

API Uç Noktaları

Temel URL: https://api.zoodata.ai/openapi/v2 Kimlik Doğrulama: Authorization: Bearer $ZOODATA_API_KEY Yöntem: Tüm uç noktalar JSON gövdesiyle POST kullanır

Uç Nokta	Açıklama	Örnek Kullanım Durumu
🔍 products/search	20+ filtreyle ürün arama (CLI üzerinden 13 hazır mod)	"80$ altı, 4+ yıldızlı koşu ayakkabısı bul"
📊 markets/search	Pazar düzeyi metrikleri — yoğunluk, marka payı, fiyatlandırma	"Yoga matı pazarı ne kadar rekabetçi?"
🏷️ products/competitors	Anahtar kelime, marka veya ASIN ile rakip keşfi	"Bu nişteki en iyi satıcılar kimler?"
⚡ realtime/product	Gerçek zamanlı ürün detayları — yorumlar, özellikler, varyantlar	"ASIN B0D5CRV4KL için güncel detayları al"
💬 reviews/analysis	AI destekli yorum içgörüleri — duygu analizi, sorun noktaları	"Müşteriler bu ürünün neyini seviyor/sevmiyor?"
📁 categories	Amazon kategori ağacı gezinme	"Elektronik altındaki alt kategorileri göster"
📈 products/price-band-overview	En iyi fırsat bandıyla fiyat bandı özeti	"Yoga matları için en iyi fiyat aralığı nedir?"
📊 products/price-band-detail	Tam 5 bantlı fiyat dağılımı analizi	"Kablosuz kulaklıklar için detaylı fiyat bandı dökümünü göster"
🏢 products/brand-overview	En iyi marka yoğunluğu metrikleri (CR10)	"Marka görünümü ne kadar yoğun?"
🏷️ products/brand-detail	En iyi ürünlerle marka bazında döküm	"Bu kategoride hangi markalar baskın?"
📅 products/history	ASIN'ler için tarihsel günlük anlık görüntüler	"Bu ASIN için fiyat ve BSR geçmişini göster"

13 Ürün Arama Modu

Yetenek CLI'ı (zoodata.py --mode) farklı araştırma stratejileri için 13 hazır mod sağlar. Modlar istemci tarafında somut filtre alanlarına (monthlySalesMin, salesGrowthRateMin, …) genişletilir — mode bir API parametresi değildir ve /openapi/v2/products/search'e gönderilmesi 422 döndürür:

Mod	Strateji	Hedef
fast-movers	Yüksek satış hızı	Hızlı gelir
emerging	Yükselen trendler, düşük doygunluk	Erken hareket edenler
long-tail	Niş anahtar kelimeler, istikrarlı talep	Sürdürülebilir gelir
underserved	Yüksek talep, az satıcı	Pazar boşlukları
new-release	Yakın zamanda piyasaya sürülen ürünler	Trend olan ürünler
fbm-friendly	Satıcı yerine getirmesi için uygun	Düşük yatırımla başlangıç
low-price	Bütçe dostu ürünler	Hacim stratejisi
single-variant	Basit listeler, varyantsız	Kolay yönetim
high-demand-low-barrier	Yüksek satış, düşük yorum engeli	Ölçeklenebilir giriş
broad-catalog	Geniş ürün yelpazesi analizi	Kategori genel bakışı
selective-catalog	Özenle seçilmiş yüksek kaliteli seçimler	Premium seçim
speculative	Yüksek riskli, yüksek ödüllü fırsatlar	Agresif strateji
top-bsr	Best Seller Rank liderleri	Pazar liderleri

Proje Yapısı

├── zoodata/                              # Data layer skill (lightweight)
│   ├── SKILL.md                            # 22 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-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

Gereksinimler

• Python 3.8+ (yalnızca stdlib, sıfır pip bağımlılığı)
• ZooData API Anahtarı (ücretsiz edinin)

Katkıda Bulunma

Katkılarınızı memnuniyetle karşılıyoruz! Yönergeler için lütfen CONTRIBUTING.md dosyasına bakın.

Topluluk

• 💬 Discord — Sohbet edin, yardım alın, neler inşa ettiğinizi paylaşın
• 🐛 Sorunlar — Hata raporları ve özellik istekleri
• 📖 API Dokümanları — Tam API dokümantasyonu

Lisans

MIT © SerendipityOne Inc.