跳转到主要内容
全部集成

工作流自动化

在 Paperclip 中使用 AdsCrawl

通过 AdsCrawl,让 Paperclip 管理的 Agent 能够读取实时网页。连接托管 MCP 服务、分配调研任务,并将结果记录到任务中。Paperclip 负责协调工作,AdsCrawl 提供浏览器会话。

能做什么

01

任务中的网页调研

让负责的 Agent 读取公开网页,并在 Paperclip 任务中记录标题、调研结果和来源链接。

02

多步浏览器操作

使用 MCP 工具在同一托管会话中打开、读取和导航页面,任务完成后关闭会话。

03

可重复的调研流程

手动任务验证通过后,可将任务指令复用于 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 服务。

  1. 添加服务地址

    打开 Connectors,选择 Connect your own MCP server,填写下方地址,并将连接命名为 AdsCrawl。服务使用 Streamable HTTP。

    URL
    https://api.adscrawl.net/mcp
  2. 配置 API Key 请求头

    使用 API Key/自定义请求头配置,在凭据表单中以 x-api-key 填入实际密钥。下方值是占位符;密钥保存在连接凭据中,不要写入任务内容。

    Header
    x-api-key: YOUR_ADSCRAWL_API_KEY
  3. 选择 Agent 和工具

    选择可以使用此连接的 Agent,再打开 Permissions 并刷新工具列表。首次网页读取任务需可用的工具为 browser_open、browser_read、browser_navigate 和 browser_close,其余工具按实际流程配置。

  4. 运行首个任务

    创建 Paperclip 任务、分配给有访问权限的 Agent,并使用下方验证指令。预期得到标题 Example Domain、来源链接,以及 browser_close 返回的 confirmed: true。若工具缺失或权限拦截,检查任务运行记录。

接入方式 02

Claude Code 运行环境 MCP

适用于已有 claude_local Agent 且 engine 为 cli 的另一种接法。由运行环境直接连接,这些调用不经过 Paperclip 连接器的工具权限或审核队列。同一 Agent 选择一种接法即可。

  1. 确认执行工作目录

    确认 Agent 实际使用的 adapter、engine 和 cwd。本方案针对 CLI 引擎下的旧版 claude_local 适配器;新版 Paperclip Runner 需按其文档配置。在 Agent 实际执行的主机或沙箱中进入该 cwd。

  2. 合并项目 MCP 配置

    在该工作目录的 .mcp.json 中加入 adscrawl 配置,并保留已有服务。环境变量引用由 Claude Code 展开,此文件无需填写实际密钥。

    JSON
    {
      "mcpServers": {
        "adscrawl": {
          "type": "http",
          "url": "https://api.adscrawl.net/mcp",
          "headers": {
            "x-api-key": "${ADSCRAWL_API_KEY}"
          }
        }
      }
    }
  3. 配置执行环境

    通过 Paperclip 密钥引用,在 Agent 的适配器 env 中设置 ADSCRAWL_API_KEY。仅在个人终端设置变量,不一定能传入服务进程或沙箱。共享该项目配置的其他 Agent 也能发现此服务。

  4. 在同一环境验证

    在相同 cwd 和环境中运行 claude mcp list,确认 AdsCrawl 连接成功。无人值守运行前,完成 Claude Code 要求的项目 MCP 信任配置,再分配下方首个任务并确认浏览器会话关闭。

    Shell
    claude mcp list

试一次

完成接入后,将这段指令发给 Agent,确认功能可用。

Prompt
使用 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 链接,适用于图片可以分享的流程;首个网页读取任务无需使用它。
查看价格与积分换算

继续阅读

Paperclip 自定义 MCP 服务Paperclip 连接器权限Paperclip Agent MCP 配置Paperclip Claude Code 适配器AdsCrawl MCP 文档