关于 apify-market-research
使用 Apify Actors 从地图、社交平台、趋势和旅游来源收集市场研究数据，适合需要结构化数据及机会与风险概览的研究任务。工作流包含检查 Actor 参数、征求输出偏好、运行分析和汇总发现。
主要功能
- 01按研究目标选择 Apify Actor
- 02检查 Actor 输入架构
- 03导出 CSV 或 JSON 结果
- 04汇总市场发现与后续步骤
- 05运行前确认范围和结果限制
适用场景
- 01分析区域兴趣或商家分布
- 02研究商品价格与消费者需求
- 03汇总旅游住宿评价
- 04收集社交平台话题与活动数据
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/apify-market-research确认已加载。
附带文件reference/scripts/run_actor.js
详细介绍
市场调研
使用 Apify Actors 从多个平台提取数据，开展市场调研。
适用场景
- 需要市场规模、区域需求、定价、趋势或消费者行为数据。
- 需要使用 Apify 从地图、旅游、Facebook、Instagram 或趋势来源收集调研数据。
- 需要结构化市场数据，以及对机会或风险的综合分析。
前置条件
开始任何付费运行前，请确认前置条件。
.env文件中包含APIFY_TOKEN- Node.js 20.6+（支持原生
--env-file） - 已获批准的 Apify 连接器或 Console 访问权限，用于检查所选 Actor 及其架构；内置运行程序直接使用 REST。
- 请勿将
.env纳入版本控制，并妥善保密；在本地配置令牌，不要将其粘贴到聊天中或作为命令参数传入。
工作流
复制此清单并跟踪进度：
Task Progress:
- [ ] Step 1: Identify market research type (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] 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 架构
使用当前会话中可用的、经过身份验证的 Apify 连接器，或访问其 Console 页面，检查当前 Actor 详情和输入架构。调用之前，先确认实际的工具名称和参数。不要使用 shell 替换解析 .env，也不要将令牌作为 CLI 标头参数传入。请将 Actor 表视为候选项列表，而非已验证可用性或架构的信息。
返回内容包括：
- Actor 描述和 README
- 必填和可选输入参数
- 输出字段（如有）
步骤 3：询问用户偏好
运行之前，询问：
- 输出格式：
- 快速回答 - 在聊天中显示少量结果（不保存文件）
- CSV - 有范围限制的导出，包含返回字段的并集
- JSON - 以 JSON 格式进行有范围限制的导出
- 结果数量：根据使用场景的特点确定
步骤 4：运行脚本
快速回答（在聊天中显示，不生成文件）：
node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
--actor "ACTOR_ID" \
--input 'JSON_INPUT'
CSV：
node --env-file=.env "<resolved-skill-directory>/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 "<resolved-skill-directory>/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 文件
Connector unavailable - 通过 Console 检查架构；不要声称调用了不可用的工具。
Actor not found - 检查 Actor ID 拼写
Run FAILED - 请用户检查错误输出中的 Apify 控制台链接
Timeout - 本地超时不会终止远程运行。重试前，请在 Console 中检查打印出的运行 ID，以避免重复扣费。
运行边界
启动前，请根据用户的请求确认所选 Actor、获授权的公开数据范围、当前输入架构、结果限制和定价。遵守来源条款和访问控制；不要收集私人群组数据或不必要的个人联系方式。先从 Actor 支持的较小输入限制开始。--max-items 仅限制下载的输出（默认值为 1000）；它不会限制 Actor 的工作量或费用。此 helper 会向 Apify 发送用于标识 skill 的 User-Agent。请在命令占位符中解析已安装 skill 的目录。输出文件必须使用新路径；导出内容会保留长值和异构字段。快速回答最多获取五条记录；分享前请尽量减少或删除个人字段。
限制
- 仅当任务明确符合上述范围时，才使用此 skill。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必要输入、权限、安全边界或成功标准，请停止并请求澄清。