Cấu hình

Ngoài mã thông báo API, bạn có thể tùy chỉnh cách Scrapeless MCP chạy từng phiên. Các tùy chọn được cung cấp dưới dạng biến môi trường (Stdio) hoặc tiêu đề HTTP (Streamable HTTP) — hai hình thức này ánh xạ một-một với nhau.

Tùy chọn phiên

Stdio (Env Var)	Streamable HTTP (Header)	Description
`SCRAPELESS_API_KEY`	`x-api-token`	Bắt buộc. Mã thông báo API Scrapeless của bạn.
`BROWSER_PROFILE_ID`	`x-browser-profile-id`	ID hồ sơ trình duyệt có thể tái sử dụng để duy trì tính liên tục của phiên qua các lần chạy.
`BROWSER_PROFILE_PERSIST`	`x-browser-profile-persist`	Bật lưu trữ liên tục cho cookie, bộ nhớ cục bộ và các trạng thái trình duyệt khác.
`BROWSER_SESSION_TTL`	`x-browser-session-ttl`	Thời gian chờ phiên tối đa tính bằng giây. Phiên sẽ hết hạn sau khoảng thời gian không hoạt động này.

Ví dụ

Stdio — hồ sơ lưu trữ liên tục với TTL 5 phút

{
  "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 — các tùy chọn tương tự dưới dạng tiêu đề

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

Mẹo

Hồ sơ (Profiles) cho phép tác nhân (agent) duy trì phiên đăng nhập qua nhiều lần chạy — hãy đặt cùng một BROWSER_PROFILE_ID mỗi lần và bật tính lưu trữ liên tục.
TTL cân bằng giữa chi phí và tính liên tục: TTL ngắn hơn sẽ giải phóng tài nguyên đám mây sớm hơn; TTL dài hơn giữ cho phiên hoạt động sẵn sàng cho các yêu cầu tiếp theo.
Các tùy chọn bị bỏ qua sẽ quay về giá trị mặc định của Scrapeless, vì vậy bạn chỉ cần thiết lập những gì muốn thay đổi.

Để biết hướng dẫn đầy đủ về phương thức truyền tải và xác thực, hãy xem Xác thực và Phương thức truyền tải.

Xác thực và phương thức truyền tải Claude Desktop / Claude Code