Apiclaw — Amazon Data Api For Ai Agents

英語 | 中文

ZooData Skills

エージェントのために構築されたデータインフラストラクチャ。
現在、2億点以上の商品、10億件以上のレビュー、リアルタイムシグナルを活用し、Amazonコマースを支えています。

ウェブサイト • API キーを取得 • Discord • クイックスタート • API リファレンス

---

ZooData とは？

ZooData は、エージェントのために構築されたデータインフラストラクチャです。スクレイピング API でも、人間向けのダッシュボードでもありません。AI エージェントがAmazonコマースのシグナルに直接アクセスできるようにする、専用に構築されたデータレイヤーです。インデックス化された2億点以上の商品、2年以上の履歴、構造化されたインサイトに事前処理された10億件以上のレビューを利用できます。クリーンなJSON、リアルタイム、エージェント対応です。

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

SPUマーケット契約には、対応するサービスのデプロイと、インストール済みスキルの更新が必要です。詳しくはマーケット移行をご覧ください。

スキルの概要

このリポジトリには、2つの階層に分類された10個のエージェントスキルが含まれています。

🏗️ 基盤 — データアクセスと包括的な分析：

スキル	機能	入力	出力	主な利点
📦 zoodata/	Amazonコマースとキーワードインテリジェンスの36個のエンドポイントに直接アクセス	キーワード、カテゴリ、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）、段階別アラート	2つのモード（フル：約28〜35クレジット、クイック：約5〜10クレジット）と3段階のアラートシステム
📡 amazon-daily-market-radar/	価格変動、新規競合、BSRの変動、レビュー急増を自動で毎日モニタリング	自社ASIN（1〜10件）とキーワード	RED／YELLOW／GREENアラート、KPIダッシュボード、競合の動向、アクション項目	シグナル検証機能（単日の急増ではなく、7日以上のトレンドを確認）を備えた、設定後は手間のかからない運用
✅ amazon-listing-audit-pro/	8つの側面から出品情報の健全性を確認し、最適化の提案を提示	自社ASINとキーワード	スコア（X/100、A〜F）、8項目のスコアカード、キーワードの不足箇所、優先修正リスト	頻出するレビュー表現を活用した、すぐに使える書き換え案。一括監査にも対応
💰 amazon-pricing-command-center/	データに基づく価格シグナル — サブカテゴリを自動検出し、価格環境を分析	1件以上のASIN	RAISE／HOLD／LOWERシグナル、価格帯ヒートマップ、競合価格マップ、BuyBox分析	ASINのみで入力でき（キーワード不要）、売上／競争比率を確認可能
💬 amazon-review-intelligence-extractor/	11の側面にわたり事前分析された10億件以上のレビューから、消費者のインサイトを詳細に抽出	単一ASIN、複数のASIN、またはカテゴリキーワード	不満点、購入要因、ユーザープロファイル、利用パターン、差別化ロードマップ	事前分析済みの10億件以上のレビュー（トークンを95％削減）、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 — Amazonのコマースとキーワード分析に関する36のエンドポイント
• Amazon Analysis — あらゆる領域のリサーチとセラーインテリジェンス
• Amazon Keyword Intelligence — キーワードの拡張、リバースASIN、モニタリング
• Amazon Market Analysis — 発見、市場参入、変化の分析

⚡ 特化型：

• Amazon Competitor Intelligence Monitor — 段階別アラート付きの2モード対応競合インテリジェンス
• Amazon Daily Market Radar — 自動モニタリングとアラート
• Amazon Listing Audit Pro — 8項目の健全性チェック
• Amazon Pricing Command Center — RAISE／HOLD／LOWERシグナル
• 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クレジットでAPIを1回呼び出せます。クレジットカードは不要です。

3. 試してみる

AIエージェントに次のように尋ねます。

「Amazon USで販売されている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 メソッド: すべてのエンドポイントで、JSON 本文を指定して POST を使用します

エンドポイント	説明	使用例
🔍 products/search	20 以上のフィルターによる商品検索（CLI から利用できる 13 種類のプリセットモード）	「星 4 以上で、80 ドル未満のランニングシューズを探す」
📊 markets/search	カテゴリーの調査と正確なスナップショット — 市場規模、集中度、選択した Top 100 の価格	「ヨガマット市場の競争状況は？」
🧩 markets/profile	SPU プロファイルと、独立した分布・集中度の分析ルート	「売上を占める価格帯は？」
📅 markets/history	公開済みの SPU カテゴリー市場動向	「このカテゴリーは月ごとにどう変化した？」
🏷️ products/competitors	キーワード、ブランド、または ASIN による競合調査	「このニッチ市場のトップセラーは？」
⚡ realtime/product	商品のリアルタイム情報 — レビュー、特徴、バリエーション	「ASIN B0D5CRV4KL の最新情報を取得する」
💬 reviews/analysis	AI を活用したレビュー分析 — 感情、課題点	「顧客がこの商品を気に入っている点、気に入らない点は？」
📁 categories	Amazon カテゴリーツリーのナビゲーション	「エレクトロニクスのサブカテゴリーを表示する」
📈 products/price-band-overview	最適な機会価格帯を含む価格帯の概要	「ヨガマットに最適な価格帯は？」
📊 products/price-band-detail	5 つの価格帯にわたる詳細な価格分布分析	「ワイヤレスイヤホンの価格帯の内訳を詳しく表示する」
🏢 products/brand-overview	上位ブランドの集中度指標（CR10）	「ブランドの市場集中度は？」
🏷️ products/brand-detail	ブランド別の内訳と上位商品	「このカテゴリーを支配しているブランドは？」
📅 products/history	ASIN の過去の日次スナップショット	「この 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-bsr	ベストセラーランキング上位商品	市場の主要商品

プロジェクト構成

├── zoodata/                              # Data layer skill (lightweight)
│   ├── SKILL.md                            # 36 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 ドキュメント — API の完全なドキュメント

ライセンス

MIT © Serendipity One Inc.