Bittlebits

Reescribe tu página web para posicionarte #1 en LLMs

Ver en bittlebits.aiPrueba este MCPPatrocinado

Documentación

Usando Bittlebits con Agentes de IA a través del Protocolo de Contexto de Modelo (MCP)

Bittlebits tiene una integración con el Protocolo de Contexto de Modelo (MCP) que te permite llevar tus puntuaciones GEO y sugerencias de reescritura directamente a agentes de IA, ya sea que uses Claude Code en tu terminal, Cursor o VS Code en tu IDE, Codex, o una aplicación web de IA. En lugar de copiar y pegar contenido de un lado a otro, tu agente puede leer exactamente lo que Bittlebits recomienda y ayudarte a aplicar esos cambios, incluyendo escribirlos directamente en tu código.

Hay tres formas de conectarse, dependiendo de tu cliente y de cuánto quieras ejecutar localmente:

Servidor local (stdio) — el paquete npm @bittlebits.ai/mcp. Se ejecuta en tu máquina a través del transporte stdio. Ideal para agentes de IDE/CLI y cuando quieres una configuración guiada con un solo comando.
Endpoint remoto (HTTP) — https://bittlebits.ai/mcp. No hay nada que instalar; el servidor está alojado por nosotros e inicias sesión a través de tu navegador.
Plugin de Claude Code — un envoltorio instalable y ligero alrededor del endpoint remoto para clientes que consumen plugins MCP.

Los tres exponen las mismas herramientas:

Herramienta	Qué hace
get_score	Devuelve puntuaciones de métricas GEO (0–10 por dimensión) para una página
get_rewrite	Devuelve el contenido original de tu página y una versión reescrita con las sugerencias de Bittlebits aplicadas, más la lista de cambios individuales sugeridos
get_url_content	Devuelve el HTML y el markdown originales de una página tal como los obtuvo Bittlebits — útil para comparar la página actual con la versión reescrita

Cada herramienta acepta ya sea un url (URL completa de la página) o un url_id (el ID interno de Bittlebits, si ya tienes uno). Los resultados pueden tardar unos minutos en la primera ejecución mientras Bittlebits obtiene y procesa la página.

Lo que puedes hacer

Una vez conectado, puedes pedirle a tu agente cosas como:

"Muéstrame qué quiere cambiar Bittlebits en esta página y explica por qué."
"Reescribe el texto de mi página de inicio aplicando las sugerencias de Bittlebits."
"¿Qué métricas son las más débiles y qué debería arreglar primero?"
"Ayúdame a aplicar la sugerencia #3 sin cambiar el tono."
"Obtén la puntuación de mi página de aterrizaje y luego encuentra y actualiza el archivo en mi código."

1. Servidor local (stdio)

El paquete @bittlebits.ai/mcp ejecuta el servidor MCP de Bittlebits localmente a través del transporte stdio. Esta es la ruta recomendada para agentes de terminal e IDE: Claude Code, Cursor, VS Code y Codex.

Configuración guiada

Ejecuta el comando de configuración y sigue las indicaciones:

npx @bittlebits.ai/mcp setup

Esto te guía a través de todo:

Elige tus clientes — Claude Code, Cursor, VS Code, Codex (cualquier combinación). Los clientes instalados están preseleccionados.
Elige un alcance — escribe la configuración en el proyecto actual, o globalmente para todos los proyectos en tu máquina.
Inicia sesión — se abre una ventana del navegador; inicia sesión en Bittlebits y listo. Tu clave API se obtiene y se guarda en caché localmente en ~/.bittlebits/config.json.
Conectado — la entrada del servidor se escribe en la configuración de cada cliente. Reinicia el cliente y comienza a preguntar.

Sin copiar y pegar claves, sin editar JSON a mano. Volver a ejecutar setup es seguro: se fusiona con los archivos de configuración existentes, preservando tus otros servidores MCP y solo actualizando la entrada de Bittlebits.

¿Ya tienes una clave API? Omite el navegador: npx @bittlebits.ai/mcp setup --api-key bb_your_key

El comando setup también acepta banderas de cliente (--claude, --cursor, --vscode, --codex), --project / --global para el alcance, y -y / --yes para ejecuciones no interactivas.

Iniciar una sesión

¿Ya ejecutaste setup? Usa launch para abrir instantáneamente una sesión de IA con Bittlebits precargado — sin necesidad de configuración manual.

npx @bittlebits.ai/mcp launch

Esto detecta qué clientes de IA (Claude Code, Codex) están instalados en tu máquina y abre una sesión. Si se encuentran ambos, se te pedirá que elijas uno.

npx @bittlebits.ai/mcp launch [options]

  -c, --client <name>   Force a specific client: claude, codex
  -p, --prompt <text>   Send an initial prompt (non-interactive / scripted use)

Ejemplos:

# Interactive session with auto-detected client
npx @bittlebits.ai/mcp launch

# Force Claude Code
npx @bittlebits.ai/mcp launch --client claude

# One-shot score in your terminal
npx @bittlebits.ai/mcp launch --client claude --prompt "Get the GEO score for nike.com"

