Gemini CLI

Integración con Gemini CLI

Dé a Gemini CLI acceso web en vivo con CrawlForge MCP. Un solo comando gemini mcp add registra el servidor en ~/.gemini/settings.json, o agregue el bloque mcpServers usted mismo.

Requisitos previos

Gemini CLI

Instálelo desde geminicli.com

Requerido

Node.js 18+

Instálelo desde nodejs.org

Requerido

API Key

Obténgala desde el panel

Free

Obtener una API key de CrawlForge

La configuración de abajo inicia el servidor mediante npx, así que no hace falta ninguna instalación global: solo una clave.

Inicie sesión desde la terminal: el CLI abre una página del navegador donde usted aprueba una clave nueva y luego la guarda en ~/.crawlforge/config.json.

Bash

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

O copie una clave desde el panel y péguela en la configuración del siguiente paso.

Consejo: La guía del CLI explica crawlforge login y las demás formas de autenticarse.

Registrar el servidor en Gemini CLI

Elija su método de configuración preferido:

AOpción A: un comando, ámbito de usuario

Ejecútelo una vez y CrawlForge estará disponible en todos los proyectos:

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 escribe en ~/.gemini/settings.json; -s project escribe en .gemini/settings.json del repositorio actual.

BOpción B: editar settings.json

Agregue un bloque mcpServers a ~/.gemini/settings.json (o a .gemini/settings.json en un proyecto):

~/.gemini/settings.jsonJson

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

Consejo: Un .gemini/settings.json de proyecto puede incluirse en el repositorio para que todo el equipo tenga el servidor; si lo hace, deje la clave fuera y que cada desarrollador agregue la suya.

Configurar su API key

Sustituya cf_live_your_api_key_here por su clave, o deje que el configurador la rellene.

Genere esta configuración con su clave: El configurador MCP rellena su clave y genera el comando y el JSON exactos para Gemini CLI.

Limitar la lista de herramientas (opcional)

CrawlForge incluye 31 herramientas. Defina CRAWLFORGE_TOOL_GROUPS en el mismo bloque env para cargar solo los grupos que necesite, por ejemplo basic,search:

Json

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

Grupos: basic, search, crawl, extract, batch, research, tracking, llmstxt, stealth, templates, scrape, agent.

Seguridad: Nunca incluya su API key en el control de versiones. Use variables de entorno o el archivo de configuración.

Probar la integración

Inicie una nueva sesión de Gemini CLI y confirme que el servidor está conectado.

Bash

gemini mcp list

Compruebe el estado — gemini mcp list muestra los servidores configurados; /mcp dentro de una sesión los lista con sus herramientas
Reinicie si hace falta — inicie una sesión nueva de gemini después de editar la configuración
Pruebe un prompt — pruebe uno de los ejemplos a continuación; Gemini elige la herramienta de CrawlForge por sí mismo

Ejemplos de prompts

"Busca las últimas noticias sobre IA"

"Extrae todos los enlaces de example.com"

"Rastrea el sitio de documentación y resúmelo"

"Extrae los precios de productos de este sitio de comercio electrónico"

Consulte la referencia de la API completa para ver las 31 herramientas y sus parámetros.

Solución de problemas

¿El servidor no aparece en `/mcp`?

Compruebe que ~/.gemini/settings.json sea JSON válido
Asegúrese de que Node.js 18+ esté instalado: node --version
Ejecute gemini mcp list para ver en qué ámbito se escribió el servidor
Inicie una nueva sesión de Gemini CLI

¿Errores de autenticación?

Compruebe que la API key empiece con cf_live_
Ejecute crawlforge login para guardar una clave nueva
Genere una nueva API key desde el panel

¿No se llama a las herramientas?

Ejecute /mcp y confirme que las herramientas de crawlforge aparecen en la lista
Pida un resultado concreto ("scrapea esta página") para que el modelo elija una herramienta
Recorte la lista de herramientas con CRAWLFORGE_TOOL_GROUPS si el modelo tiene demasiadas entre las que elegir

¿Sigue teniendo problemas? Contacte con simon@crawlforge.dev indicando su versión de Gemini CLI, su versión de Node.js y la salida de gemini mcp list.

¿Integración completada con éxito?

Explore todas las herramientas disponibles y mantenga bajo control su gasto de credits.

Ver todas las herramientas Guía de optimización de credits

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