What is ZooData?
ZooData is the data infrastructure built for agents. Not a scraping API. Not a human dashboard. A purpose-built data layer that gives your AI agents direct access to Amazon commerce signals โ 200M+ indexed products, 2+ years of history, and 1B+ reviews pre-processed into structured insights. Clean JSON, real-time, agent-ready.
https://github.com/user-attachments/assets/305a161b-7a53-49b8-afdc-4469a4fbf361
SPU market contracts require the matching service deployment and updated installed skills; see market migration.
Skills Overview
This repo contains 10 agent skills organized in two tiers:
๐๏ธ Foundation โ data access and full-spectrum analysis:
โก Specialized โ purpose-built for specific workflows:
amazon-market-analysis is the unified market skill. The former amazon-market-entry-analyzer, amazon-market-trend-scanner, and amazon-opportunity-discoverer directories are retained as retired source only; their entrypoints are named RETIRED.md, so skill installers and publishers do not discover them.
Quick Start
1. Install the Skills
npx skills add SerendipityOneInc/ZooData-Skills
You'll be prompted to select which skills to install:
๐๏ธ Foundation:
- ZooData โ 36 Amazon Commerce and Keyword Intelligence Endpoints
- Amazon Analysis โ Full-Spectrum Research & Seller Intelligence
- Amazon Keyword Intelligence โ Expansion, Reverse ASIN & Monitoring
- Amazon Market Analysis โ Discovery, Entry & Change
โก Specialized:
- 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 Pricing Command Center โ RAISE/HOLD/LOWER Signals
- Amazon Review Intelligence Extractor โ Consumer Insights from 1B+ Reviews
- Web Extract โ Structured public web data extraction
Or clone manually:
git clone https://github.com/SerendipityOneInc/ZooData-Skills.git
2. Set Your API Key
export ZOODATA_API_KEY='hms_live_xxx' # Get yours free at zoodata.ai/en/api-keys
๐ Free tier: 1,000 credits on signup. 1 credit = 1 API call. No credit card required.
3. Try It
Ask your AI agent:
"Analyze the competitive landscape for wireless earbuds under $50 on Amazon US"
Or use the CLI directly:
python amazon-analysis/scripts/zoodata.py products --keyword "wireless earbuds" --mode fast-movers
API Endpoints
Base URL: https://api.zoodata.ai/openapi/v2
Auth: Authorization: Bearer $ZOODATA_API_KEY
Method: All endpoints use POST with JSON body
13 Product Search Modes
The skill CLI (zoodata.py --mode) provides 13 preset modes for different research strategies. Modes are expanded into concrete filter fields (monthlySalesMin, salesGrowthRateMin, โฆ) on the client side โ mode is not an API parameter, and sending it to /openapi/v2/products/search returns 422:
Project Structure
โโโ 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
Requirements
- Python 3.8+ (stdlib only, zero pip dependencies)
- ZooData API Key (get one free)
Contributing
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
Community
- ๐ฌ Discord โ Chat, get help, share what you're building
- ๐ Issues โ Bug reports and feature requests
- ๐ API Docs โ Full API documentation