ZennoBrowser MCP Server

Servidor MCP de ZennoBrowser — Automatización de navegador antidetect para agentes de IA

Servidor MCP (Protocolo de Contexto de Modelo) para la API pública de ZennoBrowser. Expone capacidades de automatización de navegador y gestión de perfiles a agentes de IA como Claude Desktop, Cursor y clientes MCP de VS Code.

Por qué elegir el Servidor MCP de ZennoBrowser

• Cobertura completa de la API pública. 57 herramientas para espacios de trabajo, perfiles, carpetas, proxies, hilos, instancias de navegador, ajustes preestablecidos, extensiones e información del producto.
• Diseñado para escalar. Las herramientas masivas crean, actualizan, inician y detienen muchos perfiles, proxies, hilos e instancias de navegador en una sola llamada.
• Cookies y huellas digitales. Importa, exporta y copia cookies entre perfiles, y lee los detalles completos de la huella digital de cualquier perfil.
• Funciona con tu cliente de IA. Se ejecuta como un servidor stdio local en Claude Desktop, Cursor y VS Code.
• Gratis para empezar. ZennoBrowser está disponible para Windows. Su plan START incluye perfiles locales ilimitados y 2 navegadores simultáneos.

Inicio rápido

1. Inicia ZennoBrowser en tu computadora y obtén un token de API en tu cuenta personal en ZennoLab.
2. Añade el servidor a tu cliente MCP usando una de las configuraciones en Instalación.
3. Pide a tu agente, por ejemplo: "Crea un nuevo perfil llamado 'Perfil de prueba', luego inicia una instancia de navegador para él."

Herramientas como delete_profile, bulk_delete_profile y delete_proxy no se pueden deshacer. Revisa las acciones del agente antes de aprobar llamadas destructivas.

Requisitos

• Node.js 20+
• ZennoBrowser ejecutándose localmente
• Un token de API de ZennoBrowser válido

Instalación

El paquete se publica como @zennolab/zennobrowser-mcp-server. Las versiones hasta 1.0.0 se publicaron como zennobrowser-mcp-server sin ámbito, que ya no recibe actualizaciones — reemplázalo con @zennolab/zennobrowser-mcp-server en la configuración de tu cliente MCP.

npx (sin instalación requerida)

Claude Desktop — edita claude_desktop_config.json:

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor — añade a la configuración de MCP (.cursor/mcp.json o Configuración → MCP):

