Servidor MCP Kagi Session2API

Un servidor MCP (Model Context Protocol) gratuito para Kagi Search: accede a la búsqueda y al resumidor de Kagi mediante tokens de sesión, sin necesidad de clave API. Funciona con Claude Desktop, Cursor, Windsurf, Cline, Hermes y cualquier asistente/agente de codificación de IA compatible con MCP.

Inglés | Documentación en chino

⚠️ Advertencia para el usuario final: Este proyecto utiliza tokens de sesión de Kagi para acceder a las funciones de búsqueda y resumen sin la API oficial de pago. Esto puede violar los Términos de servicio de Kagi. Las posibles consecuencias incluyen la suspensión de la cuenta o la prohibición permanente. Úselo bajo su propio riesgo. Los autores no asumen ninguna responsabilidad por las acciones tomadas por Kagi contra su cuenta.

⚠️ Advertencia de seguridad: Su token de sesión de Kagi proporciona acceso completo a la cuenta. Trátelo como una contraseña. Nunca lo comparta ni lo incluya en el control de versiones.

Características

• Acceso basado en sesión: Utiliza tokens de sesión de Kagi en lugar de la API oficial ($25/1000 consultas), totalmente gratuito.

• Grupo de tokens múltiples: Configure varios tokens para un mayor rendimiento con rotación round-robin.

• Limitación de tasa por token: 5 req/s por token con algoritmo de token bucket.

• Salida compatible con API: Devuelve resultados en el mismo formato que el kagimcp oficial.

• Dos herramientas: kagi_search_fetch (búsqueda web) y kagi_summarizer (resumen de URL).

• Suplantación de UA de Firefox: Imita un navegador Firefox real para el acceso basado en sesión.

• Desactivación automática de tokens caducados: Los tokens caducados se detectan y omiten automáticamente.

• Operadores de búsqueda: Admite operadores de Kagi (site:, lang:, filetype:, etc.).

Plataformas compatibles

Funciona con cualquier cliente compatible con MCP:

• Claude Desktop

• Cursor

• Windsurf

• Cline

• Hermes Agent

• Cualquier cliente MCP que admita transporte stdio o HTTP

Instalación rápida (para agentes de IA)

Simplemente pegue este prompt en su agente de IA:

Install the Kagi Session2API MCP server from https://pypi.org/project/kagi-session2api-mcp/.
Then add it to my MCP:
`uvx kagi-session2api-mcp`
set env KAGI_SESSION_TOKEN to my token (ask me if you don't have it).
If I have multiple tokens, use KAGI_SESSION_TOKENS (comma-separated) instead,
or create a config file at ~/.config/kagi-session2api-mcp/config.toml with:
[kagi]
session_tokens = ["TOKEN_1", "TOKEN_2"]
summarizer_engine = "cecil"
[client]
timeout = 30
max_retries = 2
and set env KAGI_SESSION_CONFIG to that path.

Instalación manual

pip install kagi-session2api-mcp

O con uvx:

uvx kagi-session2api-mcp

Configuración

Opción 1: Variable de entorno (token único)

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_TOKEN": "YOUR_SESSION_TOKEN_HERE"
      }
    }
  }
}

Opción 2: Variable de entorno (múltiples tokens)

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_TOKENS": "TOKEN_1,TOKEN_2,TOKEN_3"
      }
    }
  }
}

Opción 3: Archivo de configuración (recomendado para múltiples tokens)

Cree ~/.config/kagi-session2api-mcp/config.toml:

[kagi]
session_tokens = [
    "YOUR_TOKEN_1_HERE",
    "YOUR_TOKEN_2_HERE",
]

summarizer_engine = "cecil"

[client]
timeout = 30
max_retries = 2

Luego configure:

{
  "mcpServers": {
    "kagi-session": {
      "command": "uvx",
      "args": ["kagi-session2api-mcp"],
      "env": {
        "KAGI_SESSION_CONFIG": "/path/to/config.toml"
      }
    }
  }
}

Obtención de su token de sesión

1. Inicie sesión en kagi.com

2. Vaya a Settings → Account → Session Link

3. Copie el token de la URL de sesión: https://kagi.com/search?token={ESTA_PARTE}&q=test

4. Utilice este token en su configuración

Uso

Herramientas MCP

kagi_search_fetch

Busque en la web usando Kagi:

Search for "Python async tutorial"

Admite operadores de búsqueda de Kagi:

• site:github.com - Restringir al dominio

• -site:reddit.com - Excluir dominio

• filetype:pdf - Filtro de tipo de archivo

• intitle:python - Filtro de título

• lang:zh - Filtro de idioma

• before:2024-01-01 / after:2024-01-01 - Filtros de fecha

• "frase exacta" - Coincidencia exacta

kagi_summarizer

Resuma cualquier URL:

Summarize https://example.com/article

Opciones:

• summary_type: "summary" (prosa) o "takeaway" (puntos clave)

• engine: "cecil" (predeterminado), "agnes", "daphne", "muriel"

• target_language: Código de idioma (p. ej., "ES")

⚠️ El resumidor es experimental: utiliza el endpoint interno de Kagi que puede cambiar.

Modos de transporte

Stdio (predeterminado, para Claude Desktop):

kagi-session2api-mcp

HTTP (para acceso remoto):

kagi-session2api-mcp --http --host 0.0.0.0 --port 8000

Arquitectura

MCP Client → FastMCP Server → TokenPool (round-robin) → httpx.AsyncClient → kagi.com
                                ↓
                          TokenBucket (5 req/s per token)
                                ↓
                          Auto-disable expired tokens

Comportamiento del grupo de tokens

Cuando un token caduca (detectado mediante 401/403 o redirección al inicio de sesión), se desactiva automáticamente. Los tokens restantes continúan atendiendo solicitudes.

Diferencias con el kagimcp oficial

Riesgos

• Kagi puede cambiar su estructura HTML, rompiendo el analizador.

• El acceso basado en sesión puede violar los Términos de servicio de Kagi.

• Es posible la suspensión de la cuenta o la prohibición permanente.

• El endpoint del resumidor es interno y puede cambiar sin previo aviso.

• Úselo bajo su propio riesgo. Los autores no asumen ninguna responsabilidad por las consecuencias, incluidas, entre otras, las acciones tomadas por Kagi contra su cuenta.

Licencia

MIT