关于 apify-market-research
用于借助 Apify Actors 从多个平台采集数据并开展市场研究的技能，适合市场分析与行业调研。它根据研究目标选择 Actor，并支持快速查看结果或导出 CSV、JSON。
主要功能
- 01按研究目标选择 Apify Actor
- 02获取 Actor 输入架构
- 03设置结果数量与输出格式
- 04运行采集并汇总市场发现
适用场景
- 01分析地区商家分布和地理信息
- 02研究市场价格、需求与趋势
- 03调研社交平台社群和受众兴趣
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/apify-market-research确认已加载。
附带文件reference/scripts/fetch_actor_details.jsreference/scripts/run_actor.js
详细介绍
市场调研
使用 Apify Actors 从多个平台提取数据，开展市场调研。
前提条件
（无需提前检查）
.env文件中包含APIFY_TOKEN- Node.js 20.6+（支持原生
--env-file）
工作流
复制此清单并跟踪进度：
Task Progress:
- [ ] Step 1: Identify market research type (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analysis script
- [ ] Step 5: Summarize findings
步骤 1：确定市场调研类型
根据调研需求选择合适的 Actor：
| 用户需求 | Actor ID | 最适用于 |
|---|---|---|
| 市场密度 | compass/crawler-google-places | 位置分析 |
| 地理空间分析 | compass/google-maps-extractor | 商家地图绘制 |
| 区域兴趣 | apify/google-trends-scraper | 趋势数据 |
| 定价和需求 | apify/facebook-marketplace-scraper | 市场定价 |
| 活动市场 | apify/facebook-events-scraper | 活动分析 |
| 消费者需求 | apify/facebook-groups-scraper | 群组调研 |
| 市场格局 | apify/facebook-pages-scraper | 商家主页 |
| 商家密度 | apify/facebook-page-contact-information | 联系方式数据 |
| 文化洞察 | apify/facebook-photos-scraper | 视觉调研 |
| 细分市场定位 | apify/instagram-hashtag-scraper | 话题标签调研 |
| 话题标签统计 | apify/instagram-hashtag-stats | 市场规模评估 |
| 市场动态 | apify/instagram-reel-scraper | 动态分析 |
| 市场情报 | apify/instagram-scraper | 完整数据 |
| 产品发布调研 | apify/instagram-api-scraper | API 访问 |
| 酒店服务市场 | voyager/booking-scraper | 酒店数据 |
| 旅游洞察 | maxcopell/tripadvisor-reviews | 评论分析 |
步骤 2：获取 Actor 架构
获取 Actor 的输入架构和详细信息：
node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/fetch_actor_details.js --actor "ACTOR_ID"
将 ACTOR_ID 替换为所选 Actor（例如，compass/crawler-google-places）。
返回内容包括：
- Actor 信息（标题、描述、URL、类别、统计数据、评分）
- README 摘要
- 输入架构（必需和可选参数）
步骤 3：询问用户偏好
简单查询时（例如“Nike 有多少粉丝？”、“帮我在布拉格找 5 家咖啡店”），跳过此步骤，直接使用快速回答模式并进入步骤 4。
对于较大规模的数据抓取任务，请询问：
- 输出格式：
- 快速回答 - 在聊天中显示少量结果（不保存文件）
- CSV - 导出所有字段的完整数据
- JSON - 以 JSON 格式导出完整数据
- 结果数量：根据用例特点确定
成本控制：始终在 Actor 输入中设置合理的结果上限（例如 maxResults、resultsLimit、maxCrawledPages，或输入架构中的等效字段）。除非用户明确要求更多，默认最多返回 100 条结果。运行大规模抓取（1000+ 条结果）前，请提醒用户，因为这会消耗更多 Apify 额度。
步骤 4：运行脚本
快速回答（在聊天中显示，不生成文件）：
node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
--actor "ACTOR_ID" \
--input 'JSON_INPUT'
CSV：
node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
--actor "ACTOR_ID" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_OUTPUT_FILE.csv \
--format csv
JSON：
node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
--actor "ACTOR_ID" \
--input 'JSON_INPUT' \
--output YYYY-MM-DD_OUTPUT_FILE.json \
--format json
步骤 5：总结发现
完成后，报告：
- 找到的结果数量
- 文件位置和名称
- 关键市场洞察
- 建议的后续步骤（深入分析、验证）
错误处理
APIFY_TOKEN not found - 请用户创建包含 APIFY_TOKEN=your_token 的 .env 文件
Actor not found - 检查 Actor ID 拼写
Run FAILED - 请用户查看错误输出中的 Apify 控制台链接
Timeout - 减少输入规模或增加 --timeout