APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

Cơ sở hạ tầng dữ liệu được xây dựng cho tác nhân AI.
Hiện đang hỗ trợ thương mại Amazon với hơn 200 triệu sản phẩm, hơn 1 tỷ đánh giá và các tín hiệu thời gian thực.

Trang web • Lấy Khóa API • Discord • Bắt đầu nhanh • Tham khảo API

---

ZooData là gì?

ZooData là cơ sở hạ tầng dữ liệu được xây dựng cho tác nhân AI. Không phải API thu thập dữ liệu. Không phải bảng điều khiển cho con người. Một lớp dữ liệu được xây dựng có mục đích, cung cấp cho tác nhân AI của bạn quyền truy cập trực tiếp vào các tín hiệu thương mại Amazon — hơn 200 triệu sản phẩm được lập chỉ mục, hơn 2 năm lịch sử và hơn 1 tỷ đánh giá được xử lý trước thành thông tin chi tiết có cấu trúc. JSON sạch, thời gian thực, sẵn sàng cho tác nhân.

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

Tổng quan về Kỹ năng

Repo này chứa 11 kỹ năng tác nhân được tổ chức thành hai cấp:

🏗️ Nền tảng — truy cập dữ liệu và phân tích toàn diện:

Kỹ năng	Chức năng	Đầu vào	Đầu ra	Lợi thế chính
📦 zoodata/	Truy cập trực tiếp vào tất cả 11 điểm cuối API — danh mục, thị trường, sản phẩm, đối thủ cạnh tranh, thời gian thực, đánh giá, dải giá, thương hiệu, lịch sử	Từ khóa, danh mục, ASIN hoặc thương hiệu	Dữ liệu API thô với ánh xạ trường và tài liệu về điểm đặc biệt	Tham khảo API đầy đủ — mọi kỹ năng khác đều xây dựng trên nền tảng này
🎯 amazon-analysis/	13 chế độ lựa chọn tích hợp + nghiên cứu thị trường, phân tích đối thủ cạnh tranh, đánh giá ASIN, định giá, nghiên cứu danh mục	Từ khóa/danh mục/ASIN + mục đích	Phát hiện phân tích, sản phẩm hàng đầu, phân tích sâu ASIN, thông tin chi tiết được gắn thẻ độ tin cậy	Lệnh tổng hợp (report, opportunity) chạy quy trình đa điểm cuối trong một lần
🔎 amazon-keyword-traffic-analysis/	Quy trình thông minh từ khóa được xây dựng trên 8 điểm cuối lưu lượng từ khóa	Từ khóa gốc, từ khóa mục tiêu, ASIN hoặc ASIN + từ khóa	Các cấp mở rộng, đánh giá từ khóa đơn lẻ, thuật ngữ lưu lượng ASIN ngược, giải thích bất thường	Luồng chuyên dụng cho mở rộng từ khóa, ASIN ngược và giám sát lưu lượng từ khóa

⚡ Chuyên biệt — được xây dựng có mục đích cho các quy trình cụ thể:

