findscripter 何时使用
- 需要从电商站点批量获取商品、价格、库存、评论或卖家数据。
- 任务涉及比价/价格监控、竞品对比、MAP（最低广告价）合规、评论情感与质量分析、跨店卖家发现。
- 需要一条可引导的工作流：选数据源 → 配 Actor 输入 → 导出 → 汇总洞察。
不该用的边界：
- 没有有效
APIFY_TOKEN（无可用配额/凭据）。 - 想绕过站点反爬、登录墙或自建分布式爬虫——本技能仅调用托管 Actor。
- 目标是非电商页面，或需要权威环境内的人工核验（输出不可替代专家审查与本地验证）。
- 必填输入、权限或成功标准不明确时，先停下来向用户澄清。
步骤
- 选工作流并确定数据源（商品/价格、评论、卖家）。
- 按工作流配置 Actor 输入（见下方 JSON）。
- 询问用户偏好：输出格式（聊天展示 / CSV / JSON）与文件名。
- 运行抽取脚本。
- 汇总结果（条数、文件位置、关键洞察）。
工作流选型：
| 需求 | 工作流 | 适用 |
|---|---|---|
| 跟踪价格、对比商品 | 工作流 1：商品与价格 | 价格监控、MAP 合规、竞品分析；可加 AI 摘要 |
| 分析评论（情感/质量） | 工作流 2：评论 | 品牌口碑、客户情感、质量与缺陷模式 |
| 跨店找卖家 | 工作流 3：卖家 | 未授权经销商排查、供应商发现（走 Google Shopping） |
指令
前置条件：~/.claude/.env 内含 APIFY_TOKEN；Node.js 20.6+（原生支持 --env-file）。
设定路径并运行（JSON_INPUT 替换为对应工作流的输入）：
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（或把 csv/.csv 换成 json/.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.csv \
--format csv
Actor ID 固定为 apify/e-commerce-scraping-tool。
示例
工作流 1（关键词搜索 + AI 摘要）：
{
"keyword": "robot vacuum",
"marketplaces": ["www.amazon.com"],
"maxProductResults": 50,
"additionalProperties": true,
"fieldsToAnalyze": ["name", "offers", "brand"],
"customPrompt": "Summarize price range and identify top brands"
}
也可用 detailsUrls（商品页对象数组）或 listingUrls（类目/搜索页）作为输入。输出字段含 name、url、offers.price、offers.priceCurrency、brand.slogan（品牌名嵌套于此）、image 等。
工作流 2（评论）：
{
"reviewListingUrls": [{"url": "https://www.amazon.com/dp/B09V3KXJPB"}],
"sortReview": "Most recent",
"additionalReviewProperties": true,
"maxReviewResults": 500
}
排序可选 Most recent（推荐）/Most relevant/Most helpful/Highest rated/Lowest rated。也支持 keywordReviews + marketplacesReviews 按关键词搜评论。
工作流 3（卖家，走 Google Shopping）：
{
"googleShoppingSearchKeyword": "Nike Air Max 90",
"scrapeSellersFromGoogleShopping": true,
"countryCode": "us",
"maxGoogleShoppingSellersPerProduct": 20,
"maxGoogleShoppingResults": 100
}
注意事项
- 即使美国关键词搜索，结果币种也可能因卖家所在区域而不同（看
offers.priceCurrency）。 sortReview: "Lowest rated"在部分平台不稳定；做质量分析时取大样本（高maxReviewResults），再在后处理按评分过滤；关注 "broke"/"defect"/"quality"/"returned" 等复现关键词。- 卖家工作流依赖 Google Shopping，直接卖家主页 URL 不被可靠支持。
- 支持平台：Amazon 20+ 区域站、Walmart/Costco/Home Depot、Allegro/Alza/Kaufland/Cdiscount 等欧洲零售商、IKEA 40+ 站点、Google Shopping。
marketplaces取值须与官方列表完全一致。 - 常见报错处理：
APIFY_TOKEN not found→ 检查~/.claude/.env；Actor not found→ 核对 Actor ID；Run FAILED→ 看错误里的 Apify 控制台链接；Timeout→ 减小maxProductResults或增大--timeout；No results→ 核验 URL 可访问；Invalid marketplace→ 比对支持列表。 - 汇总时按工作流给洞察：商品（价格区间、异常值、MAP 违规）/评论（均分、情感趋势、质量问题）/卖家（卖家数、发现的未授权卖家）。
互见
无（暂无强相关的「技能大典」条目）。
本条采编自 sickn33/antigravity-awesome-skills（MIT）。