APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

Ajanlar için inşa edilmiş veri altyapısı.
Şu anda 200 milyondan fazla ürün, 1 milyardan fazla yorum ve gerçek zamanlı sinyallerle Amazon ticaretine güç veriyor.

Web Sitesi • API Anahtarı Al • Discord • Hızlı Başlangıç • API Referansı

---

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. Yapay zeka ajanlarınıza Amazon ticaret sinyallerine doğrudan erişim sağlayan amaca yönelik bir veri katmanı — 200 milyondan fazla indekslenmiş ürün, 2 yılı aşkın geçmiş ve 1 milyardan fazla yorum, yapılandırılmış içgörülere önceden işlenmiş. Temiz JSON, gerçek zamanlı, ajan kullanımına hazır.

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

Beceri Genel Bakışı

Bu repo, iki kademede düzenlenmiş 11 ajan becerisi içerir:

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

Beceri	Ne Yapar	Girdi	Çıktı	Temel Avantaj
📦 zoodata/	11 API uç noktasının tümüne doğrudan erişim — kategoriler, pazarlar, ürünler, rakipler, gerçek zamanlı, yorumlar, fiyat bantları, markalar, geçmiş	Anahtar kelime, kategori, ASIN veya marka	Alan eşleme ve tuhaflık belgeleriyle ham API verisi	Eksiksiz API referansı — diğer tüm beceriler 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 + amaç	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/	8 anahtar kelime trafiği uç noktası üzerine inşa edilmiş anahtar kelime zekası iş akışları	Tohum anahtar kelime, hedef anahtar kelime, ASIN veya ASIN + anahtar kelime	Genişletme kademeleri, tek anahtar kelime kararları, ters ASIN trafik terimleri, anomali açıklamaları	Anahtar kelime genişletme, ters ASIN ve anahtar kelime trafiği izleme için özel akışlar

⚡ Uzmanlaşmış — belirli iş akışları için amaca yönelik inşa edilmiş:

Beceri	Ne Yapar	Girdi	Çıktı	Temel Avantaj
⚔️ amazon-competitor-intelligence-monitor/	Derin rakip zekası — 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 ani artışları	ASIN'leriniz (1-10) + anahtar kelime	KIRMIZI/SARI/YEŞİL uyarılar, KPI panosu, rakip hareketi, eylem öğeleri	Sinyal doğrulamalı kur ve unut (tek günlük ani artışlara karşı 7+ günlük trendler)
✅ amazon-listing-audit-pro/	Optimizasyon önerileriyle 8 boyutlu liste sağlık kontrolü	ASIN'iniz + anahtar kelime	Puan (X/100, A-F), 8 boyutlu puan 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İR/DİKKAT/KAÇIN kararı verir	Anahtar kelime veya kategori yolu	Alt pazar manzarası, karar, pazar genel görünümü, marka manzarası, giriş stratejisi	Çift seviyeli CR10 kontrolüyle otomatik alt pazar keşfi
📈 amazon-market-trend-scanner/	Kategori manzarası taraması — trend olan alt kategoriler, yükselen nişler, pazar değişimleri	1+ kategori yolu veya anahtar kelime	Trend panosu, Sıcak Kategoriler İLK 5, yeni giren taraması, risk uyarıları	TÜM alt kategorilerde kategori seviyesinde trend analizi
💎 amazon-opportunity-discoverer/	Profile dayalı fırsat tarayıcısı — 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ı	Profile dayalı strateji otomatik seçimi + Hızlı Tarama (~10 kredi)
💰 amazon-pricing-command-center/	Veri odaklı fiyatlandırma sinyalleri — yaprak kategoriyi otomatik algılar, fiyatlandırma manzarasını analiz eder	Bir veya daha fazla ASIN	ARTIR/TUT/DÜŞÜR sinyali, fiyat bandı ısı haritası, rakip fiyat haritası, BuyBox analizi	Yalnızca ASIN girdisi (anahtar kelime gerekmez), Satış/Rekabet Oranı
💬 amazon-review-intelligence-extractor/	11 boyutta 1 milyardan fazla ö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ı	1 milyardan fazla önceden analiz edilmiş yorum (%95 token tasarrufu), 11 boyut

Hızlı Başlangıç

1. Becerileri Yükleyin

npx skills add SerendipityOneInc/ZooData-Skills

Hangi becerilerin yükleneceğini seçmeniz istenecektir:

🏗️ Temel:

• ZooData — Amazon Ticaret Verisi, 11 Uç Nokta
• Amazon Analizi — Tam Spektrumlu Araştırma ve Satıcı Zekası
• Amazon Anahtar Kelime Zekası — Genişletme, Ters ASIN ve İzleme

⚡ Uzmanlaşmış:

• Amazon Rakip Zekası Monitörü — Kademeli uyarılarla çift modlu rekabetçi zeka
• Amazon Günlük Pazar Radarı — Otomatik İzleme ve Uyarılar
• Amazon Liste Denetim Pro — 8 Boyutlu Sağlık Kontrolü
• Amazon Pazara Giriş Analizörü — GİR/DİKKAT/KAÇIN Kararları
• Amazon Pazar Trend Tarayıcısı — Günlük Kategori Radarı
• Amazon Fırsat Keşfedici — Niş Tarayıcı ve Puanlama
• Amazon Fiyatlandırma Komuta Merkezi — ARTIR/TUT/DÜŞÜR Sinyalleri
• Amazon Yorum Zekası Çıkarıcı — 1 Milyardan Fazla Yorumdan Tüketici İçgörüleri

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 kademe: Kayıtta 1.000 kredi. 1 kredi = 1 API çağrısı. Kredi kartı gerekmez.

3. Deneyin

Yapay zeka ajanınıza sorun:

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

Veya doğrudan CLI kullanın:

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

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	13 ön ayar modu, 20'den fazla filtreyle ürün arama	"4+ yıldızlı, 80 doların altında koşu ayakkabısı bul"
📊 markets/search	Pazar seviyesi metrikler — yoğunlaşma, marka payı, fiyatlandırma	"Yoga matı pazarı ne kadar rekabetçi?"
🏷️ products/competitors	Anahtar kelime, marka veya ASIN'e göre 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ı getir"
💬 reviews/analysis	Yapay zeka destekli yorum içgörüleri — duygu, sorun noktaları	"Müşteriler bu ürün hakkında neyi seviyor/sevmiyor?"
📁 categories	Amazon kategori ağacı navigasyonu	"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ı dağılımını göster"
🏢 products/brand-overview	En iyi marka yoğunlaşma metrikleri (CR10)	"Marka manzarası ne kadar yoğunlaşmış?"
🏷️ products/brand-detail	En iyi ürünlerle marka bazında dağılım	"Bu kategoriye hangi markalar hakim?"
📅 products/history	ASIN'ler için geçmiş 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

products/search uç noktası, farklı araştırma stratejileri için 13 ön ayar modunu destekler:

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ı tarafından gönderime uygun	Düşük yatırımlı başlangıç
low-price	Bütçe dostu ürünler	Hacim stratejisi
single-variant	Basit listelemeler, 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 görünümü
selective-catalog	Seçilmiş yüksek kaliteli seçimler	Premium seçki
speculative	Yüksek risk, yüksek ödül fırsatları	Agresif strateji
top-bsr	En Çok Satanlar Sıralaması liderleri	Pazar liderleri

Proje Yapısı

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

Gereksinimler

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

Katkıda Bulunma

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

Topluluk

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

Lisans

MIT © SerendipityOne Inc.