Configuración manual

¿Prefieres configurarlo tú mismo? Cualquier cliente que admita el transporte stdio funciona. Ejecuta npx -y @bittlebits.ai/mcp con BITTLEBITS_API_KEY configurado en el entorno — encuentra tu clave en Configuración → Claves API en bittlebits.ai.

Claude Code (CLI):

claude mcp add --transport stdio bittlebits -e BITTLEBITS_API_KEY=your_key -- npx -y @bittlebits.ai/mcp

Cursor / Claude Code (.cursor/mcp.json o .mcp.json):

{
  "mcpServers": {
    "bittlebits": {
      "command": "npx",
      "args": ["-y", "@bittlebits.ai/mcp"],
      "env": { "BITTLEBITS_API_KEY": "your_key_here" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "bittlebits": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@bittlebits.ai/mcp"],
      "env": { "BITTLEBITS_API_KEY": "your_key_here" }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.bittlebits]
command = "npx"
args = ["-y", "@bittlebits.ai/mcp"]

[mcp_servers.bittlebits.env]
BITTLEBITS_API_KEY = "your_key_here"

Requisitos previos

Node.js 18+
Una cuenta de Bittlebits

2. Endpoint remoto (`https://bittlebits.ai/mcp`)

El endpoint remoto está alojado por Bittlebits y habla el transporte Streamable HTTP con autenticación OAuth 2.0. No hay nada que instalar ni token que gestionar — la primera vez que tu cliente invoca una herramienta de Bittlebits, se abre una ventana del navegador para iniciar sesión en tu cuenta de Bittlebits.

Claude Code (CLI)

Ejecuta esto una vez en tu terminal:

claude mcp add --transport http bittlebits https://bittlebits.ai/mcp

La primera vez que invoques una herramienta de Bittlebits, Claude Code abrirá tu navegador para completar el inicio de sesión. Claude ahora puede obtener tus puntuaciones y reescrituras, y luego encontrar y editar los archivos correctos en tu código directamente.

Aplicación web de Claude.ai o Claude Desktop

Navega a Settings > Connectors y haz clic en Add custom connector.

Dale a la conexión MCP un nombre como "Bittlebits"
Para la URL del servidor MCP remoto, ingresa https://bittlebits.ai/mcp
Ignora la configuración avanzada y haz clic en Connect.
Completa el inicio de sesión para establecer una conexión entre Claude y tu cuenta de Bittlebits.

Visual Studio Code

Para disponibilidad en todos tus proyectos, crea un mcp.json en ~/.vscode/mcp.json (macOS) o %USERPROFILE%\.vscode\mcp.json (Windows). Para disponibilidad específica de un proyecto, crea el archivo mcp.json en el directorio .vscode de la raíz de tu proyecto.

{
  "servers": {
    "bittlebits": {
      "type": "http",
      "url": "https://bittlebits.ai/mcp"
    }
  }
}

Luego sigue la ventana emergente de OAuth para vincular el cliente MCP a tu cuenta de Bittlebits.

Otros clientes

Cualquier cliente compatible con MCP que admita transporte HTTP y OAuth 2.0 funcionará. Apúntalo a https://bittlebits.ai/mcp.

3. Plugin de Claude Code

El repositorio bittlebits-plugin es un envoltorio de plugin instalable alrededor del endpoint remoto descrito anteriormente. Contiene un .mcp.json raíz que apunta a https://bittlebits.ai/mcp, de modo que los directorios y clientes compatibles con MCP pueden detectar automáticamente el servidor sin configuración manual.

Debido a que envuelve el endpoint HTTP remoto, el plugin no requiere instalación local ni clave API — la autenticación ocurre a través de OAuth en el navegador en el primer uso, exactamente como el endpoint remoto.

El .mcp.json incluido es:

{
  "mcpServers": {
    "bittlebits": {
      "type": "http",
      "url": "https://bittlebits.ai/mcp"
    }
  }
}

Usa el plugin cuando tu cliente consuma plugins MCP o detecte automáticamente un .mcp.json de un proyecto. Si estás configurando un cliente manualmente, prefiere las instrucciones del endpoint remoto anteriores — son equivalentes.

Inicia una conversación

Con Bittlebits conectado por cualquiera de los métodos anteriores, abre un nuevo chat y prueba:

"Usa la herramienta de Bittlebits para obtener las sugerencias de reescritura para example.com, y luego ayúdame a aplicarlas en mi código."

Tu agente obtendrá el contenido original y reescrito de Bittlebits, analizará tu código y te guiará a través de los cambios en la página correspondiente.

Para contexto de puntuación:

"Obtén las puntuaciones para example.com y dime qué áreas necesitan más mejora."

Consejos

Sé específico sobre qué conservar. Si tu voz de marca importa, dile a tu agente: "Aplica las sugerencias pero mantén el tono casual y conversacional."
Trabaja sección por sección en páginas más largas — es más fácil de revisar de esa manera.
Vuelve a puntuar después de las ediciones. Una vez que hayas actualizado tu página, activa una nueva puntuación de Bittlebits para ver cuánto mejoraron las métricas.