APIClaw — Amazon Data API for AI Agents

English | 中文

Kỹ năng ZooData

Cơ sở hạ tầng dữ liệu được xây dựng cho các 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à tín hiệu thời gian thực.

Trang web • Lấy khóa API • Discord • Bắt đầu nhanh • Tài liệu tham khảo API

---

ZooData là gì?

ZooData là cơ sở hạ tầng dữ liệu được xây dựng cho các 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 chuyên dụng cung cấp cho các 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 các 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 AI.

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

Tổng quan về các kỹ năng

Kho lưu trữ này chứa 11 kỹ năng tác nhân AI đượ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 tất cả 22 điểm cuối API — 12 điểm cuối thương mại cộng với 10 điểm cuối thông minh từ khóa	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ề các điểm bất thường	Tài liệu 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 + ý định	Kết quả phân tích, sản phẩm hàng đầu, phân tích chuyên sâu ASIN, thông tin chi tiết có gắn thẻ độ tin cậy	Các lệnh tổng hợp (report, opportunity) chạy các quy trình đa điểm cuối trong một lần
🔎 amazon-keyword-traffic-analysis/	Quy trình làm việc về giá trị từ khóa và sức khỏe lưu lượng sản phẩm được xây dựng trên 10 điểm cuối thông minh 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, phân tích giá trị từ khóa, cấu trúc lưu lượng sản phẩm, xu hướng và chẩn đoán sức khỏe	Các quy trình chuyên dụng để mở rộng từ khóa, phân tích từ khóa và phân tích lưu lượng sản phẩm

⚡ Chuyên biệt — được xây dựng cho các quy trình làm việc 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 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 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 danh sách 8 chiều với khuyến nghị tối ưu hóa	ASIN của bạn + từ khóa	Điểm số (X/100, A-F), thẻ điểm 8 chiều, khoảng trống từ khóa, danh sách ưu tiên sửa	Viết lại có thể hành động bằng ngôn ngữ đánh giá tần suất cao; hỗ trợ kiểm tra hàng loạt
🚪 amazon-market-entry-analyzer/	Đánh giá khả thi thị trường một cú nhấp chuột — khám phá thị trường con, 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 con, phán quyết, tổng quan thị trường, bối cảnh thương hiệu, chiến lược gia nhập	Tự động khám phá thị trường con 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 con đang phát triển, thị trườ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, Danh mục nóng TOP 5, 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 con
💎 amazon-opportunity-discoverer/	Máy quét cơ hội dựa trên 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 dựa trên 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	Chỉ cần đầu vào ASIN (không cần từ khóa), Tỷ lệ Doanh số/Cạnh tranh
💬 amazon-review-intelligence-extractor/	Thông tin chi tiết sâu 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	Một ASIN, 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 các 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 tình báo người bán
• Amazon Keyword Intelligence — Mở rộng, Reverse ASIN & 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 thị trường ngách & chấm điểm
• Amazon Pricing Command Center — Tín hiệu TĂNG/GIỮ/GIẢM
• Amazon Review Intelligence Extractor — Thông tin chi tiết 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

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

3. Thử nghiệm

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 đô la trên Amazon Hoa Kỳ"

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

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

Điểm cuối API

URL cơ sở: 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 phần thân JSON

Điểm cuối	Mô tả	Ví dụ trường hợp sử dụng
🔍 products/search	Tìm kiếm sản phẩm với hơn 20 bộ lọc (13 chế độ cài sẵn qua CLI)	"Tìm giày chạy bộ dưới 80 đô la với 4+ sao"
📊 markets/search	Số liệu 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 thị trường 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 chi tiết đánh giá hỗ trợ AI — cảm xúc, điểm đau	"Khách hàng thích/ghét điều 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 con dưới Đ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	"Phạm vi giá tốt nhất cho thảm yoga là gì?"
📊 products/price-band-detail	Phân tích phân phối giá đầy đủ 5 dải	"Hiển thị phân tích chi tiết dải giá cho tai nghe không dây"
🏢 products/brand-overview	Số liệu 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

CLI kỹ năng (zoodata.py --mode) cung cấp 13 chế độ cài sẵn cho các chiến lược nghiên cứu khác nhau. Các chế độ được mở rộng thành các trường bộ lọc cụ thể (monthlySalesMin, salesGrowthRateMin, …) ở phía máy khách — mode không phải là tham số API và việc gửi nó đến /openapi/v2/products/search trả về 422:

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 đi đầu
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	Mặt hàng đang thịnh hành
fbm-friendly	Phù hợp với hoàn thành đơn hàng của người bán	Bắt đầu đầu tư thấp
low-price	Sản phẩm thân thiện với ngân sách	Chiến lược khối lượng
single-variant	Danh sách đơn giản, không có biến thể	Quản lý dễ dàng
high-demand-low-barrier	Doanh số cao, rào cản đánh giá thấp	Gia 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, lợi nhuận cao	Chiến lược tích cực
top-bsr	Dẫn đầu xếp hạng người bán tốt nhất	Nhà lãnh đạo thị trường

Cấu trúc dự án

├── zoodata/                              # Data layer skill (lightweight)
│   ├── SKILL.md                            # 22 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-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ỉ thư viện chuẩn, không phụ thuộc pip)
• Khóa API ZooData (nhận miễn phí)

Đóng góp

Chúng tôi hoan nghênh mọi đó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
• 📖 API Docs — Tài liệu API đầy đủ

Giấy phép

MIT © SerendipityOne Inc.