APIClaw — Amazon Data API for AI Agents

官方

專為AI代理打造的即時亞馬遜數據API。超過2億件商品、10億則評論、即時BSR、定價及競爭對手數據,以乾淨JSON格式提供。10項代理技能,涵蓋市場研究、競爭對手監控、定價、商品頁面審核等。提供1,000點免費額度。

你可以用 APIClaw — Amazon Data API For AI Agents MCP 做什麼?

  • 競爭態勢分析 — 請您的助理使用 amazon-competitor-intelligence-monitor/ 分析某個關鍵字或 ASIN 的競爭對手,回傳競爭者矩陣、品牌排名與分級警示。
  • 市場機會探索 — 請您的助理使用 amazon-market-analysis/ 評估市場進入條件並追蹤類目變化,產出產品候選清單與進入評估。
  • Listing 健康度稽核 — 透過 amazon-listing-audit-pro/ 取得 8 個維度的 Listing 評分卡,包含優先修正項目與關鍵字缺口,並提供可操作的改寫建議。
  • 定價訊號建議 — 僅需輸入 ASIN,即可使用 amazon-pricing-command-center/ 取得 RAISE/HOLD/LOWER 訊號、價格帶熱圖與 BuyBox 分析。
  • 消費者評論洞察 — 使用 amazon-review-intelligence-extractor/ 從超過 10 億筆預先分析的評論中,萃取 11 個維度的痛點、購買因素與使用模式。
  • 每日市場監控 — 使用 amazon-daily-market-radar/ 設定價格變動、新競爭者、BSR 波動與評論暴增的自動警示,並提供 RED/YELLOW/GREEN 訊號。

文件

English | 中文

ZooData Skills

為 AI 代理打造的資料基礎設施。
目前為 Amazon 商務提供支援,涵蓋超過 2 億件商品、10 億則評論,以及即時信號。

Tests License API Discord Stars

網站 • 取得 API 金鑰 • Discord • 快速入門 • API 參考


ZooData 是什麼?

ZooData 是為 AI 代理打造的資料基礎設施。它不是爬蟲 API,也不是給人用的儀表板,而是一個專用的資料層,讓你的 AI 代理能直接存取 Amazon 商務信號——超過 2 億件已索引商品、2 年以上歷史資料,以及超過 10 億則評論,皆已預處理為結構化洞察。乾淨的 JSON、即時、代理就緒。

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

技能總覽

此儲存庫包含 10 個代理技能,分為兩個層級:

🏗️ 基礎 — 資料存取與全光譜分析:

技能功能輸入輸出主要優勢
📦 zoodata/直接存取 25 個 Amazon 商務與關鍵字情報端點關鍵字、類別、ASIN 或品牌原始 API 資料,含欄位對應與特殊情況文件完整 API 參考——其他所有技能皆以此為基礎
🎯 amazon-analysis/13 種內建選取模式 + 市場研究、競爭者分析、ASIN 評估、定價、類別研究關鍵字/類別/ASIN + 意圖分析發現、熱門商品、ASIN 深入分析、附信心標記的洞察複合指令(report、opportunity)可一次執行多端點管線
🔎 amazon-keyword-traffic-analysis/基於 11 個關鍵字情報端點的關鍵字價值與商品流量健康度工作流程種子關鍵字、目標關鍵字、ASIN 或 ASIN + 關鍵字擴展層級、關鍵字價值分析、商品流量結構、趨勢與健康度診斷專用流程:關鍵字擴展、關鍵字分析、商品流量分析
📊 amazon-market-analysis/發掘市場與商品候選者、評估進入條件、追蹤類別變化市場問題、類別或商品機會簡報觀察清單、條件式進入評估或有限趨勢分析單一連貫故事,含獨立證據與賣家決策邊界

⚡ 專業 — 為特定工作流程量身打造:

技能功能輸入輸出主要優勢
⚔️ amazon-competitor-intelligence-monitor/深度競爭者情報——完整掃描或快速檢查,含分層警報關鍵字或 ASIN,可選你的 ASIN + 競爭者 ASIN競爭者矩陣、品牌排名、價格地圖、30 天趨勢、評分(1-100)、分層警報雙模式(完整約 28-35 點數、快速約 5-10)搭配三層警報系統
📡 amazon-daily-market-radar/自動化每日監控——價格變動、新競爭者、BSR 變動、評論激增你的 ASIN(1-10 個)+ 關鍵字紅/黃/綠警報、KPI 儀表板、競爭者動態、行動項目設定後即可忽略,含信號驗證(7 天以上趨勢 vs 單日激增)
✅ amazon-listing-audit-pro/8 維度商品頁健康度檢查,含最佳化建議你的 ASIN + 關鍵字評分(X/100,A-F)、8 維度評分卡、關鍵字缺口、優先修復清單使用高頻評論語言提供可執行改寫;支援批次稽核
💰 amazon-pricing-command-center/資料驅動的定價信號——自動偵測葉類別、分析定價環境一個或多個 ASIN調漲/維持/調降信號、價格帶熱圖、競爭者價格地圖、BuyBox 分析僅需 ASIN 輸入(無需關鍵字)、銷售/競爭比率
💬 amazon-review-intelligence-extractor/來自超過 10 億則預分析評論的深度消費者洞察,涵蓋 11 個維度單一 ASIN、多個 ASIN 或類別關鍵字痛點、購買因素、使用者輪廓、使用模式、差異化路線圖超過 10 億則預分析評論(節省 95% token)、11 個維度
🌐 web-extract/從公開網頁與搜尋結果中提取結構化資料URL、搜尋查詢或網站結構化 JSON 或頁面內容可處理渲染頁面與有限網站爬取

