Saltar al contenido
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

1
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.

2
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"
      }
    }
  }
}
3
Configurar su API key
Sustituya cf_live_your_api_key_here por su clave, o deje que el configurador la rellene.

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.

4
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`?

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

¿Errores de autenticación?

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

¿No se llama a las herramientas?

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

¿Integración completada con éxito?

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