Cursor IDE
Cursor IDE 集成
借助 CrawlForge MCP 在 Cursor IDE 中启用 AI 驱动的网页抓取。配置向导会自动配置 Cursor，你也可以自行将服务器添加到 ~/.cursor/mcp.json。
前置条件
1
安装 CrawlForge MCP Server
首先，全局安装 CrawlForge MCP server 软件包。
Bash
npm install -g crawlforge-mcp-server依赖项（包括 crawlforge-extractors）会自动安装。
快速配置： 运行
npx crawlforge-setup 即可自动配置你的 API 密钥。2
配置 Cursor IDE
选择你偏好的配置方式：
A方式 A：使用向导自动配置
配置向导会检测 Cursor 并为你写入 ~/.cursor/mcp.json
运行向导——如果已安装 Cursor，它会自动添加 CrawlForge 服务器：
Bash
npx crawlforge-setup之后重启 Cursor 以加载服务器。
B方式 B：编辑 ~/.cursor/mcp.json
自行将服务器添加到 Cursor 的 MCP 配置文件
创建或编辑 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：
Json
{
"mcpServers": {
"crawlforge": {
"type": "stdio",
"command": "crawlforge-mcp"
}
}
}crawlforge-mcp 需要第 1 步中的全局安装。若未进行全局安装，请改用 "command": "npx" 和 "args": ["-y", "crawlforge-mcp-server"]。
提示： 编辑
~/.cursor/mcp.json 会对每个项目生效，而项目级的 .cursor/mcp.json 会将服务器限定在该仓库内。3
设置你的 API 密钥
使用以下方式之一配置你的 API 密钥：
配置向导
运行配置向导以配置你的 API 密钥：
Bash
npx crawlforge-setup手动配置
或者手动设置环境变量：
Bash
export CRAWLFORGE_API_KEY="cf_live_your_api_key_here"将其添加到你的 shell 配置文件中（~/.bashrc、~/.zshrc 等）
安全： 切勿将你的 API 密钥提交到版本控制。请使用环境变量或配置文件。
4
测试集成
重启 Cursor IDE 并测试 CrawlForge MCP 集成。
- 重启 Cursor IDE — 关闭并重新打开 Cursor 以加载 MCP 配置
- 打开 AI 聊天 — 按
Cmd/Ctrl + L打开 AI 聊天 - 测试命令 — 试试下面的某个示例提示
示例提示
"搜索最新的 AI 资讯"
"从 example.com 提取所有链接"
"爬取文档站点并对其进行总结"
"从这个电商站点提取产品价格"
可用工具
配置完成后，Cursor 将可以访问全部 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 | 网络搜索集成 | 5 credits |
全部 29 个工具及其参数请参阅完整的 API 参考。
故障排查
MCP Server 无法加载？
- 检查
~/.cursor/mcp.json是否为有效 JSON - 确认已安装 Node.js 18+：
node --version - 确认已安装 CLI：
crawlforge --version - 完全重启 Cursor IDE
身份验证错误？
- 运行
npx crawlforge-setup重新配置 - 检查 API 密钥是否以
cf_开头 - 确认环境变量已在你的 shell 中设置
- 从控制台生成新的 API 密钥
工具未出现在聊天中？
- 检查 Cursor 的 MCP 插件是否已在设置中启用
- 尝试使用全局设置而非 .cursorrules
- 清除 Cursor 的缓存并重启
- 查看 Cursor 控制台中的错误消息
仍有问题？ 请联系 support@crawlforge.dev，并附上你的 Cursor 版本、Node.js 版本和错误消息。
集成成功了吗？
探索所有可用工具，开始使用 AI 驱动的网页抓取进行构建。