{
  "mcpServers": {
    "zennobrowser": {
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

VS Code (con soporte MCP de GitHub Copilot) — añade a .vscode/mcp.json:

{
  "servers": {
    "zennobrowser": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@zennolab/zennobrowser-mcp-server@latest"],
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Instalación global

npm install -g @zennolab/zennobrowser-mcp-server@latest

Luego usa zennobrowser-mcp-server como comando en lugar de npx ... @zennolab/zennobrowser-mcp-server:

{
  "mcpServers": {
    "zennobrowser": {
      "command": "zennobrowser-mcp-server",
      "env": {
        "ZB_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Variables de entorno

Variable	Requerida	Predeterminada	Descripción
ZB_API_TOKEN	Sí	—	Token de autenticación para la API pública de ZennoBrowser
ZB_API_BASE_URL	No	http://localhost:8160	URL base de la API pública de ZennoBrowser

Herramientas

Espacios de trabajo

Herramienta	Descripción
get_workspaces	Lista los espacios de trabajo accesibles

Perfiles

Herramienta	Descripción
get_profiles	Lista perfiles con filtrado y ordenación
get_profile	Obtiene un solo perfil con detalles completos de huella digital
create_profile	Crea un nuevo perfil
bulk_create_profile	Crea múltiples perfiles a la vez
update_profile	Actualiza la configuración del perfil
delete_profile	Elimina un perfil
bulk_delete_profile	Elimina múltiples perfiles
move_profile	Mueve perfiles a una carpeta
recover_profile	Recupera un perfil de un estado inválido
force_unlock_profile	Fuerza el desbloqueo de un perfil bloqueado en la nube
import_cookies	Importa cookies (formato JSON o Netscape)
export_cookies	Exporta cookies como JSON
copy_cookies	Copia cookies de un perfil a otro
bulk_update_profile_preset	Asigna un ajuste preestablecido a múltiples perfiles
bulk_update_profile_proxy	Actualiza el proxy de múltiples perfiles
bulk_update_profile_tags	Actualiza etiquetas de múltiples perfiles
cleanup_profile	Limpia la caché del perfil

Carpetas de perfiles

Herramienta	Descripción
get_profile_folders	Lista carpetas de perfiles
create_profile_folder	Crea una carpeta de perfiles
update_profile_folder	Renombra una carpeta de perfiles
delete_profile_folder	Elimina una carpeta de perfiles

Proxies

Herramienta	Descripción
get_proxies	Lista proxies
create_proxy	Crea un proxy
bulk_create_proxy	Crea múltiples proxies
update_proxy	Actualiza un proxy
delete_proxy	Elimina un proxy
bulk_delete_proxy	Elimina múltiples proxies
change_mobile_proxy_ip	Activa la rotación de IP para un proxy móvil

Carpetas de proxies

Herramienta	Descripción
get_proxy_folders	Lista carpetas de proxies
create_proxy_folder	Crea una carpeta de proxies
update_proxy_folder	Renombra una carpeta de proxies
delete_proxy_folder	Elimina una carpeta de proxies

Hilos

Herramienta	Descripción
get_threads	Lista hilos
create_thread	Crea un hilo
bulk_create_thread	Crea múltiples hilos
continue_use_thread	Extiende la vida útil del hilo
bulk_continue_use_thread	Extiende la vida útil de múltiples hilos
stop_thread	Detiene un hilo
bulk_stop_thread	Detiene múltiples hilos

Instancias de navegador

Herramienta	Descripción
get_browser_instances	Lista instancias de navegador activas
start_browser_instance	Lanza una instancia de navegador para un perfil
bulk_start_browser_instance	Lanza instancias de navegador para múltiples perfiles
stop_browser_instance	Detiene una instancia de navegador
bulk_stop_browser_instance	Detiene múltiples instancias de navegador
set_browser_instance_visibility	Muestra u oculta una ventana del navegador

Ajustes preestablecidos y extensiones

Herramienta	Descripción
get_presets	Lista ajustes preestablecidos
create_preset	Crea un ajuste preestablecido
delete_preset	Elimina un ajuste preestablecido
get_extensions	Lista extensiones
create_extension_from_web	Añade una extensión desde Chrome Web Store
create_extension_from_file	Añade una extensión desde un archivo local .crx o .zip
delete_extension	Elimina una extensión

Producto

Herramienta	Descripción
get_product_version	Obtiene la versión de ZennoBrowser
get_browser_version	Obtiene la versión del motor del navegador
get_limits	Obtiene los límites de recursos del espacio de trabajo
get_tariff	Obtiene información de la tarifa actual

Ejemplos de prompts

Crea un perfil e inicia el navegador:

Crea un nuevo perfil llamado "Perfil de prueba", luego inicia una instancia de navegador para él.

Flujo completo de principio a fin:

Crea un perfil llamado "Scraper", crea un proxy con URI "socks5://user:pass@1.2.3.4:1080", asigna el proxy al perfil, crea un hilo y luego inicia una instancia de navegador para el perfil usando ese hilo.

Operaciones masivas:

Lista todos los perfiles en mi espacio de trabajo predeterminado y elimina cualquier perfil que no se haya usado en los últimos 30 días.

Gestión de cookies:

Exporta cookies del perfil "Sesión A" e impórtalas en el perfil "Sesión B".

Solución de problemas

Error: Missing required environment variable ZB_API_TOKEN Establece la variable de entorno ZB_API_TOKEN con tu token de API de ZennoBrowser.

Error: connect ECONNREFUSED 127.0.0.1:8160 ZennoBrowser no está ejecutándose o la API pública no funciona. Si la API se ejecuta en un puerto diferente, establece ZB_API_BASE_URL=http://localhost:<port>.

Tool calls return errors with "Unauthenticated" Tu token de API es inválido o ha expirado. Genera un nuevo token en tu cuenta personal en ZennoLab.

npx descarga el paquete cada vez Instala globalmente con npm install -g @zennolab/zennobrowser-mcp-server@latest para evitar volver a descargarlo en cada inicio.

Relacionados

• ZennoBrowser — el navegador antidetect que controla este servidor
• Documentación de ZennoLab — guías del producto (en ruso)
• Foro comunitario de ZennoBrowser — preguntas, informes de errores y solicitudes de funciones
• zennoposter-mcp — servidores MCP para ZennoPoster y ZennoDroid

Licencia

MIT