apify-ecommerce by apify/agent-skills
npx skills add https://github.com/apify/agent-skills --skill apify-ecommerce使用 Apify 的电商数据抓取工具,从任何电商平台提取产品数据、价格、评论和卖家信息。
APIFY_TOKEN 的 .env 文件(位于 ~/.claude/.env)--env-file 参数)| 用户需求 | 工作流 | 最佳适用场景 |
|---|---|---|
| 追踪价格,比较产品 | 工作流 1:产品与定价 | 价格监控、最低广告价格合规、竞品分析。可添加 AI 摘要以获取洞察。 |
| 分析评论(情感或质量) | 工作流 2:评论 | 品牌认知、客户情感、质量问题、缺陷模式 |
| 跨店铺查找卖家 | 工作流 3:卖家 | 未经授权的经销商、通过 Google Shopping 发现供应商 |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
Task Progress:
- [ ] Step 1: Select workflow and determine data source
- [ ] Step 2: Configure Actor input
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the extraction script
- [ ] Step 5: Summarize results
使用场景: 提取产品数据、价格和库存状态。追踪竞争对手价格、检测最低广告价格违规、产品对标或市场调研。
最佳适用人群: 定价分析师、产品经理、市场研究员。
| 输入类型 | 字段 | 描述 |
|---|---|---|
| 产品 URL | detailsUrls | 产品页面的直接 URL(使用对象格式) |
| 分类 URL | listingUrls | 分类/搜索结果页面的 URL |
| 关键词搜索 | keyword + marketplaces | 在选定电商平台中搜索关键词 |
{
"detailsUrls": [
{"url": "https://www.amazon.com/dp/B09V3KXJPB"},
{"url": "https://www.walmart.com/ip/123456789"}
],
"additionalProperties": true
}
{
"keyword": "Samsung Galaxy S24",
"marketplaces": ["www.amazon.com", "www.walmart.com"],
"additionalProperties": true,
"maxProductResults": 50
}
添加以下字段以获取 AI 生成的洞察:
| 字段 | 描述 |
|---|---|
fieldsToAnalyze | 要分析的数据点:["name", "offers", "brand", "description"] |
customPrompt | 自定义分析指令 |
包含 AI 摘要的示例:
{
"keyword": "robot vacuum",
"marketplaces": ["www.amazon.com"],
"maxProductResults": 50,
"additionalProperties": true,
"fieldsToAnalyze": ["name", "offers", "brand"],
"customPrompt": "Summarize price range and identify top brands"
}
name - 产品名称url - 产品 URLoffers.price - 当前价格offers.priceCurrency - 货币代码(可能因卖家地区而异)brand.slogan - 品牌名称(嵌套在对象中)image - 产品图片 URLadditionalProperties: true 时,包含额外的卖家/库存信息注意: 即使针对美国进行搜索,结果中的货币也可能不同,因为价格反映了不同卖家所在的地区。
使用场景: 提取评论用于情感分析、品牌认知监控或质量问题检测。
最佳适用人群: 品牌经理、客户体验团队、质量保证团队、产品经理。
| 输入类型 | 字段 | 描述 |
|---|---|---|
| 产品 URL | reviewListingUrls | 要从中提取评论的产品页面 |
| 关键词搜索 | keywordReviews + marketplacesReviews | 通过关键词搜索产品评论 |
{
"reviewListingUrls": [
{"url": "https://www.amazon.com/dp/B09V3KXJPB"}
],
"sortReview": "Most recent",
"additionalReviewProperties": true,
"maxReviewResults": 500
}
{
"keywordReviews": "wireless earbuds",
"marketplacesReviews": ["www.amazon.com"],
"sortReview": "Most recent",
"additionalReviewProperties": true,
"maxReviewResults": 200
}
Most recent - 最新评论优先(推荐)Most relevant - 平台默认相关性排序Most helpful - 投票最高的评论优先Highest rated - 五星评论优先Lowest rated - 一星评论优先注意:
sortReview: "Lowest rated"选项可能无法在所有电商平台中稳定工作。对于质量分析,建议收集大量样本并在后处理中按评分进行筛选。
maxReviewResults 以获得统计显著性使用场景: 跨店铺查找卖家、发现未经授权的经销商、评估供应商选项。
最佳适用人群: 品牌保护团队、采购部门、供应链经理。
注意: 此工作流使用 Google Shopping 来跨店铺查找卖家。直接使用卖家资料 URL 的方式并未得到可靠支持。
{
"googleShoppingSearchKeyword": "Nike Air Max 90",
"scrapeSellersFromGoogleShopping": true,
"countryCode": "us",
"maxGoogleShoppingSellersPerProduct": 20,
"maxGoogleShoppingResults": 100
}
| 字段 | 描述 |
|---|---|
googleShoppingSearchKeyword | 要搜索的产品名称 |
scrapeSellersFromGoogleShopping | 设置为 true 以提取卖家信息 |
scrapeProductsFromGoogleShopping | 设置为 true 以同时提取产品详情 |
countryCode | 目标国家(例如:us、uk、de) |
maxGoogleShoppingSellersPerProduct | 每个产品的最大卖家数量 |
maxGoogleShoppingResults | 总结果数量限制 |
www.amazon.com, www.amazon.co.uk, www.amazon.de, www.amazon.fr, www.amazon.it, www.amazon.es, www.amazon.ca, www.amazon.com.au, www.amazon.co.jp, www.amazon.in, www.amazon.com.br, www.amazon.com.mx, www.amazon.nl, www.amazon.pl, www.amazon.se, www.amazon.ae, www.amazon.sa, www.amazon.sg, www.amazon.com.tr, www.amazon.eg
www.walmart.com, www.costco.com, www.costco.ca, www.homedepot.com
allegro.pl, allegro.cz, allegro.sk, www.alza.cz, www.alza.sk, www.alza.de, www.alza.at, www.alza.hu, www.kaufland.de, www.kaufland.pl, www.kaufland.cz, www.kaufland.sk, www.kaufland.at, www.kaufland.fr, www.kaufland.it, www.cdiscount.com
支持所有主要的 IKEA 地区站点,并提供多种语言选项。
用于跨多个店铺发现卖家。
SKILL_PATH=~/.claude/skills/apify-ecommerce
快速回答(在聊天中显示):
node --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \
--actor "apify/e-commerce-scraping-tool" \
--input 'JSON_INPUT'
CSV 导出:
node --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \
--actor "apify/e-commerce-scraping-tool" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_filename.csv \
--format csv
JSON 导出:
node --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \
--actor "apify/e-commerce-scraping-tool" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_filename.json \
--format json
报告内容:
| 错误 | 解决方案 |
|---|---|
APIFY_TOKEN not found | 确保 ~/.claude/.env 包含 APIFY_TOKEN=your_token |
Actor not found | 验证 Actor ID:apify/e-commerce-scraping-tool |
Run FAILED | 检查错误输出中的 Apify 控制台链接 |
Timeout | 减少 maxProductResults 或增加 --timeout |
No results | 验证 URL 有效且可访问 |
Invalid marketplace | 检查 marketplace 值是否与支持的列表完全匹配 |
每周安装量
1.7K
代码仓库
GitHub 星标数
1.4K
首次出现
Feb 3, 2026
安全审计
安装于
opencode1.6K
codex1.6K
gemini-cli1.6K
github-copilot1.5K
kimi-cli1.5K
amp1.5K
Extract product data, prices, reviews, and seller information from any e-commerce platform using Apify's E-commerce Scraping Tool.
.env file with APIFY_TOKEN (at ~/.claude/.env)--env-file support)| User Need | Workflow | Best For |
|---|---|---|
| Track prices, compare products | Workflow 1: Products & Pricing | Price monitoring, MAP compliance, competitor analysis. Add AI summary for insights. |
| Analyze reviews (sentiment or quality) | Workflow 2: Reviews | Brand perception, customer sentiment, quality issues, defect patterns |
| Find sellers across stores | Workflow 3: Sellers | Unauthorized resellers, vendor discovery via Google Shopping |
Task Progress:
- [ ] Step 1: Select workflow and determine data source
- [ ] Step 2: Configure Actor input
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the extraction script
- [ ] Step 5: Summarize results
Use case: Extract product data, prices, and stock status. Track competitor prices, detect MAP violations, benchmark products, or research markets.
Best for: Pricing analysts, product managers, market researchers.
| Input Type | Field | Description |
|---|---|---|
| Product URLs | detailsUrls | Direct URLs to product pages (use object format) |
| Category URLs | listingUrls | URLs to category/search result pages |
| Keyword Search | keyword + marketplaces | Search term across selected marketplaces |
{
"detailsUrls": [
{"url": "https://www.amazon.com/dp/B09V3KXJPB"},
{"url": "https://www.walmart.com/ip/123456789"}
],
"additionalProperties": true
}
{
"keyword": "Samsung Galaxy S24",
"marketplaces": ["www.amazon.com", "www.walmart.com"],
"additionalProperties": true,
"maxProductResults": 50
}
Add these fields to get AI-generated insights:
| Field | Description |
|---|---|
fieldsToAnalyze | Data points to analyze: ["name", "offers", "brand", "description"] |
customPrompt | Custom analysis instructions |
Example with AI summary:
{
"keyword": "robot vacuum",
"marketplaces": ["www.amazon.com"],
"maxProductResults": 50,
"additionalProperties": true,
"fieldsToAnalyze": ["name", "offers", "brand"],
"customPrompt": "Summarize price range and identify top brands"
}
name - Product nameurl - Product URLoffers.price - Current priceoffers.priceCurrency - Currency code (may vary by seller region)brand.slogan - Brand name (nested in object)image - Product image URLadditionalProperties: trueNote: Currency may vary in results even for US searches, as prices reflect different seller regions.
Use case: Extract reviews for sentiment analysis, brand perception monitoring, or quality issue detection.
Best for: Brand managers, customer experience teams, QA teams, product managers.
| Input Type | Field | Description |
|---|---|---|
| Product URLs | reviewListingUrls | Product pages to extract reviews from |
| Keyword Search | keywordReviews + marketplacesReviews | Search for product reviews by keyword |
{
"reviewListingUrls": [
{"url": "https://www.amazon.com/dp/B09V3KXJPB"}
],
"sortReview": "Most recent",
"additionalReviewProperties": true,
"maxReviewResults": 500
}
{
"keywordReviews": "wireless earbuds",
"marketplacesReviews": ["www.amazon.com"],
"sortReview": "Most recent",
"additionalReviewProperties": true,
"maxReviewResults": 200
}
Most recent - Latest reviews first (recommended)Most relevant - Platform default relevanceMost helpful - Highest voted reviewsHighest rated - 5-star reviews firstLowest rated - 1-star reviews firstNote: The
sortReview: "Lowest rated"option may not work consistently across all marketplaces. For quality analysis, collect a large sample and filter by rating in post-processing.
maxReviewResults for statistical significanceUse case: Find sellers across stores, discover unauthorized resellers, evaluate vendor options.
Best for: Brand protection teams, procurement, supply chain managers.
Note: This workflow uses Google Shopping to find sellers across stores. Direct seller profile URLs are not reliably supported.
{
"googleShoppingSearchKeyword": "Nike Air Max 90",
"scrapeSellersFromGoogleShopping": true,
"countryCode": "us",
"maxGoogleShoppingSellersPerProduct": 20,
"maxGoogleShoppingResults": 100
}
| Field | Description |
|---|---|
googleShoppingSearchKeyword | Product name to search |
scrapeSellersFromGoogleShopping | Set to true to extract sellers |
scrapeProductsFromGoogleShopping | Set to true to also extract product details |
countryCode | Target country (e.g., us, , ) |
www.amazon.com, www.amazon.co.uk, www.amazon.de, www.amazon.fr, www.amazon.it, www.amazon.es, www.amazon.ca, www.amazon.com.au, www.amazon.co.jp, www.amazon.in, www.amazon.com.br, www.amazon.com.mx, , , , , , , ,
www.walmart.com, www.costco.com, www.costco.ca, www.homedepot.com
allegro.pl, allegro.cz, allegro.sk, www.alza.cz, www.alza.sk, www.alza.de, www.alza.at, www.alza.hu, www.kaufland.de, www.kaufland.pl, www.kaufland.cz, www.kaufland.sk, , , ,
Supports all major IKEA regional sites with multiple language options.
Use for seller discovery across multiple stores.
SKILL_PATH=~/.claude/skills/apify-ecommerce
Quick answer (display in chat):
node --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \
--actor "apify/e-commerce-scraping-tool" \
--input 'JSON_INPUT'
CSV export:
node --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \
--actor "apify/e-commerce-scraping-tool" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_filename.csv \
--format csv
JSON export:
node --env-file=~/.claude/.env $SKILL_PATH/reference/scripts/run_actor.js \
--actor "apify/e-commerce-scraping-tool" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_filename.json \
--format json
Report:
| Error | Solution |
|---|---|
APIFY_TOKEN not found | Ensure ~/.claude/.env contains APIFY_TOKEN=your_token |
Actor not found | Verify Actor ID: apify/e-commerce-scraping-tool |
Run FAILED | Check Apify console link in error output |
Timeout | Reduce maxProductResults or increase |
Weekly Installs
1.7K
Repository
GitHub Stars
1.4K
First Seen
Feb 3, 2026
Security Audits
Gen Agent Trust HubFailSocketPassSnykWarn
Installed on
opencode1.6K
codex1.6K
gemini-cli1.6K
github-copilot1.5K
kimi-cli1.5K
amp1.5K
99,500 周安装
ukdemaxGoogleShoppingSellersPerProduct | Max sellers per product |
maxGoogleShoppingResults | Total result limit |
www.amazon.nlwww.amazon.plwww.amazon.sewww.amazon.aewww.amazon.sawww.amazon.sgwww.amazon.com.trwww.amazon.egwww.kaufland.atwww.kaufland.frwww.kaufland.itwww.cdiscount.com--timeoutNo results | Verify URLs are valid and accessible |
Invalid marketplace | Check marketplace value matches supported list exactly |