工作流自动化
在 Paperclip 中使用 AdsCrawl
通过 AdsCrawl,让 Paperclip 管理的 Agent 能够读取实时网页。连接托管 MCP 服务、分配调研任务,并将结果记录到任务中。Paperclip 负责协调工作,AdsCrawl 提供浏览器会话。
能做什么
任务中的网页调研
让负责的 Agent 读取公开网页,并在 Paperclip 任务中记录标题、调研结果和来源链接。
多步浏览器操作
使用 MCP 工具在同一托管会话中打开、读取和导航页面,任务完成后关闭会话。
可重复的调研流程
手动任务验证通过后,可将任务指令复用于 Paperclip Routine,定期检查网页并生成报告。
准备工作
- 已运行的 Paperclip 实例、已配置的 Agent,以及管理连接的权限。连接器步骤依据 Paperclip v2026.1106.0 文档,界面名称以安装版本为准。
- 具有可用积分的 AdsCrawl API Key,发起 MCP 调用的环境能够通过 HTTPS 访问 api.adscrawl.net。
- 选择可选的运行环境接法时,需要一个使用 Claude CLI 引擎的 claude_local Agent,并在执行主机上安装、登录 Claude Code。
接入方式 01
MCP 连接器
适合希望在 Paperclip 中管理 Agent 访问范围和工具权限的用户。将 AdsCrawl 添加为自定义远程 MCP 服务。
添加服务地址
打开 Connectors,选择 Connect your own MCP server,填写下方地址,并将连接命名为 AdsCrawl。服务使用 Streamable HTTP。
https://api.adscrawl.net/mcp配置 API Key 请求头
使用 API Key/自定义请求头配置,在凭据表单中以 x-api-key 填入实际密钥。下方值是占位符;密钥保存在连接凭据中,不要写入任务内容。
x-api-key: YOUR_ADSCRAWL_API_KEY选择 Agent 和工具
选择可以使用此连接的 Agent,再打开 Permissions 并刷新工具列表。首次网页读取任务需可用的工具为 browser_open、browser_read、browser_navigate 和 browser_close,其余工具按实际流程配置。
运行首个任务
创建 Paperclip 任务、分配给有访问权限的 Agent,并使用下方验证指令。预期得到标题 Example Domain、来源链接,以及 browser_close 返回的 confirmed: true。若工具缺失或权限拦截,检查任务运行记录。
接入方式 02
Claude Code 运行环境 MCP
适用于已有 claude_local Agent 且 engine 为 cli 的另一种接法。由运行环境直接连接,这些调用不经过 Paperclip 连接器的工具权限或审核队列。同一 Agent 选择一种接法即可。
确认执行工作目录
确认 Agent 实际使用的 adapter、engine 和 cwd。本方案针对 CLI 引擎下的旧版 claude_local 适配器;新版 Paperclip Runner 需按其文档配置。在 Agent 实际执行的主机或沙箱中进入该 cwd。
合并项目 MCP 配置
在该工作目录的 .mcp.json 中加入 adscrawl 配置,并保留已有服务。环境变量引用由 Claude Code 展开,此文件无需填写实际密钥。
{ "mcpServers": { "adscrawl": { "type": "http", "url": "https://api.adscrawl.net/mcp", "headers": { "x-api-key": "${ADSCRAWL_API_KEY}" } } } }配置执行环境
通过 Paperclip 密钥引用,在 Agent 的适配器 env 中设置 ADSCRAWL_API_KEY。仅在个人终端设置变量,不一定能传入服务进程或沙箱。共享该项目配置的其他 Agent 也能发现此服务。
在同一环境验证
在相同 cwd 和环境中运行 claude mcp list,确认 AdsCrawl 连接成功。无人值守运行前,完成 Claude Code 要求的项目 MCP 信任配置,再分配下方首个任务并确认浏览器会话关闭。
claude mcp list
试一次
完成接入后,将这段指令发给 Agent,确认功能可用。
使用 AdsCrawl 打开 https://example.com 并读取页面标题。如需导航,请在同一会话中完成。在此 Paperclip 任务中记录标题和来源 URL。无论读取是否成功,结束时都调用 browser_close 关闭浏览器,并报告 confirmed 是否为 true。本次验证不截图。用量与限制
- 本指南通过自定义 MCP 完成接入。Paperclip 管理任务与 Agent 执行,Agent 及其模型需单独配置。
- AdsCrawl 会话消耗 AdsCrawl 积分。浏览器费用请查看 AdsCrawl Billing & Usage,不要将其视为已包含在 Paperclip 上报的模型费用中。
- 保持 browser_close 可用,并检查 confirmed: true。Paperclip 任务结束或运行进程退出,不代表远程浏览器会话已经停止。
- browser_screenshot 会生成可公开访问的 JPEG 链接,适用于图片可以分享的流程;首个网页读取任务无需使用它。