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 destekliyor.

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 paneli değil. AI ajanlarınıza Amazon ticaret sinyallerine doğrudan erişim sağlayan, amaca yönelik bir veri katmanıdır — 200M+ dizinlenmiş ü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

Becerilere Genel Bakış

Bu depo, iki katman halinde düzenlenmiş 10 ajan becerisi içerir:

🏗️ Temel — veri erişimi ve tam spektrum analizi:

Beceri	Ne Yapar	Girdi	Çıktı	Temel Avantaj
📦 zoodata/	25 Amazon ticaret ve anahtar kelime zekası uç noktasına doğrudan erişim	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 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 + niyet	Analiz bulguları, en iyi ürünler, ASIN derinlemesine incelemeler, 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/	11 anahtar kelime zekası 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 katmanları, 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
📊 amazon-market-analysis/	Pazar ve ürün adaylarını keşfedin, giriş koşullarını değerlendirin ve kategori değişikliklerini takip edin	Pazar sorusu, kategori veya ürün fırsat özeti	Gözlemlenen kısa liste, koşullu giriş değerlendirmesi veya sınırlı trend analizi	Ayrı kanıt ve satıcı karar sınırlarıyla tek bir bağlantılı hikaye

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

Beceri	Ne Yapar	Girdi	Çıktı	Temel Avantaj
⚔️ amazon-competitor-intelligence-monitor/	Derin rakip zekası — katmanlı 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), katmanlı uyarılar	Çift modlu (Tam ~28-35 kredi, Hızlı ~5-10) üç katmanlı uyarı sistemiyle
📡 amazon-daily-market-radar/	Otomatik günlük izleme — fiyat değişiklikleri, yeni rakipler, BSR hareketleri, yorum artışları	Sizin ASIN'leriniz (1-10) + anahtar kelime	KIRMIZI/SARI/YEŞİL uyarılar, KPI paneli, rakip hareketi, eylem öğeleri	Sinyal doğrulamalı (7+ günlük trendler vs tek günlük artışlar) kur ve unut
✅ amazon-listing-audit-pro/	Optimizasyon önerileriyle 8 boyutlu liste sağlık kontrolü	Sizin 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 dili kullanarak uygulanabilir yeniden yazımlar; toplu denetim desteği
💰 amazon-pricing-command-center/	Veri odaklı fiyatlandırma sinyalleri — yaprak kategoriyi otomatik algılar, fiyatlandırma ortamı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ş yorumlardan 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 kalıpları, farklılaşma yol haritası	1B+ önceden analiz edilmiş yorum (%95 token tasarrufu), 11 boyut
🌐 web-extract/	Genel web sayfalarından ve arama sonuçlarından yapılandırılmış veri çıkarımı	URL, arama sorgusu veya site	Yapılandırılmış JSON veya sayfa içeriği	İşlenmiş sayfaları ve sınırlı site taramalarını yönetir

amazon-market-analysis birleşik pazar becerisidir. Eski amazon-market-entry-analyzer, amazon-market-trend-scanner ve amazon-opportunity-discoverer dizinleri yalnızca emekli kaynak olarak korunur; giriş noktaları RETIRED.md olarak adlandırılır, böylece beceri yükleyicileri ve yayıncıları bunları keşfetmez.

Hızlı Başlangıç

1. Becerileri Yükleyin

npx skills add SerendipityOneInc/ZooData-Skills

Hangi becerileri yüklemek istediğinizi seçmeniz istenecektir:

🏗️ Temel:

• ZooData — 25 Amazon Ticaret ve Anahtar Kelime Zekası Uç Noktası
• Amazon Analizi — Tam Spektrum Araştırma ve Satıcı Zekası
• Amazon Anahtar Kelime Zekası — Genişletme, Ters ASIN ve İzleme
• Amazon Pazar Analizi — Keşif, Giriş ve Değişim

⚡ Uzmanlaşmış:

• Amazon Rakip Zekası Monitörü — Katmanlı 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 Fiyatlandırma Komuta Merkezi — YÜKSELT/TUT/DÜŞÜR Sinyalleri
• Amazon Yorum Zekası Çıkarıcı — 1B+ Yorumdan Tüketici İçgörüleri
• Web Çıkarımı — Yapılandırılmış genel web verisi çıkarımı

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 doların altındaki kablosuz kulaklıklar için rekabet ortamını analiz et"

Veya CLI'yı 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 ön ayarlı mod)	"80 doların altında 4+ yıldızlı koşu ayakkabısı bul"
📊 markets/search	Kategori keşfi ve tam anlık görüntü — boyut, yoğunluk, seçili İlk 100 fiyatlandırması	"Yoga matı pazarı ne kadar rekabetçi?"
🧩 markets/structure-profile	Marka, fiyat ve diğer İlk 100 dağılımları	"Hangi fiyat bantları satışları oluşturuyor?"
📅 markets/history	Mevcut ay sonu kategori-pazar trendleri	"Bu kategori aylara göre nasıl değişti?"
🏷️ products/competitors	Anahtar kelime, marka veya ASIN ile rakip keşfi	"Bu nişteki en iyi satıcılar kim?"
⚡ 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, sorun noktaları	"Müşteriler bu ürünü neyi seviyor/sevmiyor?"
📁 categories	Amazon kategori ağacı gezinmesi	"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 ayrıntılı fiyat bandı dökümünü göster"
🏢 products/brand-overview	En iyi marka yoğunluğu metrikleri (CR10)	"Marka ortamı ne kadar yoğun?"
🏷️ products/brand-detail	En iyi ürünlerle marka bazında döküm	"Hangi markalar bu kategoriye 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

Beceri CLI'sı (zoodata.py --mode), farklı araştırma stratejileri için 13 ön ayarlı 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'a 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 öğeler
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	Seçilmiş yüksek kaliteli seçimler	Premium seçim
speculative	Yüksek riskli, yüksek ödüllü fırsatlar	Agresif strateji
top-bsr	En Çok Satanlar Sıralaması liderleri	Pazar liderleri

Proje Yapısı

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

Gereksinimler

• Python 3.8+ (yalnızca standart kütüphane, 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, ne inşa ettiğinizi paylaşın
• 🐛 Sorunlar — Hata raporları ve özellik istekleri
• 📖 API Dokümanları — Tam API dokümantasyonu

Lisans

MIT © SerendipityOne Inc.