配置

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

会话选项

Stdio (Env Var)	Streamable HTTP (Header)	说明
`SCRAPELESS_KEY`	`x-api-token`	必填。你的 Scrapeless API 令牌。
`BROWSER_PROFILE_ID`	`x-browser-profile-id`	可复用的浏览器配置文件 ID，用于跨运行保持会话连续性。
`BROWSER_PROFILE_PERSIST`	`x-browser-profile-persist`	为 cookies、local storage 及其他浏览器状态启用持久化存储。
`BROWSER_SESSION_TTL`	`x-browser-session-ttl`	最大会话超时时间（秒）。会话在此空闲时长后过期。

示例

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

{
  "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"
      }
    }
  }
}

Streamable HTTP —— 以头的形式提供相同的选项

{
  "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"
      }
    }
  }
}

提示

配置文件让 agent 能够在多次运行之间保持已登录的会话 —— 每次都设置相同的 BROWSER_PROFILE_ID 并启用持久化。
TTL 在成本与连续性之间取得平衡：较短的 TTL 能更快释放云端资源；较长的 TTL 则可为后续请求保持一个热会话可用。
未设置的选项将回退到 Scrapeless 默认值，因此你只需设置想要更改的部分。

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

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