Gemini CLI

Gemini CLI 集成

借助 CrawlForge MCP 让 Gemini CLI 获得实时网页访问能力。一条 gemini mcp add 命令即可把服务器注册到 ~/.gemini/settings.json，你也可以自行添加 mcpServers 块。

前置条件

Gemini CLI

从 geminicli.com 安装

必需

Node.js 18+

从 nodejs.org 安装

必需

API 密钥

从控制台获取

免费

获取 CrawlForge API 密钥

下面的配置通过 npx 启动服务器，因此无需任何全局安装——只需要一个密钥。

在终端登录：CLI 会打开一个浏览器页面，你在其中批准一个新密钥，随后密钥会保存到 ~/.crawlforge/config.json。

Bash

npm install -g crawlforge-mcp-server
crawlforge login        # opens the browser approval page

或者从控制台复制一个密钥，在下一步粘贴到配置中。

提示： CLI 指南介绍了 crawlforge login 以及其他身份验证方式。

在 Gemini CLI 中注册服务器

选择你偏好的配置方式：

A方式 A：一条命令，用户作用域

运行一次，CrawlForge 即可在所有项目中使用：

Bash

gemini mcp add -s user -e CRAWLFORGE_API_KEY=cf_live_your_api_key_here crawlforge npx -- -y crawlforge-mcp-server@latest mcp

-s user 写入 ~/.gemini/settings.json；-s project 则写入当前仓库的 .gemini/settings.json。

B方式 B：编辑 settings.json

在 ~/.gemini/settings.json（或项目中的 .gemini/settings.json）添加一个 mcpServers 块：

~/.gemini/settings.jsonJson

{
  "mcpServers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

提示： 项目级 .gemini/settings.json 可以提交到仓库，让整个团队都拥有该服务器；如果这样做，请不要写入密钥，让每位开发者自行添加。

设置你的 API 密钥

将 cf_live_your_api_key_here 替换为你的密钥，或让配置生成器为你填入。

用你的密钥生成此配置： MCP 配置生成器会填入你的密钥，并输出适用于 Gemini CLI 的确切命令和 JSON。

限制工具列表（可选）

CrawlForge 提供 31 个工具。在同一个 env 块中设置 CRAWLFORGE_TOOL_GROUPS，即可只加载你需要的分组，例如 basic,search：

Json

"env": {
  "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here",
  "CRAWLFORGE_TOOL_GROUPS": "basic,search"
}

分组：basic、search、crawl、extract、batch、research、tracking、llmstxt、stealth、templates、scrape、agent。

安全： 切勿将你的 API 密钥提交到版本控制。请使用环境变量或配置文件。

测试集成

启动一个新的 Gemini CLI 会话，确认服务器已连接。

Bash

gemini mcp list

检查状态 — gemini mcp list 显示已配置的服务器；会话内的 /mcp 会列出它们及其工具
必要时重启 — 编辑设置后启动新的 gemini 会话
测试提示 — 试试下面的某个示例；Gemini 会自行选择 CrawlForge 工具

示例提示

"搜索最新的 AI 资讯"

"从 example.com 提取所有链接"

"爬取文档站点并对其进行总结"

"从这个电商站点提取产品价格"

全部 31 个工具及其参数请参阅完整的 API 参考。

故障排查

`/mcp` 中没有该服务器？

检查 ~/.gemini/settings.json 是否为有效 JSON
确认已安装 Node.js 18+：node --version
运行 gemini mcp list 查看服务器写入了哪个作用域
启动新的 Gemini CLI 会话

身份验证错误？

检查 API 密钥是否以 cf_live_ 开头
运行 crawlforge login 保存一个新密钥
从控制台生成新的 API 密钥

工具没有被调用？

运行 /mcp，确认 crawlforge 工具已列出
提出具体的目标（"抓取这个页面"），让模型选择工具
如果模型可选的工具太多，用 CRAWLFORGE_TOOL_GROUPS 精简工具列表

仍有问题？ 请联系 simon@crawlforge.dev，并附上你的 Gemini CLI 版本、Node.js 版本以及 gemini mcp list 的输出。

集成成功了吗？

探索所有可用工具，并控制好你的 credit 消耗。

查看全部工具 credit 优化指南

{ "mcpServers": { "crawlforge": { "command": "npx", "args": [ "-y", "crawlforge-mcp-server@latest", "mcp" ], "env": { "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here" } } } }