Kỹ năng	Chức năng	Đầu vào	Đầu ra	Lợi thế chính
⚔️ amazon-competitor-intelligence-monitor/	Thông tin tình báo đối thủ cạnh tranh chuyên sâu — Quét toàn bộ hoặc Kiểm tra nhanh với cảnh báo phân cấp	Từ khóa hoặc (các) ASIN, tùy chọn ASIN của bạn + ASIN đối thủ	Ma trận đối thủ, xếp hạng thương hiệu, bản đồ giá, xu hướng 30 ngày, điểm số (1-100), cảnh báo phân cấp	Chế độ kép (Toàn bộ ~28-35 tín dụng, Nhanh ~5-10) với hệ thống cảnh báo ba cấp
📡 amazon-daily-market-radar/	Giám sát hàng ngày tự động — thay đổi giá, đối thủ mới, biến động BSR, tăng đột biến đánh giá	ASIN của bạn (1-10) + từ khóa	Cảnh báo ĐỎ/VÀNG/XANH, bảng điều khiển KPI, biến động đối thủ, mục hành động	Thiết lập và quên đi với xác thực tín hiệu (xu hướng 7+ ngày so với tăng đột biến một ngày)
✅ amazon-listing-audit-pro/	Kiểm tra sức khỏe listing 8 chiều với đề xuất tối ưu hóa	ASIN của bạn + từ khóa	Điểm (X/100, A-F), thẻ điểm 8 chiều, khoảng trống từ khóa, danh sách sửa chữa ưu tiên	Viết lại có thể hành động sử dụng ngôn ngữ đánh giá tần suất cao; hỗ trợ kiểm tra hàng loạt
🚪 amazon-market-entry-analyzer/	Khả năng tồn tại thị trường chỉ với một cú nhấp — khám phá thị trường phụ, chấm điểm (1-100), đưa ra phán quyết ĐI/THẬN TRỌNG/TRÁNH	Từ khóa hoặc đường dẫn danh mục	Bối cảnh thị trường phụ, phán quyết, tổng quan thị trường, bối cảnh thương hiệu, chiến lược thâm nhập	Tự động khám phá thị trường phụ với kiểm tra CR10 hai cấp
📈 amazon-market-trend-scanner/	Quét bối cảnh danh mục — danh mục phụ đang xu hướng, ngách mới nổi, thay đổi thị trường	1+ đường dẫn danh mục hoặc từ khóa	Bảng điều khiển xu hướng, TOP 5 Danh mục Hot, quét người mới tham gia, cảnh báo rủi ro	Phân tích xu hướng cấp danh mục trên TẤT CẢ danh mục phụ
💎 amazon-opportunity-discoverer/	Máy quét cơ hội theo hồ sơ — tự động chọn chiến lược, xác thực bằng dữ liệu thời gian thực, chấm điểm 7 chiều	Ngân sách + mức kinh nghiệm + từ khóa/danh mục	Top 10 cơ hội (S/A/B/C), phân tích chi tiết top 3, cảnh báo rủi ro	Tự động chọn chiến lược theo hồ sơ + Quét nhanh (~10 tín dụng)
💰 amazon-pricing-command-center/	Tín hiệu định giá dựa trên dữ liệu — tự động phát hiện danh mục lá, phân tích bối cảnh định giá	Một hoặc nhiều ASIN	Tín hiệu TĂNG/GIỮ/GIẢM, bản đồ nhiệt dải giá, bản đồ giá đối thủ, phân tích BuyBox	Đầu vào chỉ ASIN (không cần từ khóa), Tỷ lệ Bán hàng/Cạnh tranh
💬 amazon-review-intelligence-extractor/	Thông tin chi tiết sâu sắc về người tiêu dùng từ hơn 1 tỷ đánh giá được phân tích trước trên 11 chiều	ASIN đơn lẻ, nhiều ASIN hoặc từ khóa danh mục	Điểm đau, yếu tố mua hàng, hồ sơ người dùng, mô hình sử dụng, lộ trình khác biệt hóa	Hơn 1 tỷ đánh giá được phân tích trước (tiết kiệm 95% token), 11 chiều

Bắt đầu nhanh

1. Cài đặt Kỹ năng

npx skills add SerendipityOneInc/ZooData-Skills

Bạn sẽ được nhắc chọn kỹ năng nào để cài đặt:

🏗️ Nền tảng:

• ZooData — Dữ liệu Thương mại Amazon, 11 Điểm cuối
• Amazon Analysis — Nghiên cứu Toàn diện & Thông tin Người bán
• Amazon Keyword Intelligence — Mở rộng, ASIN Ngược & Giám sát

⚡ Chuyên biệt:

• Amazon Competitor Intelligence Monitor — Thông tin tình báo cạnh tranh chế độ kép với cảnh báo phân cấp
• Amazon Daily Market Radar — Giám sát & Cảnh báo Tự động
• Amazon Listing Audit Pro — Kiểm tra Sức khỏe 8 Chiều
• Amazon Market Entry Analyzer — Phán quyết ĐI/THẬN TRỌNG/TRÁNH
• Amazon Market Trend Scanner — Radar Danh mục Hàng ngày
• Amazon Opportunity Discoverer — Máy quét & Chấm điểm Ngách
• Amazon Pricing Command Center — Tín hiệu TĂNG/GIỮ/GIẢM
• Amazon Review Intelligence Extractor — Thông tin Người tiêu dùng từ Hơn 1 Tỷ Đánh giá

Hoặc sao chép thủ công:

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

2. Đặt Khóa API của bạn

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

🎁 Bậc miễn phí: 1.000 tín dụng khi đăng ký. 1 tín dụng = 1 lần gọi API. Không yêu cầu thẻ tín dụng.

3. Dùng thử

Hỏi tác nhân AI của bạn:

"Phân tích bối cảnh cạnh tranh cho tai nghe không dây dưới $50 trên Amazon Mỹ"

