APIClaw — Amazon Data API for AI Agents

English | 中文

ZooData Skills

โครงสร้างพื้นฐานข้อมูลที่สร้างขึ้นสำหรับเอเจนต์
ขับเคลื่อนอีคอมเมิร์ซของ Amazon ในปัจจุบันด้วยสินค้ากว่า 200 ล้านรายการ รีวิวกว่า 1 พันล้านรายการ และสัญญาณแบบเรียลไทม์

เว็บไซต์ • รับคีย์ API • Discord • เริ่มต้นใช้งาน • เอกสารอ้างอิง API

---

ZooData คืออะไร?

ZooData คือโครงสร้างพื้นฐานข้อมูลที่สร้างขึ้นสำหรับเอเจนต์ ไม่ใช่ API สำหรับการขูดข้อมูล ไม่ใช่แดชบอร์ดสำหรับมนุษย์ แต่เป็นชั้นข้อมูลที่ออกแบบมาโดยเฉพาะเพื่อให้เอเจนต์ AI ของคุณเข้าถึงสัญญาณอีคอมเมิร์ซของ Amazon ได้โดยตรง — สินค้าที่ถูกจัดทำดัชนีกว่า 200 ล้านรายการ ประวัติมากกว่า 2 ปี และรีวิวกว่า 1 พันล้านรายการที่ถูกประมวลผลล่วงหน้าเป็นข้อมูลเชิงลึกที่มีโครงสร้าง JSON ที่สะอาด เรียลไทม์ และพร้อมสำหรับเอเจนต์

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

ภาพรวมทักษะ

พื้นที่เก็บข้อมูลนี้ประกอบด้วย ทักษะเอเจนต์ 10 รายการ ที่จัดเป็นสองระดับ:

🏗️ พื้นฐาน — การเข้าถึงข้อมูลและการวิเคราะห์เต็มรูปแบบ:

