Tài liệuCông cụ dành cho nhà phát triểnScrapeless MCPCấu hình

Cấu hình

Ngoài API token, bạn có thể tùy chỉnh cách Scrapeless MCP chạy mỗi 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 HTTP header (Streamable HTTP) — hai hình thức này tương ứng một-một với nhau.

Tùy chọn phiên

Stdio (Env Var)Streamable HTTP (Header)Mô tả
SCRAPELESS_KEYx-api-tokenBắt buộc. Scrapeless API token của bạn.
BROWSER_PROFILE_IDx-browser-profile-idID 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_PERSISTx-browser-profile-persistBật lưu trữ bền vững cho cookie, local storage và các trạng thái trình duyệt khác.
BROWSER_SESSION_TTLx-browser-session-ttlThờ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ơ bền vững với TTL 5 phút

{
  "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 — cùng các tùy chọn dưới dạng header

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

Mẹo

  • Hồ sơ cho phép agent giữ một phiên đã đăng nhập qua nhiều lần chạy — đặt cùng một BROWSER_PROFILE_ID mỗi lần và bật tính bền vững.
  • TTL cân bằng giữa chi phí và tính liên tục: TTL ngắn hơn giải phóng tài nguyên đám mây sớm hơn; TTL dài hơn giữ một phiên ấm 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ì mình muốn thay đổi.

Để xem hướng dẫn đầy đủ về các 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.