关于 apify-lead-generation
面向业务、创作者和联系信息线索采集的 Apify 工作流技能。它指导按来源选择 Actor、查看输入 Schema、运行采集并整理导出结果，同时强调运行授权与数据使用边界。
主要功能
- 01按线索来源选择 Apify Actor
- 02检查 Actor 输入 Schema
- 03导出 CSV 或 JSON 结果
- 04总结线索数量与字段
- 05采集前核验权限与限制
适用场景
- 01发现本地商家潜在客户
- 02查找社交平台创作者
- 03从搜索或地图数据中筛选线索
MCP 相关
可通过会话中获批的 Apify 连接器检查 Actor 信息与 Schema；也可在 Apify Console 中查看。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/apify-lead-generation确认已加载。
附带文件reference/scripts/run_actor.js
详细介绍
线索生成
使用 Apify Actors 从多个平台抓取线索。
适用场景
- 你需要从地图、搜索、社交或视频平台获取企业、创作者或联系人线索。
- 任务涉及选择 Apify Actor 来发现潜在客户并提取外联数据。
- 你需要导出的线索数据，以及关于线索质量或细分情况的简要总结。
前置条件
在进行任何付费运行前，确认前置条件。
.env文件中包含APIFY_TOKEN- Node.js 20.6+（原生支持
--env-file） - 已获批准的 Apify 连接器或 Console 访问权限，用于检查所选 Actor 及其架构；捆绑的运行器直接使用 REST。
- 将
.env保持为未跟踪且私有；在本地配置令牌，不要将其粘贴到聊天或命令参数中。
工作流
复制此检查清单并跟踪进度：
Task Progress:
- [ ] Step 1: Determine lead source (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] 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 地图电子邮件 | poidata/google-maps-email-extractor | 直接提取电子邮件 |
第 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 的工作量或费用。该助手会向 Apify 发送可识别 skill 的 User-Agent。解析命令占位符中的已安装 skill 目录。输出文件必须使用新路径；导出会保留长值和异构字段。快速回答最多获取五条记录；分享前尽量减少或删去个人字段。
仅收集获授权用途所需的业务联系字段。公开可见不代表同意联系：保留来源 URL 和日期，排除选择退出者和重复项，并在使用前核实司法管辖区和平台限制。不要根据关注者或群组成员身份推断敏感个人特征。发现潜在客户并不代表获准发送消息或将联系人上传到其他服务。
限制
- 仅当任务明确符合上述范围时，才使用此 skill。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并要求澄清。