如何在 Cline（VS Code）中使用 CrawlForge

Cline 是一款面向 VS Code 的开源 AI 编程助手，支持 Model Context Protocol。它把 VS Code 变成一个智能体式的开发环境，AI 可以读取文件、执行命令，并且 —— 借助 CrawlForge MCP —— 抓取网页。与闭源替代品不同，Cline 让你自行选择 LLM 提供商（Anthropic、OpenAI、Google，或通过 Ollama 使用本地模型），并让你完全掌控 AI 能访问的内容。

本教程将向你展示如何把 CrawlForge 连接到 Cline，并在 VS Code 工作流中直接使用 26 个网页抓取工具。

目录

• 前置条件
• Cline 如何使用 MCP server
• 第 1 步：安装 CrawlForge MCP server
• 第 2 步：将 CrawlForge 添加到 Cline 的 MCP 配置
• 第 3 步：测试集成
• 真实开发工作流
• credits 成本明细
• 高效使用 credits 的技巧
• 故障排查
• 后续步骤

前置条件

• VS Code，并已安装 Cline 扩展
• Node.js 18+
• 一个 LLM API key（Anthropic、OpenAI 或其他受支持的提供商）
• 一个 CrawlForge API key —— 免费注册即可获得 1,000 credits

Cline 如何使用 MCP server

Cline 通过一个 JSON 配置文件来发现 MCP server。配置完成后，AI 就能看到所有可用工具，并在对话中调用它们。Cline 的 MCP 实现有几大关键优势：

• 审批流程：在执行之前，Cline 会准确地向你展示它想调用哪个工具、使用什么参数。每个操作都由你批准或拒绝。
• 多提供商支持：可以在任意 LLM 上使用 CrawlForge 工具，而不只是 Claude。
• 开源：你可以精确地检查工具调用是如何发出的。

第 1 步：安装 CrawlForge MCP server

npm install -g crawlforge-mcp-server

验证是否安装正确：

crawlforge-mcp-server --version

第 2 步：将 CrawlForge 添加到 Cline 的 MCP 配置

打开 VS Code 并进入 Cline 的 MCP 设置：

1. 打开命令面板（Cmd+Shift+P / Ctrl+Shift+P）
2. 输入 "Cline: Open MCP Settings"
3. 这会打开 cline_mcp_settings.json 文件

将 CrawlForge 添加到服务器列表：

// cline_mcp_settings.json
{
  "mcpServers": {
    "crawlforge": {
      "command": "crawlforge-mcp-server",
      "args": [],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      },
      "disabled": false
    }
  }
}

将 API key 替换为你从 CrawlForge dashboard 获取的真实密钥。

安全提示

Cline 将 MCP 配置本地存储在你的 VS Code 设置目录中。你的 API key 不会被提交到版本控制。对于共享的团队配置，请使用环境变量引用：

{
  "mcpServers": {
    "crawlforge": {
      "command": "crawlforge-mcp-server",
      "args": [],
      "env": {
        "CRAWLFORGE_API_KEY": "${env:CRAWLFORGE_API_KEY}"
      }
    }
  }
}

然后在你的 shell 配置文件（~/.zshrc 或 ~/.bashrc）中设置环境变量：

export CRAWLFORGE_API_KEY="cf_live_your_api_key_here"

第 3 步：测试集成

在 VS Code 中打开 Cline 面板（点击侧边栏的 Cline 图标），并发送这条消息：

Cline 将会：

1. 向你展示拟调用的工具（带 URL 的 extract_content）
2. 等待你的批准
3. 执行工具并显示结果
4. 基于提取的内容生成摘要

如果这一步成功，说明你已连接成功。全部 20 个 CrawlForge 工具现已可用。

真实开发工作流

获取库文档

当你遇到不熟悉的 API 时，让 Cline 帮你查阅：

Cline 使用 CrawlForge 的 search_web（5 credits）找到正确的文档页面，然后用 extract_content（2 credits）读取它，并生成一个贴合你项目的代码示例。合计：7 credits。

抓取并为外部数据生成类型

CrawlForge 的 fetch_url（1 credit）取回 JSON，Cline 生成接口：

// Generated by Cline using CrawlForge data
interface Post {
  userId: number;
  id: number;
  title: string;
  body: string;
}

从 Stack Overflow 排查 Bug

Cline 用 search_web（5 credits）搜索，用 extract_content（2 credits）读取 Stack Overflow 排名最高的答案，并将修复直接应用到你的文件。合计：7 credits。

在实现前先做调研

Cline 串联 search_web 与多次 extract_content 调用，然后总结其共识。合计：约 11 credits。

credits 成本明细

Free 套餐一次性赠送 1,000 credits —— 足够进行约 140 次单页获取或约 90 次搜索并读取的工作流。

高效使用 credits 的技巧

1. 提示要具体。"Fetch the Stripe subscription docs" 会触发一次 extract_content 调用（2 credits）。"Research Stripe subscriptions" 则可能触发 search_web + 多次提取（11+ credits）。

2. 有 URL 时直接提供。"Read https://docs.stripe.com/billing/subscriptions" 花费 2 credits。"Find the Stripe subscription docs" 花费 7 credits（搜索 + 提取）。

3. **JSON API 用 fetch_url。**仅需 1 credit，是结构化数据最便宜的选择。

4. **批量进行调研。**让 Cline 在一次对话中调研多个主题，而不是不断开启新对话。

故障排查

Cline 不显示 CrawlForge 工具：编辑 MCP 设置后重启 VS Code。如果工具仍未出现，检查 cline_mcp_settings.json 中是否存在 JSON 语法错误。

"Server disconnected" 错误：确保 crawlforge-mcp-server 在你的 PATH 中。在终端运行 which crawlforge-mcp-server。如果没有任何返回，请再次运行 npm install -g crawlforge-mcp-server。

工具调用返回 401 失败：你的 API key 无效或已过期。在 crawlforge.dev/dashboard 生成一个新密钥。

工具响应缓慢：基于浏览器的工具（scrape_with_actions、stealth_mode）需要 3-8 秒。静态工具（fetch_url、extract_text）在 1 秒内响应。

后续步骤

将 CrawlForge 连接到 Cline 后，你就拥有了一个具备网络能力的编程助手。继续探索：

• CrawlForge 快速入门，了解详细的配置选项
• 全部 26 个工具详解，附使用示例
• 隐身模式，应对位于 Cloudflare 或 CAPTCHA 之后的站点
• 深度调研自动化，进行多来源分析

把 VS Code 变成网页抓取利器。免费开始，赠送 1,000 credits —— 无需信用卡。