Apify 电商解决方案

电商数据提取

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

使用场景

• 需要从电商网站获取产品、定价、评论、库存或卖家数据。

• 任务涉及价格监控、竞品对比、最低广告价格 (MAP) 执行或评论分析。

• 需要一套引导式工作流来提取市场数据并总结结果。

前置条件

• 包含 APIFY_TOKEN 的 .env 文件（位于 ~/.claude/.env）

• Node.js 20.6+（以支持原生 --env-file）

工作流选择

| 用户需求 | 工作流 | 最适用场景 |
|-----------|----------|----------|
| 追踪价格，对比产品 | 工作流 1：产品与定价 | 价格监控、MAP 合规性、竞品分析。可添加 AI 总结以获取洞察。 |
| 分析评论（情感或质量） | 工作流 2：评论 | 品牌认知、客户情感、质量问题、缺陷模式 |
| 跨店查找卖家 | 工作流 3：卖家 | 未经授权的转售商、通过 Google Shopping 发现供应商 |

进度追踪

任务进度：
[ ] 步骤 1：选择工作流并确定数据源
[ ] 步骤 2：配置 Actor 输入
[ ] 步骤 3：询问用户偏好（格式、文件名）
[ ] 步骤 4：运行提取脚本
[ ] 步骤 5：总结结果

---

工作流 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" 选项在不同市场中的表现可能不一致。进行质量分析时，建议收集大样本量并在后处理阶段按评分过滤。

质量分析技巧

• 设置较高的 maxReviewResults 以确保统计显著性

• 寻找重复出现的关键词：如 "broke"（损坏）、"defect"（缺陷）、"quality"（质量）、"returned"（退货）

• 如果排序未达到预期，请在结果中按评分过滤

• 与竞争对手产品进行交叉比对以建立基准

---

工作流 3：卖家情报

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

适用人群： 品牌保护团队、采购部门、供应链经理。

> 注意： 此工作流使用 Google Shopping 来跨店铺查找卖家。目前不支持直接使用卖家个人资料 URL。

输入配置

{
  "googleShoppingSearchKeyword": "Nike Air Max 90",
  "scrapeSellersFromGoogleShopping": true,
  "countryCode": "us",
  "maxGoogleShoppingSellersPerProduct": 20,
  "maxGoogleShoppingResults": 100
}

选项

---

支持的市场

Amazon (20+ 区域)

美国主要零售商

欧洲零售商

IKEA (40+ 国家/语言组合)

Google Shopping

---

运行提取

第 1 步：设置 Skill 路径

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

第 2 步：运行脚本

快速回答（在聊天界面显示）：

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

第 3 步：总结结果

报告内容：

• 提取的项目数量

• 文件位置（如果已导出）

• 基于工作流的关键洞察：

---

错误处理

| 错误 | 解决方案 |
|-------|----------|
| 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 的值是否与支持列表完全一致 |

局限性

• 仅在任务明确符合上述范围时使用此 Skill。

• 不要将输出结果视为特定环境验证、测试或专家评审的替代方案。

• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。