Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Obscura MCP

de Metadramaversión 0.1.1i★ 2iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.Metadrama/obscura-mcp

Cómo instalar

What it does

MCP server adapter for Obscura Rust headless browser — web scraping with anti-detection.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Web y navegadores

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

de google-research★ 35.6381 skills

Skill · Guía de trabajo

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

de BigBodyCobain★ 11.6051 skills

Skill · Guía de trabajo

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

de gosom★ 82361 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad6/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad0/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso6/100

Calidad: Pasó 2/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Obscura MCP. Sigue https://mcp.popnx.com/i/metadrama-obscura-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 2/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Obscura MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "obscura": { "command": "npx", "args": [ "-y", "obscura-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Obscura MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "obscura": {
          "command": "npx",
          "args": [
            "-y",
            "obscura-mcp"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Obscura MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Obscura MCP o muestra una herramienta de Obscura MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Obscura MCP

Obscura MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Obscura MCP

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Web y navegadores que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Obscura MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user obscura -- npx -y obscura-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Obscura MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user obscura -- npx -y obscura-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver Obscura MCP en la lista como conectado

  5. Pruébalo

    Usa Obscura MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Obscura MCP o muestra una herramienta de Obscura MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Obscura MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "obscura": { "command": "npx", "args": [ "-y", "obscura-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Obscura MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Obscura MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Obscura MCP o muestra una herramienta de Obscura MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Obscura MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "obscura": { "type": "stdio", "command": "npx", "args": [ "-y", "obscura-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Obscura MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Obscura MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Obscura MCP o muestra una herramienta de Obscura MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Obscura MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user obscura -- npx -y obscura-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "obscura": {
      "command": "npx",
      "args": [
        "-y",
        "obscura-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "obscura": {
      "command": "npx",
      "args": [
        "-y",
        "obscura-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "obscura": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "obscura-mcp"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
83/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.1.1
Publicado en el registroi
2 may 2026
Último cambio de códigoi
17 may 2026
Creador
Metadrama
Paquetes
npm: obscura-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Metadrama, dueña del repo

  • ✕ No superada

    Sigue en mantenimiento

    Sin cambios de código en más de un año, o el repo está archivado

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para obscura-mcp@0.1.1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/metadrama-obscura-mcp.svg)](https://mcp.popnx.com/en/servers/metadrama-obscura-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Web y navegadoresi

  • Más estrellas que el 84% de los otros 1634 servidores de esta categoría
  • Publicado en el registro más recientemente que el 6% de los otros 1634 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 52% de los otros 1634 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Obscura MCP?

Superó 2 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 meses, y la última versión (0.1.1) llegó al registro hace 7 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Browser Use, changedetection.io (official), Apify MCP Server, Pomerado, Actionbook

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Browser Use

Browser agents and stealth cloud browsers for AI: run web tasks, fill forms, extract data.

de browser-useMuy usado↓ 1,7 M/sem★ 121,5 milActualizado hace 29 días

Computadora o nube✓ del servicio · browser-use.com

Apify MCP Server

Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡

de apifyMuy usado★ 17 milActualizado anteayer

Se ejecuta en la nube✓ del servicio · apify.com

Pomerado

Connect your agents to any website. The cheaper, faster and more reliable alternative to browser use

de PomeradoEn crecimiento★ 1,8 milActualizado ayer

Se ejecuta en la nube✓ del servicio · pomerado.ai

Actionbook

Let your AI agent operate any website through a real, logged-in browser session.

de actionbookEn crecimiento★ 1,6 milActualizado hace 31 días

Se ejecuta en la nube✓ del servicio · actionbook.app
Comparado con otros parecidos
Este
Obscura MCP
Browser Usechangedetection.io (official)Apify MCP ServerPomeradoActionbook
Dónde se ejecutaSe instala en tu equipoEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoSíNoSíNoNo
Se añade con + en ClaudeNoSíNoNoNoNo
Revisiones básicas2/35/53/34/44/44/4
LicenciaMITMITApache-2.0MITMITApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

obscura-mcp — ARCHIVED

⚠️ Archived. Upstream ships native MCP since v0.1.4 (obscura mcp). npm package deprecated.

An MCP server adapter for Obscura, a lightweight Rust headless browser for scraping and AI agent automation.

Exposes Obscura's native CDP capabilities through a clean MCP interface — no Chrome dependency, no heavyweight browser automation.

Installation

npm install -g obscura-mcp

The npm package itself is a small Node.js wrapper (~20 KB). The browser binary (~80 MB) is downloaded automatically on first use — no separate install step needed.

The binary is cached at ~/.obscura/bin/ and survives npm upgrades.

Pre-release builds are published under the dev tag:

npm install -g obscura-mcp@dev

To use a custom binary path:

export OBSCURA_PATH=/path/to/obscura

Quick Start

# Install

npm install -g obscura-mcp

Verify

obscura-mcp --version

Start MCP server (stdio — primary transport)

obscura-mcp --transport stdio

Or with HTTP transport

obscura-mcp --transport streamable-http

Most MCP clients (Claude Desktop, Cline, Continue) connect via stdio. The streamable-http transport is also supported for custom integrations.

Tools

Four tools cover browsing, interacting, session persistence, and bulk scraping.

browse_page — one-shot page reading

Get content from any page in a single call. Combine output format with optional JavaScript evaluation.

ParameterTypeDefaultDescription
urlstring—The URL to visit
format"text" \"markdown" \"html" \"links" \"cookies" \"axtree" \"layout""text"Output format
evalstring—JavaScript expression to evaluate (appended to output)
cookiesarray—Cookies to inject [{name, value, domain?, path?, ...}]
user_agentstring—Override the browser user-agent string
headersobject—Extra HTTP headers {key: value, ...}
stealthbooleantrueAccepted for compatibility; stealth is controlled by the Obscura server

Examples:

browse_page(url: "https://example.com")

browse_page(url: "https://example.com", format: "markdown") browse_page(url: "https://example.com", format: "axtree") browse_page(url: "https://example.com", format: "layout") browse_page(url: "https://example.com", user_agent: "TestBot/1.0")

formatWhat you get
"text"Plain text — stripped of HTML tags, scripts, styles
"markdown"Clean markdown — uses Obscura's native LP.getMarkdown CDP
"html"Raw HTML markup
"links"All href values — one per line
"cookies"Cookies with name, value, domain, path, expiry
"axtree"Accessibility tree — roles, names, values of all elements
"layout"Viewport metrics — dimensions, scroll offsets, device scale

When eval is provided, the JavaScript result is appended to the format output under a --- eval --- divider.


browse_interact — one-shot page actions

Click an element or type text into a page. For multi-step interactions (login → wait → extract), use browse_session instead.

ParameterTypeDefaultDescription
urlstring—The URL to visit
action"click" \"type"—Action to perform
selectorstring—CSS selector for the target element
textstring—Text to type (required when action is "type")
cookiesarray—Cookies to inject [{name, value, ...}]
stealthbooleantrueAccepted for compatibility; stealth is controlled by the Obscura server

Examples:

browse_interact(url: "https://example.com", action: "click", selector: "a")

browse_interact(url: "https://duckduckgo.com", action: "type", selector: "input[name=q]", text: "search query")

Both actions create a fresh page, perform the action, and close. The page context does not persist — for sequential interactions (type into a form, then click submit), use browse_session instead.


browse_session — multi-step persistent sessions

Create a persistent browser session, interact with it across multiple calls, then close. Sessions auto-close after 5 minutes of inactivity. Multiple sessions can run simultaneously.

ParameterTypeRequired forDescription
action"create" \"close" \"list" \"goto" \"wait" \"extract" \"click" \"type"AllWhat to do
session_idstringAll except create, listSession ID from create
urlstringcreate, gotoURL to navigate to
selectorstringwait, click, typeCSS selector
expressionstringwait (if no selector), extractJavaScript expression
textstringtypeText to type
timeoutnumberwait (optional)Max wait in ms (default 30000, max 120000)
user_agentstringcreate, gotoOverride user-agent string for navigation
headersobjectcreate, gotoExtra HTTP headers {key: value, ...}
clear_cookiesbooleancreateClear all browser cookies on session creation

Session lifecycle:

actionWhat it doesReturns
createOpens a new browser tab. Optionally clears cookies.Session ID
closeReleases the tab and all its resources. Idempotent.Confirmation
listShows all active sessions with timestamps.Session list
gotoNavigates to a new URL. Page stays alive.Confirmation
waitPolls until a CSS selector exists or a JS expression returns true.Confirmation
extractEvaluates JavaScript and returns the result.Eval result
clickClicks an element by CSS selector.Coordinates
typeTypes text into an input field.Confirmation

Login flow example:

browse_session(action: "create", url: "https://example.com/login")

→ "Created session: session_1"

browse_session(action: "type", session_id: "session_1", selector: "#username", text: "user") browse_session(action: "type", session_id: "session_1", selector: "#password", text: "pass") browse_session(action: "click", session_id: "session_1", selector: "#login-btn")

browse_session(action: "wait", session_id: "session_1", selector: ".dashboard", timeout: 10000) browse_session(action: "extract", session_id: "session_1", expression: "document.title")

browse_session(action: "close", session_id: "session_1")

Multi-article browsing example:

browse_session(action: "create")

browse_session(action: "goto", session_id: "session_1", url: "https://en.wikipedia.org/wiki/JavaScript") browse_session(action: "extract", session_id: "session_1", expression: "document.title") browse_session(action: "goto", session_id: "session_1", url: "https://en.wikipedia.org/wiki/Python") browse_session(action: "extract", session_id: "session_1", expression: "document.title") browse_session(action: "close", session_id: "session_1")


browse_scrape — parallel bulk scraping

Scrape multiple URLs simultaneously using isolated worker processes. Each URL gets its own headless browser worker — built on top of Obscura's native scrape command with obscura-worker.

ParameterTypeDefaultMaxDescription
urlsstring[]—1000URLs to scrape in parallel
evalstring——JavaScript expression to evaluate per page
concurrencynumber10100Number of parallel worker processes
timeoutnumber60300Per-worker timeout in seconds

Example:

browse_scrape(urls: ["https://news.ycombinator.com", "https://example.com"], eval: "document.title", concurrency: 25)

Output format (JSON):

{

"total_urls": 2, "concurrency": 25, "total_time_ms": 1250, "avg_time_ms": 625.0, "results": [ { "url": "https://news.ycombinator.com", "title": "Hacker News", "eval": "Hacker News", "time_ms": 612, "worker": 0 }, { "url": "https://example.com", "eval": "Example Domain", "time_ms": 638, "worker": 1 } ] }

On errors (timeout, network failure, etc.), the per-URL result includes an "error" field instead of "eval":

{

"url": "https://slow-site.com", "error": "timeout", "time_ms": 60000 }

This is the tool that directly leverages Obscura's core advantage over headless Chrome: lightweight parallel scraping with built-in stealth. The ~30 MB per-worker memory footprint means 100 concurrent workers use less memory than a single Chrome instance.

Configuration

Claude Desktop / Cline / Continue / Any MCP client
{

"mcpServers": { "obscura-mcp": { "command": "obscura-mcp", "args": ["--transport", "stdio"] } } }

VS Code (Cline extension)
{

"servers": { "obscura-mcp": { "command": "obscura-mcp", "args": ["--transport", "stdio"] } } }

After global npm install, obscura-mcp is on your PATH — no absolute paths needed.

Environment Variables
VariableDefaultDescription
OBSCURA_PATH—Path to custom Obscura binary
OBSCURA_STEALTH—Enable stealth mode (anti-detection)
OBSCURA_PROXY—Proxy URL for all traffic
OBSCURA_USER_AGENT—Default user-agent override
MCP_HTTP_HOST127.0.0.1HTTP transport host
MCP_HTTP_PORT3000HTTP transport port
MCP_TRANSPORTstdioTransport mode: stdio or streamable-http
OBSCURA_STARTUP_TIMEOUT_MS15000Milliseconds to wait for Obscura CDP to start
OBSCURA_NAVIGATION_WAIT_MS3000Milliseconds to wait after page navigation
CDP_REQUEST_TIMEOUT_MS10000Milliseconds to wait for CDP response

Development

Built with TypeScript, compiled to dist/, tested with Vitest.

git clone https://github.com/Metadrama/obscura-mcp

cd obscura-mcp npm install npm run build npm test

All 36 integration tests run against a real Obscura binary (auto-downloaded on first run). Tests use StdioClientTransport and cover every tool, format, and action.

Why Obscura?

  • No Chrome — pure Rust, no 200 MB browser bundle
  • CDP-native — exposes Chrome DevTools Protocol directly
  • Anti-detection — built-in stealth for scraping-resistant sites
  • Tiny footprint — ~15 MB binary, starts in milliseconds

License

MIT