- name
- pangolinfo-amazon-scraper
- description
- Scrape Amazon as JSON — products, keywords, reviews, BSR. 13 regions. Anti-bot. 60 free credits. Claude Code, Cursor, LangChain.
- homepage
- https://pangolinfo.com/?referrer=clawhub_amz
- license
- MIT-0
- metadata
- openclaw
- emoji
- 🛒
- os
- ["darwin", "linux"]
- requires
- env
- primaryEnv
- PANGOLINFO_API_KEY
- bins
- ["python3"]
- notes
- Set PANGOLINFO_API_KEY (recommended). OR set PANGOLINFO_EMAIL + PANGOLINFO_PASSWORD to auto-fetch a key. Register free at https://tool.pangolinfo.com/?referrer=clawhub_amz — 60 free credits, no card.
- tags
- [amazon, amazon-scraper, asin, bsr, reviews, keyword-research, ecommerce, json, agent-tool, ai-agent, claude-code, cursor, langchain, free-tier, web-scraping, python]
- version
- 2.0.3
Pangolinfo Amazon Scraper
Get Amazon product data in under a minute.
Use this skill when you want to:
- get price, rating, and BSR from an ASIN
- search Amazon keywords and compare results
- extract critical reviews and summarize complaints
- track seller storefronts, best sellers, and product variants
🎁 New users get 60 free credits. Enough for real product lookups, keyword tests, and review workflows before upgrading. 👉 Get your free API key — about 30 seconds.
First win in 30 seconds
- Get your free API key: <https://tool.pangolinfo.com/?referrer=clawhub_amz>
- Set the environment variable:
export PANGOLINFO_API_KEY="pgl_xxx"- Run your first lookup:
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_us- If you see fields like these, the skill is working:
titlepricestarbestSellersRank
What to do next
Check your own product
python3 scripts/pangolinfo.py --asin YOUR_ASIN --site amz_usSearch a keyword
python3 scripts/pangolinfo.py --q "wireless mouse" --site amz_usFind top complaints from reviews
python3 scripts/pangolinfo.py --asin YOUR_ASIN --mode review --filter-star critical --pages 1First-time setup (agent instructions)
If PANGOLINFO_API_KEY is not set, the agent MUST guide the user as follows and stop there. Do not attempt the API call without credentials.
"This skill needs a free Pangolinfo API key. 1. Visit https://tool.pangolinfo.com/?referrer=clawhub_amz 2. Sign up and copy your API key 3. Run:export PANGOLINFO_API_KEY='pgl_xxx'4. Verify:python3 scripts/pangolinfo.py --auth-onlyThen ask me to retry your request."
The API key does not expire. For interactive setup, see references/setup-guide.md.
What this skill can do
This skill returns structured Amazon data across 13 marketplaces (US/UK/CA/DE/FR/JP/IT/ES/AU/MX/SA/AE/BR). CAPTCHA and anti-bot handling run in the cloud.
🎯 Capabilities (9 Parsers)
| Parser | Use case | Quick example |
|---|---|---|
amzProductDetail *(default)* | ASIN details: price, BSR, rating, attributes | --asin B0DYTF8L2W |
amzKeyword | Keyword search (organic + sponsored rank) | --q "wireless mouse" |
amzProductOfCategory | Category listings | --content <nodeID> --parser amzProductOfCategory |
amzProductOfSeller | Seller storefront products | --content <sellerID> --parser amzProductOfSeller |
amzBestSellers | BSR rankings by category | --content electronics --parser amzBestSellers |
amzNewReleases | New releases by category | --content electronics --parser amzNewReleases |
amzFollowSeller | Follow seller updates *(separate endpoint)* | --asin B0DYTF8L2W --parser amzFollowSeller |
amzVariantAsin | Get variant ASINs *(separate endpoint)* | --asin B0G4QPYK4Z --parser amzVariantAsin |
amzReviewV2 | Product reviews with star/sort filters | --asin B0DYTF8L2W --mode review --filter-star critical |
The script auto-infers parser from input (ASIN → amzProductDetail, keyword → amzKeyword).
🌍 Supported Marketplaces (13 regions)
| Code | Domain | Code | Domain |
|---|---|---|---|
amz_us | amazon.com | amz_jp | amazon.co.jp |
amz_uk | amazon.co.uk | amz_it | amazon.it |
amz_ca | amazon.ca | amz_es | amazon.es |
amz_de | amazon.de | amz_au | amazon.com.au |
amz_fr | amazon.fr | amz_mx | amazon.com.mx |
amz_br | amazon.com.br | amz_sa | amazon.sa |
amz_ae | amazon.ae |
Default: amz_us. Pass via --site amz_uk etc.
💰 Credit Consumption
| Operation | Credits |
|---|---|
Product / keyword / category / seller / bestsellers (--format json) | 1 |
Same with --format rawHtml or markdown | 0.75 |
| Follow Seller | 1 |
| Variant ASIN | 1 |
Review page (--mode review) | 5 per page |
→ 60 free credits = 60 product lookups, OR 12 review pages, OR 80 raw HTML fetches. → Credits are charged only on success (api_code: 0).
📤 Sample Output
Success (stdout):
{
"success": true,
"task_id": "02b3e90810f0450ca6d41244d6009d0f",
"url": "https://www.amazon.com/dp/B0DYTF8L2W",
"metadata": {
"executionTime": 1791,
"parserType": "amzProductDetail",
"parsedAt": "2026-04-27T06:42:01.861Z"
},
"results": [
{
"asin": "B0DYTF8L2W",
"title": "Sweetcrispy Convertible Sectional Sofa Couch...",
"price": "...",
"star": "4.4",
"rating": "(22)",
"bestSellersRank": "#2,329,042 in Home & Kitchen",
"reviews": [ /* ... */ ],
"aiReviewsSummary": { /* ... */ }
}
],
"results_count": 1
}Error (stderr):
{
"success": false,
"error": {
"code": "API_ERROR",
"api_code": 2001,
"message": "Insufficient credits",
"hint": "Top up at https://pangolinfo.com/?referrer=clawhub_amz"
}
}🛑 Error Handling (Agent Directives)
The script outputs structured error JSON to stderr on failure. Agent should map api_code as follows:
api_code | Meaning | Agent action |
|---|---|---|
0 | Success | Process results |
1004 | Invalid token | Auto-retried by script with refreshed credentials. No action. |
1009 | Invalid parser name | Check --parser value matches one of the 9 supported parsers |
2001 | Insufficient credits | Show top-up link. Do NOT retry. |
2005 | No active plan | Ask user to subscribe. Do NOT retry. |
2007 | Account expired | Ask user to renew at https://tool.pangolinfo.com/. Do NOT retry. |
2009 | Usage limit reached | Wait for next billing cycle. Do NOT retry. |
2010 | Bill day not configured | Tell user to contact support. Do NOT retry. |
4029 | Rate limited | sleep 5s, retry once. |
10000 / 10001 | Task execution failed | Retry once with corrected URL/ASIN. Likely transient. |
Critical rule: Errors 2001, 2005, 2007, 2009, 2010 mean stop immediately — retries waste credits and won't succeed.
Full error reference: references/error-codes.md.
📝 Common Recipes
# Product detail (US)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_us
# Same product on UK marketplace
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_uk
# Keyword search
python3 scripts/pangolinfo.py --q "wireless mouse" --site amz_us
# Bestsellers in Electronics
python3 scripts/pangolinfo.py --content electronics --parser amzBestSellers --site amz_us
# Critical reviews (3 pages = 15 credits)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --mode review --filter-star critical --pages 3
# Variant ASINs (color/size options)
python3 scripts/pangolinfo.py --asin B0G4QPYK4Z --parser amzVariantAsin
# Auth check (free, no credits charged)
python3 scripts/pangolinfo.py --auth-only
# Raw HTML output (cheaper, 0.75 credits)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --format rawHtml🎯 Quick Start Prompts (try with your agent)
- *"Get the price, rating, and BSR for ASIN B0DYTF8L2W on Amazon US."*
- *"Fetch the top 10 bestsellers in the Electronics category and return as CSV."*
- *"Scrape the first 50 critical reviews for B0DYTF8L2W and summarize the top 3 complaints."*
- *"Search Amazon UK for 'wireless earbuds' and list price + rating for the top 20 results."*
- *"Get all color/size variants of ASIN B0G4QPYK4Z."*
🚫 When NOT to use
- Non-Amazon sites (Walmart, Shopify, eBay) → use the corresponding Pangolinfo skill instead.
- Real-time inventory / checkout — this is a read-only scraping API.
- Personal account data — only public listings are accessible.
🤝 Compatible Agents
OpenClaw · Claude Code · Cursor · LangChain · LangGraph · Dify · AutoGen · Devin · Trae · Copilot
📚 References
- Setup Guide — interactive first-time setup
- Error Codes — full troubleshooting reference
- Official API Docs
- Amazon Scrape API endpoint
- Pricing & credits
🌐 中文用户
亚马逊全域数据抓取 API:ASIN 详情、关键词排名、类目 BSR、评论、变体、卖家店铺。支持 13 个站点(美国、英国、加拿大、德国、法国、日本、意大利、西班牙、澳大利亚、墨西哥、沙特、阿联酋、巴西)。云端反爬,结构化 JSON 输出。
完美适配 OpenClaw、Claude Code、Cursor、LangChain 等 AI Agent 工作流。
新用户注册即送 60 免费积分,无需信用卡。
注册地址:https://tool.pangolinfo.com/?referrer=clawhub_amz