amazon-market-analysis 是統一的市場技能。先前的 amazon-market-entry-analyzer、amazon-market-trend-scanner 與 amazon-opportunity-discoverer 目錄僅保留為已退役的原始碼;其進入點命名為 RETIRED.md,因此技能安裝程式與發布者不會發現它們。

快速入門

1. 安裝技能

npx skills add SerendipityOneInc/ZooData-Skills

系統會提示你選擇要安裝的技能:

🏗️ 基礎:

  • ZooData — 25 個 Amazon 商務與關鍵字情報端點
  • Amazon Analysis — 全光譜研究與賣家情報
  • Amazon Keyword Intelligence — 擴展、反向 ASIN 與監控
  • Amazon Market Analysis — 發掘、進入與變化

⚡ 專業:

  • Amazon Competitor Intelligence Monitor — 雙模式競爭情報,含分層警報
  • Amazon Daily Market Radar — 自動化監控與警報
  • Amazon Listing Audit Pro — 8 維度健康度檢查
  • Amazon Pricing Command Center — 調漲/維持/調降信號
  • Amazon Review Intelligence Extractor — 來自超過 10 億則評論的消費者洞察
  • Web Extract — 結構化公開網路資料提取

或手動複製:

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

2. 設定你的 API 金鑰

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

🎁 免費方案:註冊即贈 1,000 點數。1 點數 = 1 次 API 呼叫。無需信用卡。

3. 試試看

詢問你的 AI 代理:

「分析 Amazon 美國站 50 美元以下無線耳機的競爭環境」

或直接使用 CLI:

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

API 端點

基礎 URL: https://api.zoodata.ai/openapi/v2 驗證: Authorization: Bearer $ZOODATA_API_KEY 方法: 所有端點皆使用 POST 搭配 JSON 請求主體

端點說明範例使用情境
🔍 products/search商品搜尋,含 20+ 篩選器(透過 CLI 提供 13 種預設模式)「尋找 80 美元以下、4 星以上的跑鞋」
📊 markets/search類別發掘與精確快照——規模、集中度、精選 Top 100 定價「瑜珈墊市場的競爭程度如何?」
🧩 markets/structure-profile品牌、價格及其他 Top 100 分佈「哪些價格帶貢獻了銷售?」
📅 markets/history可用的月底類別市場趨勢「這個類別每月如何變化?」
🏷️ products/competitors依關鍵字、品牌或 ASIN 發掘競爭者「這個利基市場的頂級賣家是誰?」
⚡ realtime/product即時商品詳細資料——評論、特色、變體「取得 ASIN B0D5CRV4KL 的目前詳細資料」
💬 reviews/analysisAI 驅動的評論洞察——情緒、痛點「顧客對這項產品的喜愛/厭惡之處?」
📁 categoriesAmazon 類別樹導覽「顯示 Electronics 下的子類別」
📈 products/price-band-overview價格帶摘要,含最佳機會帶「瑜珈墊的最佳價格範圍為何?」
📊 products/price-band-detail完整 5 帶價格分佈分析「顯示無線耳機的詳細價格帶分佈」
🏢 products/brand-overview頂級品牌集中度指標(CR10)「品牌環境的集中度如何?」
🏷️ products/brand-detail各品牌分項,含熱門商品「哪些品牌主導此類別?」
📅 products/historyASIN 的歷史每日快照「顯示此 ASIN 的價格與 BSR 歷史」

13 種商品搜尋模式

技能 CLI(zoodata.py --mode)提供 13 種預設模式,適用於不同研究策略。模式會在客戶端展開為具體的篩選欄位(monthlySalesMin、salesGrowthRateMin、…)——mode 不是 API 參數,將其傳送至 /openapi/v2/products/search 會回傳 422:

模式策略目標
fast-movers高銷售速度快速營收
emerging上升趨勢、低飽和度早期進入者
long-tail利基關鍵字、穩定需求永續收入
underserved高需求、少賣家市場缺口
new-release近期推出的商品熱門商品
fbm-friendly適合賣家配送低投資起步
low-price預算友善商品量販策略
single-variant簡單商品頁、無變體輕鬆管理
high-demand-low-barrier高銷售、低評論門檻可擴展進入
broad-catalog廣泛商品範圍分析類別總覽
selective-catalog精選高品質選擇優質選品
speculative高風險、高報酬機會積極策略
top-bsrBest Seller Rank 領先者市場領導者

專案結構

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

需求

  • Python 3.8+(僅標準函式庫,零 pip 依賴)
  • ZooData API 金鑰(免費取得)

貢獻

我們歡迎貢獻!請參閱 CONTRIBUTING.md 了解指南。

社群

  • 💬 Discord — 聊天、尋求協助、分享你的作品
  • 🐛 Issues — 錯誤回報與功能請求
  • 📖 API Docs — 完整 API 文件

授權

MIT © SerendipityOne Inc.