設定
APIトークンに加え、Scrapeless MCPが各セッションを実行する方法をカスタマイズできます。オプションは環境変数（Stdio）またはHTTPヘッダー（Streamable HTTP）として提供され、これら2つの形式は1対1で対応しています。
セッションオプション
| Stdio（環境変数） | Streamable HTTP（ヘッダー） | 説明 |
|---|---|---|
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のデフォルト設定が適用されるため、変更したい項目のみを設定すれば問題ありません。
トランスポートと認証の詳細な手順については、Authentication and Transports を参照してください。