DocumentaciónHerramientas para desarrolladoresScrapeless MCPConfiguración

Configuración

Además del token de API, puede personalizar cómo ejecuta Scrapeless MCP cada sesión. Las opciones se proporcionan como variables de entorno (Stdio) o encabezados HTTP (HTTP transmisible) — ambas formas se corresponden una a una.

Opciones de sesión

Stdio (Variable de entorno)HTTP transmisible (Encabezado)Descripción
SCRAPELESS_KEYx-api-tokenObligatorio. Su token de API de Scrapeless.
BROWSER_PROFILE_IDx-browser-profile-idIdentificador de perfil de navegador reutilizable para mantener la continuidad de la sesión entre ejecuciones.
BROWSER_PROFILE_PERSISTx-browser-profile-persistHabilita almacenamiento persistente para cookies, almacenamiento local y otros estados del navegador.
BROWSER_SESSION_TTLx-browser-session-ttlTiempo máximo de expiración de sesión en segundos. La sesión expira tras este período de inactividad.

Ejemplos

Stdio — perfil persistente con un TTL de 5 minutos

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "command": "npx",
      "args": ["-y", "scrapeless-mcp-server"],
      "env": {
        "SCRAPELESS_KEY": "YOUR_SCRAPELESS_KEY",
        "BROWSER_PROFILE_ID": "my-profile",
        "BROWSER_PROFILE_PERSIST": "true",
        "BROWSER_SESSION_TTL": "300"
      }
    }
  }
}

HTTP transmisible — mismas opciones como encabezados

{
  "mcpServers": {
    "Scrapeless MCP Server": {
      "type": "streamable-http",
      "url": "https://api.scrapeless.com/mcp",
      "headers": {
        "x-api-token": "YOUR_SCRAPELESS_KEY",
        "x-browser-profile-id": "my-profile",
        "x-browser-profile-persist": "true",
        "x-browser-session-ttl": "300"
      }
    }
  }
}

Consejos

  • Los perfiles permiten que un agente mantenga una sesión iniciada entre múltiples ejecuciones — establezca el mismo BROWSER_PROFILE_ID cada vez y habilite la persistencia.
  • El TTL equilibra costo y continuidad: TTLs más cortos liberan recursos en la nube antes; TTLs más largos mantienen una sesión activa disponible para solicitudes posteriores.
  • Las opciones omitidas revertirán a los valores predeterminados de Scrapeless, por lo que solo necesita establecer lo que desea modificar.

Para una guía completa sobre transportes y autenticación, consulte Autenticación y Transportes.