apify-ecommerce

电商数据提取

使用 Apify 的电商抓取工具，从任何电商平台提取产品数据、价格、评论和卖家信息。

适用场景

• 需要获取电商网站上的产品、定价、评论、库存或卖家数据。
• 任务涉及价格监控、竞品产品比较、MAP 合规执行或评论分析。
• 需要通过引导式工作流提取市场数据并总结发现。

前提条件

• .env 文件中包含 APIFY_TOKEN（位于 ~/.claude/.env）
• Node.js 20.6+（支持原生 --env-file）

工作流选择

用户需求	工作流	适用场景
跟踪价格、比较产品	工作流 1：产品与定价	价格监控、MAP 合规、竞品分析。可添加 AI 摘要以获取洞见。
分析评论（情感或质量）	工作流 2：评论	品牌认知、客户情绪、质量问题、缺陷模式
跨商店查找卖家	工作流 3：卖家	未经授权的转售商、通过 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

---

工作流 1：产品与定价

适用场景： 提取产品数据、价格和库存状态。跟踪竞品价格、检测 MAP 违规、对标产品或研究市场。

适用对象： 定价分析师、产品经理、市场研究人员。

输入选项

输入类型	字段	描述
产品 URL	detailsUrls	产品页面的直接 URL（使用对象格式）
分类 URL	listingUrls	分类或搜索结果页面的 URL
关键词搜索	keyword + marketplaces	在所选市场中搜索关键词

示例 - 产品 URL

{
  "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 摘要

添加以下字段以获取 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 - 产品 URL
• offers.price - 当前价格
• offers.priceCurrency - 货币代码（可能因卖家所在地区而异）
• brand.slogan - 品牌名称（嵌套在对象中）
• image - 产品图片 URL
• 当 additionalProperties: true 时，还会提供额外的卖家/库存信息

注意： 即使是美国搜索，结果中的货币也可能不同，因为价格反映了不同卖家所在地区的情况。

---

工作流 2：客户评论

适用场景： 提取评论，用于情感分析、品牌认知监测或质量问题检测。

适用对象： 品牌经理、客户体验团队、QA 团队、产品经理。

输入选项

输入类型	字段	描述
产品 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 - 5 星评论优先
• Lowest rated - 1 星评论优先

注意： sortReview: "Lowest rated" 选项在所有市场中可能无法稳定生效。进行质量分析时，请收集较大样本，并在后续处理中按评分筛选。

质量分析提示

• 选择有明确范围的抽样计划；仅增加评论数量并不能证明统计显著性或情绪具有代表性
• 留意重复出现的关键词：“broke”“defect”“quality”“returned”
• 如果排序结果不符合预期，请按评分筛选结果
• 与竞品进行交叉对比，以便开展基准分析

---

工作流 3：卖家情报

使用场景： 跨商店查找卖家、发现未经授权的经销商、评估供应商选项。

适用对象： 品牌保护团队、采购人员、供应链经理。

注意： 此工作流使用 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	结果总数上限

---

支持的市场平台

Amazon（20 多个地区）

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（40 多种国家/语言组合）

支持 IKEA 所有主要地区站点，并提供多种语言选项。

Google Shopping

用于跨多个商店发现卖家。

---

运行提取

步骤 1：设置 Skill 路径

SKILL_PATH=~/.claude/skills/apify-ecommerce

步骤 2：运行脚本

快速查看答案（在聊天中显示）：

node --env-file="$HOME/.claude/.env" "$SKILL_PATH/reference/scripts/run_actor.js" \
  --actor "apify/e-commerce-scraping-tool" \
  --input 'JSON_INPUT'

导出 CSV：

node --env-file="$HOME/.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="$HOME/.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

步骤 3：总结结果

报告：

• 提取的项目数量
• 文件位置（如已导出）
• 基于工作流的关键洞察：
  • 产品： 价格范围、异常值、MAP 违规
  • 评论： 平均评分、情感趋势、质量问题
  • 卖家： 卖家数量、发现的候选卖家；授权情况需要单独的品牌/合同证据

---

错误处理

错误	解决方案
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	检查市场平台值是否与支持列表完全一致

局限性

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为可替代特定环境验证、测试或专家审查的方案。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。

运行 Actor 会上传输入并产生服务提供商费用：请先确认经过审核的确切 Actor/构建版本、允许访问的网站/数据、结果/费用预算和数据保留期限。请检查当前输入/输出架构，不要假设所列的每个市场都受支持。此运行器在单次响应中最多获取 10,000 条记录；它不支持完整的分页导出，显示的五条记录仅供预览。导出会保留获取到的字段值，并拒绝覆盖现有文件；请选择新的私有路径。不要在命令参数或公开日志中放入敏感的 Actor 输入。本地等待超时不会取消远程运行，也不能证明远程运行失败；请保留其运行 ID，检查并核对状态，不要启动重复运行。POST 后出现意外 HTTP 错误时，也可能已创建一个会产生费用的运行。请参阅 Apify 身份验证。