APIClaw — Amazon Data API for AI Agents

English | 中文

Kỹ năng ZooData

Hạ tầng dữ liệu được xây dựng cho các tác nhân AI.
Hiện đang cung cấp dữ liệu cho 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 • Tài liệu tham khảo API

---

ZooData là gì?

ZooData là 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 giúp các tác nhân AI của bạ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 tiền xử lý 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 10 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 vào 25 điểm cuối thương mại Amazon và thông tin 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 + mục đích	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 mức độ 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 chỉ 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 11 điểm cuối thông tin 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
📊 amazon-market-analysis/	Khám phá các ứng viên thị trường và sản phẩm, đánh giá điều kiện gia nhập và theo dõi thay đổi danh mục	Câu hỏi thị trường, danh mục hoặc bản tóm tắt cơ hội sản phẩm	Danh sách rút gọn quan sát được, đánh giá điều kiện gia nhập có điều kiện hoặc phân tích xu hướng có giới hạn	Một câu chuyện liền mạch với bằng chứng riêng biệt và ranh giới quyết định cho người bán

⚡ 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 (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á	(Các) ASIN của bạn (1-10) + từ khóa	Cảnh báo ĐỎ/VÀNG/XANH, bảng điều khiển KPI, chuyển động của đố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 các 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 lỗi	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 toán hàng loạt
💰 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ẫu 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
🌐 web-extract/	Trích xuất dữ liệu có cấu trúc từ các trang web công khai và kết quả tìm kiếm	URL, truy vấn tìm kiếm hoặc trang web	JSON có cấu trúc hoặc nội dung trang	Xử lý các trang đã kết xuất và thu thập dữ liệu trang web có giới hạn

amazon-market-analysis là kỹ năng thị trường hợp nhất. Các thư mục amazon-market-entry-analyzer, amazon-market-trend-scanner và amazon-opportunity-discoverer trước đây được giữ lại chỉ làm mã nguồn đã ngừng sử dụng; các điểm vào của chúng được đặt tên là RETIRED.md, vì vậy trình cài đặt và nhà xuất bản kỹ năng sẽ không phát hiện ra chúng.

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 — 25 điểm cuối thương mại Amazon và thông tin từ khóa
• Phân tích Amazon — Nghiên cứu toàn diện và thông tin tình báo người bán
• Thông tin từ khóa Amazon — Mở rộng, ASIN ngược và giám sát
• Phân tích thị trường Amazon — Khám phá, gia nhập và thay đổi

⚡ Chuyên biệt:

• Giám sát thông tin tình báo đối thủ cạnh tranh Amazon — Thông tin tình báo cạnh tranh chế độ kép với cảnh báo phân cấp
• Radar thị trường hàng ngày Amazon — Giám sát và cảnh báo tự động
• Kiểm toán danh sách Amazon Pro — Kiểm tra sức khỏe 8 chiều
• Trung tâm chỉ huy định giá Amazon — Tín hiệu TĂNG/GIỮ/GIẢM
• Trình trích xuất thông tin đánh giá Amazon — Thông tin chi tiết người tiêu dùng từ hơn 1 tỷ đánh giá
• Trích xuất web — Trích xuất dữ liệu web công khai có cấu trúc

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

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

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 nội dung 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	Khám phá danh mục và ảnh chụp nhanh chính xác — quy mô, mức độ tập trung, định giá Top 100 đã chọn	"Thị trường thảm yoga cạnh tranh như thế nào?"
🧩 markets/structure-profile	Phân phối thương hiệu, giá và các phân phối Top 100 khác	"Các dải giá nào chiếm doanh số?"
📅 markets/history	Xu hướng thị trường danh mục cuối tháng có sẵn	"Danh mục này đã thay đổi theo tháng 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/không thích đ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	"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á đầ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	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

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 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	Người dẫn đầu xếp hạng người bán chạy nhất	Người dẫn đầu thị trường

Cấu trúc dự án

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

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
• 🐛 Vấn đề — 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.