apify-lead-generation

潜在客户开发

使用 Apify Actors 从多个平台抓取潜在客户。

前置条件

（无需提前检查）

• 包含 APIFY_TOKEN 的 .env 文件
• Node.js 20.6+（支持原生 --env-file）
• mcpc CLI 工具：npm install -g @apify/mcpc

工作流

复制此清单并跟踪进度：

Task Progress:
- [ ] Step 1: Determine lead source (select Actor)
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the lead finder script
- [ ] Step 5: Summarize results

步骤 1：确定潜在客户来源

根据用户需求选择合适的 Actor：

用户需求	Actor ID	最适用于
本地商家	compass/crawler-google-places	餐厅、健身房、商店
联系信息补全	vdrmota/contact-info-scraper	从 URL 获取电子邮件、电话
Instagram 个人资料	apify/instagram-profile-scraper	发掘网红
Instagram 帖子/评论	apify/instagram-scraper	帖子、评论、主题标签、地点
Instagram 搜索	apify/instagram-search-scraper	发掘地点、用户、主题标签
TikTok 视频/主题标签	clockworks/tiktok-scraper	全面提取 TikTok 数据
TikTok 主题标签/个人资料	clockworks/free-tiktok-scraper	免费的 TikTok 数据提取器
TikTok 用户搜索	clockworks/tiktok-user-search-scraper	按关键词查找用户
TikTok 个人资料	clockworks/tiktok-profile-scraper	联系创作者
TikTok 粉丝/关注列表	clockworks/tiktok-followers-scraper	受众分析、细分
Facebook 公共主页	apify/facebook-pages-scraper	商业联系信息
Facebook 公共主页联系信息	apify/facebook-page-contact-information	提取电子邮件、电话、地址
Facebook 群组	apify/facebook-groups-scraper	购买意向信号
Facebook 活动	apify/facebook-events-scraper	活动社交、合作伙伴关系
Google 搜索	apify/google-search-scraper	广泛发掘潜在客户
YouTube 频道	streamers/youtube-scraper	创作者合作
Google Maps 电子邮件	poidata/google-maps-email-extractor	直接提取电子邮件

步骤 2：获取 Actor 架构

使用 mcpc 动态获取 Actor 的输入架构和详细信息：

export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content"

将 ACTOR_ID 替换为所选 Actor（例如，compass/crawler-google-places）。

返回内容包括：

• Actor 描述和 README
• 必需和可选的输入参数
• 输出字段（如有）

步骤 3：询问用户偏好

运行前，询问：

1. 输出格式：
   • 快速回答 - 在聊天中显示前几个结果（不保存文件）
   • CSV - 导出完整数据，包含所有字段
   • JSON - 以 JSON 格式导出完整数据
2. 结果数量：根据使用场景的性质确定

步骤 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 mcpc not found - 请用户安装 npm install -g @apify/mcpc Actor not found - 检查 Actor ID 拼写 Run FAILED - 请用户检查错误输出中的 Apify 控制台链接 Timeout - 减少输入量或增大 --timeout