# Gemini CLI 中的 MCP 网页搜索与抓取 (/zh/quickstarts/gemini-cli)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 465 · updated: 2026-07-30 -->
Related: [Node.js](/zh/quickstarts/nodejs.md), [Next.js](/zh/quickstarts/nextjs.md), [Express](/zh/quickstarts/express.md), [NestJS](/zh/quickstarts/nestjs.md), [Fastify](/zh/quickstarts/fastify.md), [Hono](/zh/quickstarts/hono.md)

通过 MCP 为 [Google Gemini CLI](https://github.com/google-gemini/gemini-cli) 添加 Firecrawl 的搜索、抓取、爬取和浏览器工具。

<div id="quick-setup">
  ## 快速开始 [#快速开始]
</div>

<div id="1-get-your-api-key">
  ### 1. 获取 API 密钥 [#1-获取-api-密钥]
</div>

前往 [firecrawl.dev/app](https://www.firecrawl.dev/app) 注册，并复制你的 API 密钥。

<div id="2-add-firecrawl-to-gemini-cli">
  ### 2. 将 Firecrawl 添加到 Gemini CLI [#2-将-firecrawl-添加到-gemini-cli]
</div>

Gemini CLI 会从 `~/.gemini/settings.json` (全局) 或项目中的 `.gemini/settings.json` 读取 MCP 配置。添加以下内容：

```json
{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-YOUR-API-KEY"
      }
    }
  }
}
```

将 `fc-YOUR-API-KEY` 替换为你的 Firecrawl API 密钥。

<div id="3-launch-gemini-cli">
  ### 3. 启动 Gemini CLI [#3-启动-gemini-cli]
</div>

```bash
gemini
```

确认服务器已启动：

```
/mcp list
```

你应该能看到 `firecrawl` 及其工具。

<div id="quick-demo">
  ## 快速演示 [#快速演示]
</div>

```
Use firecrawl to search the web for "Gemini 2.5 context window" and summarize the top 5 results.
```

```
Scrape https://ai.google.dev/gemini-api/docs and outline the sections.
```

```
Crawl https://example.com and extract the product names from /products.
```

<div id="remote-hosted-url-no-nodejs-required">
  ## 远程托管 URL (无需 Node.js) [#远程托管-url-无需-nodejs]
</div>

```json
{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}
```

此配置使用免密钥 Firecrawl 工具集。对于账户关联或无人值守的设置，请参阅[托管 MCP 连接模式](/zh/developer-guides/mcp-setup-guides/oauth)；API 密钥应保存在 Authorization 请求头或安全密钥存储中，切勿放入 URL。

<div id="troubleshooting">
  ## 故障排查 [#故障排查]
</div>

* **工具未显示** — 编辑 `settings.json` 后，请重启 Gemini CLI；MCP 服务器仅在启动时加载。
* **`spawn npx ENOENT`** — 请安装 Node.js 18+，或使用远程托管 URL。
* **触发速率限制** — 请前往 [firecrawl.dev/pricing](https://www.firecrawl.dev/pricing) 升级你的 Firecrawl 套餐。