Hoặc sử dụng CLI trực tiếp:

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

Điểm cuối API

URL gốc: https://api.zoodata.ai/openapi/v2 Xác thực: Authorization: Bearer $ZOODATA_API_KEY Phương thức: Tất cả điểm cuối sử dụng POST với nội dung JSON

Điểm cuối	Mô tả	Trường hợp sử dụng ví dụ
🔍 products/search	Tìm kiếm sản phẩm với 13 chế độ cài sẵn, hơn 20 bộ lọc	"Tìm giày chạy bộ dưới $80 với 4+ sao"
📊 markets/search	Chỉ số cấp thị trường — mức độ tập trung, thị phần thương hiệu, định giá	"Thị trường thảm yoga cạnh tranh như thế nào?"
🏷️ products/competitors	Khám phá đối thủ cạnh tranh theo từ khóa, thương hiệu hoặc ASIN	"Ai là người bán hàng đầu trong ngách này?"
⚡ realtime/product	Chi tiết sản phẩm thời gian thực — đánh giá, tính năng, biến thể	"Lấy chi tiết hiện tại cho ASIN B0D5CRV4KL"
💬 reviews/analysis	Thông tin đánh giá được hỗ trợ bởi AI — cảm xúc, điểm đau	"Khách hàng yêu/ghét gì về sản phẩm này?"
📁 categories	Điều hướng cây danh mục Amazon	"Hiển thị danh mục phụ trong Điện tử"
📈 products/price-band-overview	Tóm tắt dải giá với dải cơ hội tốt nhất	"Dải giá tốt nhất cho thảm yoga là gì?"
📊 products/price-band-detail	Phân tích phân phối giá 5 dải đầy đủ	"Hiển thị phân tích dải giá chi tiết cho tai nghe không dây"
🏢 products/brand-overview	Chỉ số tập trung thương hiệu hàng đầu (CR10)	"Bối cảnh thương hiệu tập trung như thế nào?"
🏷️ products/brand-detail	Phân tích chi tiết theo thương hiệu với sản phẩm hàng đầu	"Thương hiệu nào thống trị danh mục này?"
📅 products/history	Ảnh chụp nhanh lịch sử hàng ngày cho ASIN	"Hiển thị lịch sử giá và BSR cho ASIN này"

13 Chế độ Tìm kiếm Sản phẩm

Điểm cuối products/search hỗ trợ 13 chế độ cài sẵn cho các chiến lược nghiên cứu khác nhau:

Chế độ	Chiến lược	Mục tiêu
fast-movers	Tốc độ bán hàng cao	Doanh thu nhanh
emerging	Xu hướng tăng, độ bão hòa thấp	Người tiên phong
long-tail	Từ khóa ngách, nhu cầu ổn định	Thu nhập bền vững
underserved	Nhu cầu cao, ít người bán	Khoảng trống thị trường
new-release	Sản phẩm mới ra mắt gần đây	Mặt hàng xu hướng
fbm-friendly	Phù hợp cho thực hiện đơn hàng bởi người bán	Khởi đầu đầu tư thấp
low-price	Sản phẩm thân thiện ngân sách	Chiến lược số lượng
single-variant	Listing đơn giản, không biến thể	Quản lý dễ dàng
high-demand-low-barrier	Doanh số cao, rào cản đánh giá thấp	Thâm nhập có thể mở rộng
broad-catalog	Phân tích phạm vi sản phẩm rộng	Tổng quan danh mục
selective-catalog	Lựa chọn chất lượng cao được tuyển chọn	Lựa chọn cao cấp
speculative	Cơ hội rủi ro cao, phần thưởng cao	Chiến lược táo bạo
top-bsr	Dẫn đầu Xếp hạng Bán chạy nhất	Dẫn đầu thị trường

Cấu trúc Dự án

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

Yêu cầu

• Python 3.8+ (chỉ stdlib, không phụ thuộc pip)
• Khóa API ZooData (lấy một khóa miễn phí)

Đóng góp

Chúng tôi hoan nghênh đóng góp! Vui lòng xem CONTRIBUTING.md để biết hướng dẫn.

Cộng đồng

• 💬 Discord — Trò chuyện, nhận trợ giúp, chia sẻ những gì bạn đang xây dựng
• 🐛 Issues — Báo cáo lỗi và yêu cầu tính năng
• 📖 Tài liệu API — Tài liệu API đầy đủ

Giấy phép

MIT © SerendipityOne Inc.