ทักษะ	ฟังก์ชัน	ข้อมูลนำเข้า	ข้อมูลส่งออก	ข้อได้เปรียบหลัก
📦 zoodata/	การเข้าถึงโดยตรงไปยัง 25 เอนด์พอยต์อีคอมเมิร์ซและข้อมูลเชิงลึกคำค้นของ Amazon	คำค้น หมวดหมู่ 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) การแจ้งเตือนแบบระดับชั้น	โหมดคู่ (เต็ม ~28-35 เครดิต ด่วน ~5-10) พร้อมระบบแจ้งเตือนสามระดับ
📡 amazon-daily-market-radar/	การติดตามรายวันอัตโนมัติ — การเปลี่ยนแปลงราคา คู่แข่งใหม่ การเคลื่อนไหวของ BSR การพุ่งขึ้นของรีวิว	ASIN ของคุณ (1-10) + คำค้น	การแจ้งเตือนสีแดง/เหลือง/เขียว แดชบอร์ด KPI การเคลื่อนไหวของคู่แข่ง รายการดำเนินการ	ตั้งแล้วลืมได้ พร้อมการตรวจสอบสัญญาณ (แนวโน้ม 7+ วันเทียบกับการพุ่งขึ้นในวันเดียว)
✅ amazon-listing-audit-pro/	การตรวจสอบสุขภาพรายการสินค้า 8 มิติพร้อมคำแนะนำการปรับปรุง	ASIN ของคุณ + คำค้น	คะแนน (X/100, A-F) การ์ดคะแนน 8 มิติ ช่องว่างคำค้น รายการแก้ไขลำดับความสำคัญ	การเขียนใหม่ที่นำไปปฏิบัติได้โดยใช้ภาษารีวิวความถี่สูง รองรับการตรวจสอบจำนวนมาก
💰 amazon-pricing-command-center/	สัญญาณการกำหนดราคาที่ขับเคลื่อนด้วยข้อมูล — ตรวจจับหมวดหมู่ย่อยอัตโนมัติ วิเคราะห์ภูมิทัศน์การกำหนดราคา	ASIN หนึ่งรายการหรือหลายรายการ	สัญญาณ RAISE/HOLD/LOWER แผนที่ความร้อนช่วงราคา แผนที่ราคาคู่แข่ง การวิเคราะห์ BuyBox	ข้อมูลนำเข้าเฉพาะ ASIN (ไม่ต้องใช้คำค้น) อัตราส่วนยอดขาย/การแข่งขัน
💬 amazon-review-intelligence-extractor/	ข้อมูลเชิงลึกผู้บริโภคเชิงลึกจากรีวิวที่วิเคราะห์ล่วงหน้ากว่า 1 พันล้านรายการใน 11 มิติ	ASIN เดี่ยว ASIN หลายรายการ หรือคำค้นหมวดหมู่	จุดเจ็บปวด ปัจจัยการซื้อ โปรไฟล์ผู้ใช้ รูปแบบการใช้งาน แผนที่การสร้างความแตกต่าง	รีวิวที่วิเคราะห์ล่วงหน้ากว่า 1 พันล้านรายการ (ประหยัดโทเค็น 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 — 25 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

⚡ เฉพาะทาง:

• Amazon Competitor Intelligence Monitor — ข้อมูลเชิงลึกคู่แข่งแบบสองโหมดพร้อมการแจ้งเตือนแบบระดับชั้น
• 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

หรือโคลนด้วยตนเอง:

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 เครดิต = 1 การเรียก API ไม่ต้องใช้บัตรเครดิต

3. ทดลองใช้

ถามเอเจนต์ AI ของคุณ:

"วิเคราะห์ภูมิทัศน์การแข่งขันของหูฟังไร้สายราคาต่ำกว่า $50 บน Amazon สหรัฐอเมริกา"

หรือใช้ 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 เมธอด: ทุกเอนด์พอยต์ใช้ POST พร้อมบอดี้ JSON

เอนด์พอยต์	คำอธิบาย	ตัวอย่างการใช้งาน
🔍 products/search	การค้นหาสินค้าพร้อมตัวกรองมากกว่า 20 รายการ (13 โหมดที่ตั้งไว้ล่วงหน้าผ่าน CLI)	"ค้นหารองเท้าวิ่งราคาต่ำกว่า $80 ที่มีดาว 4+ ดาว"
📊 markets/search	การค้นพบหมวดหมู่และภาพรวมที่แม่นยำ — ขนาด ความเข้มข้น การกำหนดราคา Top 100 ที่เลือก	"ตลาดเสื่อโยคะมีการแข่งขันแค่ไหน?"
🧩 markets/structure-profile	การกระจายแบรนด์ ราคา และอื่น ๆ ของ Top 100	"ช่วงราคาใดที่มียอดขายมากที่สุด?"
📅 markets/history	แนวโน้มตลาดหมวดหมู่ ณ สิ้นเดือนที่พร้อมใช้งาน	"หมวดหมู่นี้เปลี่ยนแปลงตามเดือนอย่างไร?"
🏷️ products/competitors	การค้นพบคู่แข่งด้วยคำค้น แบรนด์ หรือ ASIN	"ใครคือผู้ขายอันดับต้น ๆ ในกลุ่มนี้?"
⚡ realtime/product	รายละเอียดสินค้าแบบเรียลไทม์ — รีวิว คุณสมบัติ ตัวแปร	"รับรายละเอียดปัจจุบันสำหรับ ASIN B0D5CRV4KL"
💬 reviews/analysis	ข้อมูลเชิงลึกรีวิวที่ขับเคลื่อนด้วย AI — ความรู้สึก จุดเจ็บปวด	"ลูกค้าชอบ/ไม่ชอบอะไรเกี่ยวกับสินค้านี้?"
📁 categories	การนำทางแผนผังหมวดหมู่ Amazon	"แสดงหมวดหมู่ย่อยภายใต้ Electronics"
📈 products/price-band-overview	สรุปช่วงราคาพร้อมช่วงโอกาสที่ดีที่สุด	"ช่วงราคาที่ดีที่สุดสำหรับเสื่อโยคะคืออะไร?"
📊 products/price-band-detail	การวิเคราะห์การกระจายราคา 5 ช่วงเต็มรูปแบบ	"แสดงรายละเอียดการกระจายช่วงราคาสำหรับหูฟังไร้สาย"
🏢 products/brand-overview	เมตริกความเข้มข้นของแบรนด์ชั้นนำ (CR10)	"ภูมิทัศน์แบรนด์มีความเข้มข้นแค่ไหน?"
🏷️ products/brand-detail	การแยกย่อยรายแบรนด์พร้อมสินค้ายอดนิยม	"แบรนด์ใดครองหมวดหมู่นี้?"
📅 products/history	ภาพรวมรายวันย้อนหลังสำหรับ ASIN	"แสดงประวัติราคาและ BSR สำหรับ ASIN นี้"

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                            # 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

ข้อกำหนด

• Python 3.8+ (เฉพาะ stdlib ไม่มีการพึ่งพา pip)
• คีย์ API ZooData (รับฟรี)

การมีส่วนร่วม

เรายินดีต้อนรับการมีส่วนร่วม! โปรดดู CONTRIBUTING.md สำหรับแนวทาง

ชุมชน

• 💬 Discord — แชท ขอความช่วยเหลือ แบ่งปันสิ่งที่คุณกำลังสร้าง
• 🐛 Issues — รายงานข้อบกพร่องและคำขอฟีเจอร์
• 📖 API Docs — เอกสาร API ฉบับสมบูรณ์

ลิขสิทธิ์

MIT © SerendipityOne Inc.