线索生成

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

前置条件

• 已在 OpenClaw 设置中配置 APIFY_TOKEN
• Node.js 20.6 及以上版本
• mcpc CLI（通过技能元数据自动安装）

输入校验规则

在将任意值代入 Bash 命令前，需执行以下校验：

• ACTOR_ID：必须为技术名称（格式为 owner/actor-name，仅允许字母、数字、短横线 `-`、点号 `.` 和一个斜杠 `/`），或原始 ID（严格为 17 位字母数字组合，例如 oeiQgfg5fsmIJB7Cn）。拒绝包含 Shell 元字符的值（; | & $ ` ( ) { } < > ! n）。
• SEARCH_KEYWORDS：仅允许纯文本单词。拒绝包含 Shell 元字符的值。
• JSON_INPUT：必须为合法 JSON 格式；不得包含单引号（应使用转义的双引号）；使用前须验证其结构有效性。
• 输出文件名：必须符合 YYYY-MM-DD_descriptive-name.{csv,json} 格式；禁止出现路径分隔符（/、..）、空格及 Shell 元字符。

工作流程

请复制下方清单并跟踪执行进度：

任务进度：
- [ ] 步骤 1：确定线索来源（选择 Actor）
- [ ] 步骤 2：通过 mcpc 获取 Actor 的 Schema
- [ ] 步骤 3：询问用户偏好（格式、文件名）
- [ ] 步骤 4：运行线索查找脚本
- [ ] 步骤 5：汇总结果

步骤 1：确定线索来源

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

步骤 2：获取 Actor Schema

使用 mcpc 动态获取 Actor 的输入 Schema 及详细信息：

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 {baseDir}/reference/scripts/run_actor.js 
  --actor 'ACTOR_ID' 
  --input 'JSON_INPUT'

CSV 格式：

node {baseDir}/reference/scripts/run_actor.js 
  --actor 'ACTOR_ID' 
  --input 'JSON_INPUT' 
  --output 'YYYY-MM-DD_OUTPUT_FILE.csv' 
  --format csv

JSON 格式：

node {baseDir}/reference/scripts/run_actor.js 
  --actor 'ACTOR_ID' 
  --input 'JSON_INPUT' 
  --output 'YYYY-MM-DD_OUTPUT_FILE.json' 
  --format json

步骤 5：汇总结果

执行完成后，需报告以下信息：

• 发现的线索总数
• 输出文件路径与文件名
• 可用的关键字段列表
• 建议后续操作（例如：筛选、信息增强）

安全与数据隐私

本技能指导智能体完成以下操作：选择 Apify Actor、通过 mcpc 获取其 Schema，并运行爬虫任务。所附脚本仅与 api.apify.com 通信，并将输出写入当前工作目录下的文件；不会访问无关系统文件或其他环境变量。

Apify Actors 仅抓取公开可访问的数据，不会收集目标平台之外的私有信息或个人身份信息（PII）。为进一步确保安全性，您可通过查询 https://api.apify.com/v2/acts/:actorId 查看 Actor 的权限等级：LIMITED_PERMISSIONS 表示其运行于受限 sandbox 环境中；FULL_PERMISSIONS 则表示具备更广泛的系统访问能力。详情请参阅 Apify《通用条款与条件》。

错误处理

APIFY_TOKEN not found — 提示用户在 OpenClaw 设置中配置 APIFY_TOKEN
mcpc not found — 执行 npm install -g @apify/mcpc
Actor not found — 检查 Actor ID 拼写是否正确
Run FAILED — 提示用户查看错误输出中的 Apify 控制台链接
Timeout — 减少输入数据量或增大 --timeout 参数值