Claude Desktop
Claude Desktop 集成
借助 CrawlForge MCP 在 Claude Desktop 中启用网页抓取。通过简单的 JSON 配置文件，5 分钟内即可完成配置。
前置条件
1
安装 CrawlForge MCP Server
使用 npm 全局安装 CrawlForge MCP server 软件包。
Bash
npm install -g crawlforge-mcp-server依赖项（包括 crawlforge-extractors）会自动安装。
验证安装： 运行
crawlforge --version 以确认安装。全局安装会添加两个服务器启动器——crawlforge-mcp 和 crawlforge-mcp-server——以及 crawlforge CLI。2
获取你的 API 密钥
注册一个免费账户并生成你的 API 密钥。
- 创建免费账户 — 获取 1,000 个免费 credits——无需信用卡。免费注册
- 进入 API Keys — 前往 Dashboard → API Keys
- 生成新密钥 — 点击 "Create API Key" 并复制密钥（以
cf_开头）
安全： 切勿分享你的 API 密钥或将其提交到版本控制。请安全地保管它。
3
配置 Claude Desktop
将 CrawlForge MCP 添加到 Claude Desktop 的配置文件中。
macOS
打开位于以下位置的配置文件：
Bash
~/Library/Application Support/Claude/claude_desktop_config.json添加以下配置：
Json
{
"mcpServers": {
"crawlforge": {
"command": "npx",
"args": ["-y", "crawlforge-mcp-server"]
}
}
}Windows
打开位于以下位置的配置文件：
Bash
%APPDATA%\Claude\claude_desktop_config.json添加以下配置：
Json
{
"mcpServers": {
"crawlforge": {
"command": "npx.cmd",
"args": ["-y", "crawlforge-mcp-server"]
}
}
}Linux
打开位于以下位置的配置文件：
Bash
~/.config/Claude/claude_desktop_config.json添加以下配置：
Json
{
"mcpServers": {
"crawlforge": {
"command": "npx",
"args": ["-y", "crawlforge-mcp-server"]
}
}
}API 密钥在哪里？ 此配置没有内联密钥——服务器会读取
npx crawlforge-setup 存储在 ~/.crawlforge/config.json 中的凭据。如果你进行了全局安装，也可以使用 "command": "crawlforge-mcp"（不带 args）来代替 npx——它会在你的 PATH 上解析，并能在 Node/nvm 版本切换后继续可用。4
重启并测试
重启 Claude Desktop 并测试集成。
- 重启 Claude Desktop — 完全退出并重新启动应用
- 打开新会话 — 开启一个新的聊天以加载 MCP server
- 用简单提示测试 — 试试："使用 CrawlForge 抓取 https://example.com"
示例提示
"从 https://example.com 抓取内容"
"从 https://example.com 提取所有链接"
"获取 https://example.com 的元数据"
可用工具
配置完成后，Claude 将可以访问全部 29 个 CrawlForge MCP 工具：
| 工具 | 说明 | Credits |
|---|---|---|
| fetch_url | 从 URL 抓取 HTML | 1 credit |
| extract_text | 提取干净文本 | 1 credit |
| extract_links | 提取所有链接 | 1 credit |
| extract_metadata | 获取页面元数据 | 1 credit |
| scrape_structured | CSS 选择器提取 | 2 credits |
| batch_scrape | 并行批量抓取 | 1/URL |
| deep_research | AI 驱动的研究 | 10 credits |
| search_web | Google 搜索集成 | 5 credits |
全部 29 个工具及其参数请参阅完整的 API 参考。
故障排查
工具未显示出来？
- 确认配置文件路径对于你的操作系统是正确的
- 检查 JSON 语法是否有效（使用 JSON 校验器）
- 确认已安装 Node.js 18+：
node --version - 完全重启 Claude Desktop（不只是关闭窗口）
身份验证错误？
- 确认 API 密钥以
cf_开头 - 检查 API 密钥前后是否有空格或引号
- 从控制台生成新的 API 密钥
- 确认密钥未被删除或过期
速率限制问题？
仍有问题？ 请联系 support@crawlforge.dev，并附上你的错误消息和配置文件（发送前请移除 API 密钥）。