auth-fetch-mcp

Servidor MCP que permite a los asistentes de IA obtener contenido de páginas web autenticadas.

Cuando tu IA intenta leer una URL que requiere inicio de sesión, esta herramienta abre un navegador real para que inicies sesión, y luego captura el contenido de la página como HTML limpio. Las sesiones se guardan localmente, por lo que solo inicias sesión una vez por servicio.

Demo

Related MCP server: byob

Inicio rápido

Claude Code

claude mcp add --scope user auth-fetch -- npx auth-fetch-mcp@latest

.mcp.json (Cursor, Windsurf, etc.)

{
  "mcpServers": {
    "auth-fetch": {
      "command": "npx",
      "args": ["auth-fetch-mcp@latest"]
    }
  }
}

Chromium se instala automáticamente en la primera ejecución si no está presente.

Cómo funciona

1. Pide a tu IA que lea cualquier página autenticada; simplemente pega la URL.

2. Se abre una ventana del navegador automáticamente y navega a la página.

3. Inicia sesión como lo harías normalmente (admite SSO, 2FA, CAPTCHA, cualquier cosa).

4. Haz clic en el botón "📸 Capture" en la esquina inferior derecha cuando estés listo.

5. El contenido de la página se captura como HTML limpio (se eliminan los elementos de ruido, se conservan las etiquetas multimedia), el navegador se cierra y tu IA recibe el contenido.

Herramientas

auth_fetch

La herramienta principal. Obtiene el contenido de la página usando un navegador real, abriendo una ventana para iniciar sesión si es necesario. Devuelve HTML limpio con los elementos de ruido (navegación, pie de página, scripts, etc.) eliminados y las etiquetas multimedia (<img>, <video>, <iframe>) conservadas.

download_media

Descarga archivos desde URLs usando sesiones de navegador guardadas. Úsalo para descargar de forma diferida imágenes, videos u otros archivos encontrados en los resultados de auth_fetch. Las cookies guardadas del navegador manejan la autenticación automáticamente; no es necesario volver a iniciar sesión.

Flujo de ejemplo:

1. auth_fetch("https://notion.so/my-page")
   → Returns HTML with <img src="https://s3.notion.so/signed-url..."/> tags

2. AI reads the HTML, identifies an image it needs

3. download_media(["https://s3.notion.so/signed-url..."])
   → Downloads the image using saved session cookies
   → Returns { localPath: "~/.auth-fetch-mcp/downloads/.../file-1.png" }

list_pages

Enumera todas las pestañas abiertas en el navegador con sus URLs y títulos.

close_browser

Cierra la ventana del navegador. Las sesiones de inicio de sesión se guardan y se reutilizarán la próxima vez.

Almacenamiento de datos

Todos los datos se almacenan localmente en ~/.auth-fetch-mcp/. No se envía nada a servidores externos.

Para borrar todos los datos:

# Clear login sessions only
rm -rf ~/.auth-fetch-mcp/browser-data/

# Clear downloaded files only
rm -rf ~/.auth-fetch-mcp/downloads/

# Clear everything
rm -rf ~/.auth-fetch-mcp/

Herramientas de IA compatibles

• Claude Code

• Cursor

• Windsurf

• Cualquier cliente compatible con MCP que use transporte stdio

Limitaciones

• Requiere un entorno local (no funciona en interfaces de chat basadas en web)

• El primer acceso a cada servicio requiere inicio de sesión manual

• Las páginas muy largas se truncan para ajustarse a las ventanas de contexto de LLM (100K caracteres)

• Algunos sitios con detección de bots agresiva pueden no funcionar (prueba la opción wait_for)

Privacidad

• Todos los datos permanecen en tu máquina; no se envía nada a servidores externos

• El HTML capturado nunca se escribe en el disco; solo pasa a través de la tubería stdio a la herramienta de IA

• Las sesiones del navegador se almacenan localmente como un perfil estándar de Chromium

• Los archivos descargados van a un directorio local que tú controlas

Contribución

¡Las contribuciones son bienvenidas! Por favor, abre un issue o envía un pull request.

git clone https://github.com/ymw0407/auth-fetch-mcp.git
cd auth-fetch-mcp
npm install
npm run build

Licencia

MIT