Lead Generation
Scrape leads from multiple platforms using Apify Actors.
Prerequisites
- -
APIFY_TOKEN configured in OpenClaw settings - Node.js 20.6+
- INLINECODE1 CLI (auto-installed via skill metadata)
Input Sanitization Rules
Before substituting any value into a bash command:
- - ACTORID: Must be either a technical name (
owner/actor-name — alphanumeric, hyphens, dots, one slash) or a raw ID (exactly 17 alphanumeric characters, e.g., oeiQgfg5fsmIJB7Cn). Reject values containing shell metacharacters (` ; | & $ ( ) { } < > ! \n `).
- **SEARCH_KEYWORDS**: Plain text words only. Reject shell metacharacters.
- **JSON_INPUT**: Must be valid JSON. Must not contain single quotes (use escaped double quotes). Validate structure before use.
- **Output filenames**: Must match YYYY-MM-DDdescriptive-name.{csv,json}. No path separators (/, ..), no spaces, no metacharacters.
## Workflow
Copy this checklist and track progress:
CODEBLOCK0
### Step 1: Determine Lead Source
Select the appropriate Actor based on user needs:
| User Need | Actor ID | Best For |
|-----------|----------|----------|
| Local businesses | compass/crawler-google-places | Restaurants, gyms, shops |
| Contact enrichment | vdrmota/contact-info-scraper | Emails, phones from URLs |
| Instagram profiles | apify/instagram-profile-scraper | Influencer discovery |
| Instagram posts/comments | apify/instagram-scraper | Posts, comments, hashtags, places |
| Instagram search | apify/instagram-search-scraper | Places, users, hashtags discovery |
| TikTok videos/hashtags | clockworks/tiktok-scraper | Comprehensive TikTok data extraction |
| TikTok hashtags/profiles | clockworks/free-tiktok-scraper | Free TikTok data extractor |
| TikTok user search | clockworks/tiktok-user-search-scraper | Find users by keywords |
| TikTok profiles | clockworks/tiktok-profile-scraper | Creator outreach |
| TikTok followers/following | clockworks/tiktok-followers-scraper | Audience analysis, segmentation |
| Facebook pages | apify/facebook-pages-scraper | Business contacts |
| Facebook page contacts | apify/facebook-page-contact-information | Extract emails, phones, addresses |
| Facebook groups | apify/facebook-groups-scraper | Buying intent signals |
| Facebook events | apify/facebook-events-scraper | Event networking, partnerships |
| Google Search | apify/google-search-scraper | Broad lead discovery |
| YouTube channels | streamers/youtube-scraper | Creator partnerships |
| Google Maps emails | poidata/google-maps-email-extractor | Direct email extraction |
### Step 2: Fetch Actor Schema
Fetch the Actor's input schema and details dynamically using mcpc:
CODEBLOCK1
Replace ACTORID with the selected Actor (e.g., compass/crawler-google-places).
This returns:
- Actor description and README
- Required and optional input parameters
- Output fields (if available)
### Step 3: Ask User Preferences
Before running, ask:
1. **Output format**:
- **Quick answer** - Display top few results in chat (no file saved)
- **CSV** - Full export with all fields
- **JSON** - Full export in JSON format
2. **Number of results**: Based on character of use case
### Step 4: Run the Script
**Quick answer (display in chat, no file):**
CODEBLOCK2
**CSV:**
CODEBLOCK3
**JSON:**
CODEBLOCK4
### Step 5: Summarize Results
After completion, report:
- Number of leads found
- File location and name
- Key fields available
- Suggested next steps (filtering, enrichment)
## Security & Data Privacy
This skill instructs the agent to select an Apify Actor, fetch its schema (via mcpc), and run scrapers. The included script communicates only with api.apify.com and writes outputs to files under the current working directory; it does not access unrelated system files or other environment variables.
Apify Actors only scrape publicly available data and do not collect private or personally identifiable information beyond what is openly accessible on the target platforms. For additional security assurance, you can check an Actor's permission level by querying https://api.apify.com/v2/acts/:actorId — an Actor with LIMITEDPERMISSIONS operates in a restricted sandbox, while FULLPERMISSIONS indicates broader system access. For full details, see [Apify's General Terms and Conditions](https://docs.apify.com/legal/general-terms-and-conditions).
## Error Handling
APIFYTOKEN not found - Ask user to configure APIFY_TOKEN in OpenClaw settings
mcpc not found - Run npm install -g @apify/mcpc
Actor not found - Check Actor ID spelling
Run FAILED - Ask user to check Apify console link in error output
Timeout - Reduce input size or increase --timeout`
潜在客户开发
使用Apify Actors从多个平台抓取潜在客户信息。
前置条件
- - 在OpenClaw设置中配置了APIFY_TOKEN
- Node.js 20.6+
- mcpc CLI(通过技能元数据自动安装)
输入净化规则
在将任何值替换到bash命令之前:
- - ACTORID:必须是技术名称(owner/actor-name — 字母数字、连字符、点号、一个斜杠)或原始ID(恰好17个字母数字字符,例如oeiQgfg5fsmIJB7Cn)。拒绝包含shell元字符( ; | & $ ( ) { } < > ! \n )的值。
- SEARCHKEYWORDS:仅限纯文本单词。拒绝shell元字符。
- JSONINPUT:必须是有效的JSON。不得包含单引号(使用转义的双引号)。使用前验证结构。
- 输出文件名:必须匹配YYYY-MM-DDdescriptive-name.{csv,json}。无路径分隔符(/、..)、无空格、无元字符。
工作流程
复制此清单并跟踪进度:
任务进度:
- - [ ] 步骤1:确定潜在客户来源(选择Actor)
- [ ] 步骤2:通过mcpc获取Actor架构
- [ ] 步骤3:询问用户偏好(格式、文件名)
- [ ] 步骤4:运行潜在客户查找脚本
- [ ] 步骤5:总结结果
步骤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架构
使用mcpc动态获取Actor的输入架构和详细信息:
bash
mcpc --json mcp.apify.com --header Authorization: Bearer $APIFYTOKEN tools-call fetch-actor-details actor:=ACTORID | jq -r .content
将ACTOR_ID替换为选定的Actor(例如compass/crawler-google-places)。
这将返回:
- - Actor描述和README
- 必需和可选的输入参数
- 输出字段(如可用)
步骤3:询问用户偏好
运行前,询问:
- 1. 输出格式:
-
快速回答 - 在聊天中显示前几条结果(不保存文件)
-
CSV - 完整导出所有字段
-
JSON - 以JSON格式完整导出
- 2. 结果数量:根据用例特点确定
步骤4:运行脚本
快速回答(在聊天中显示,不保存文件):
bash
node {baseDir}/reference/scripts/run_actor.js \
--actor ACTOR_ID \
--input JSON_INPUT
CSV:
bash
node {baseDir}/reference/scripts/run_actor.js \
--actor ACTOR_ID \
--input JSON_INPUT \
--output YYYY-MM-DDOUTPUTFILE.csv \
--format csv
JSON:
bash
node {baseDir}/reference/scripts/run_actor.js \
--actor ACTOR_ID \
--input JSON_INPUT \
--output YYYY-MM-DDOUTPUTFILE.json \
--format json
步骤5:总结结果
完成后,报告:
- - 找到的潜在客户数量
- 文件位置和名称
- 可用的关键字段
- 建议的后续步骤(筛选、丰富)
安全与数据隐私
本技能指示代理选择Apify Actor、获取其架构(通过mcpc)并运行抓取工具。包含的脚本仅与api.apify.com通信,并将输出写入当前工作目录下的文件;不会访问不相关的系统文件或其他环境变量。
Apify Actors仅抓取公开可用的数据,不会收集目标平台上公开可访问范围之外的私人或个人身份信息。如需额外的安全保障,您可以通过查询https://api.apify.com/v2/acts/:actorId来检查Actor的权限级别——具有LIMITEDPERMISSIONS的Actor在受限沙箱中运行,而FULLPERMISSIONS表示更广泛的系统访问权限。详情请参阅Apify通用条款和条件。
错误处理
APIFYTOKEN not found - 请用户在OpenClaw设置中配置APIFYTOKEN
mcpc not found - 运行npm install -g @apify/mcpc
Actor not found - 检查Actor ID拼写
Run FAILED - 请用户检查错误输出中的Apify控制台链接
Timeout - 减少输入大小或增加--timeout参数