配置

除了 API 令牌之外，您还可以自定义 Scrapeless MCP 每次会话的运行方式。选项可通过环境变量（Stdio）或 HTTP 请求头（Streamable HTTP）提供——这两种形式是一一对应的。

会话选项

Stdio (Env Var)	Streamable HTTP (Header)	Description
`SCRAPELESS_API_KEY`	`x-api-token`	必填。您的 Scrapeless API 令牌。
`BROWSER_PROFILE_ID`	`x-browser-profile-id`	可复用的浏览器配置文件 ID，用于在多次运行间保持会话连续性。
`BROWSER_PROFILE_PERSIST`	`x-browser-profile-persist`	启用 Cookie、本地存储及其他浏览器状态的持久化存储。
`BROWSER_SESSION_TTL`	`x-browser-session-ttl`	会话最大超时时间（秒）。在达到该时长的无活动状态后，会话将过期。

示例

Stdio — 具有 5 分钟 TTL 的持久化配置文件

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

Streamable HTTP — 使用请求头传递相同选项

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

提示

配置文件 允许代理在多次运行间保持已登录的会话——每次设置相同的 BROWSER_PROFILE_ID 并启用持久化即可。
TTL 用于平衡成本与连续性：较短的 TTL 可更快释放云资源；较长的 TTL 则能保持会话活跃，以便处理后续请求。
未指定的选项将回退到 Scrapeless 默认值，因此您只需设置需要更改的项即可。

如需了解传输方式和身份验证的完整指南，请参阅身份验证与传输方式。

身份验证与传输方式 Claude Desktop / Claude Code