カスタムフィンガープリント
はじめに
ブラウザフィンガープリントは、ブラウザとデバイスの構成情報を利用して、ほぼ一意の「デジタルフィンガープリント」を作成します。これにより、Cookie がなくてもオンライン活動を追跡することが可能です。朗報なのは、スクレイピングブラウザにおいてフィンガープリントの設定は任意であることです。ブラウザのユーザーエージェント、タイムゾーン、言語、画面解像度などのコアパラメータをはじめ、ブラウザフィンガープリントの高度なカスタマイズ機能を提供しています。カスタム起動パラメータを通じて機能を拡張することも可能です。Scrapeless が独自に構築した Chromium ブラウザを使用することで検出を完全に回避できるため、マルチアカウント管理、データ収集、プライバシー保護などのシナリオに適しています。デフォルトでは、当社の Scraping Browser サービスを使用すると、セッションごとにランダムなフィンガープリントが生成されます。
主な機能と制限事項
User-Agent の制御
- 機能: HTTP リクエストヘッダー内の User-Agent 文字列のカスタマイズをサポートし、ブラウザエンジンのバージョンとオペレーティングシステムのタイプを定義できます。
- 制限: 現在、レンダリングエンジンの詳細(例:WebGL レンダリング機能)の変更はできません。
画面解像度のマッピング
- 機能:
screen.widthおよびscreen.heightの戻り値のカスタマイズをサポートし、基本的なデバイスの画面サイズをシミュレートできます(物理的なアスペクト比に準拠する必要があります)。 - 制限: 現在、デバイスピクセル比(DPR)や Retina ディスプレイの特性の偽装はできません。
プラットフォーム属性の固定
- 機能:
navigator.platformの戻り値を固定値に設定できます(Windows/macOS/Linux のみサポート)。これにより、ブラウザの機能検出ロジックに影響を与えます。 - 制限: 現在、OS のバージョン番号やハードウェアアーキテクチャ情報の変更はできません。
その他の制限事項:
この機能は、ブラウザがネイティブに公開する標準化されたパラメータの限定的な調整のみをサポートします。ハードウェアレベルのフィンガープリントや高度な行動マスキングは含まれません。
適用シナリオ
- 基本的なマルチアカウントの分離: User-Agent と画面解像度を区別することで、簡単なアカウント関連付けの検出を回避します。
- 軽量なデータ収集: 主流のブラウザ環境(Windows + Chrome)をシミュレートし、対象ウェブサイトの基本的なスクレイピング対策(例:User-Agent ブラックリスト)を回避します。
- 互換性テスト: 異なるオペレーティングシステム(Windows/macOS)および画面サイズにおけるウェブサイトの基本的なレンダリングロジックを検証します。
操作ガイド
フィンガープリントパラメータの説明
| パラメータ名 | 型 | 説明 |
|---|---|---|
| userAgent | string | ブラウザの HTTP リクエストヘッダー内の User-Agent 文字列を定義します。ブラウザエンジン、バージョン番号、OS などの主要な識別情報を含みます。ウェブサイトはこの値を使用してクライアント環境を識別し、コンテンツの適応や機能に影響を与えます。デフォルト値: ブラウザに従う |
| platform | enum | JavaScript の navigator.platform プロパティの戻り値を指定し、ランタイム環境の OS タイプを示します。指定可能な値は “Windows”、“macOS”、または “Linux” です。このパラメータは機能検出およびシステム関連機能の有効化判定に使用されます。デフォルト値: Windows |
| screen | object | ブラウザが報告する表示デバイスの物理的特性パラメータを定義し、JavaScript の window.screen オブジェクトに直接マッピングされます。 |
| screen.width | number | 物理的な画面幅(ピクセル)。screen.width プロパティにマッピングされ、メディアクエリやレスポンシブレイアウトに影響します。デフォルト値: ランダムフィンガープリントに従う、最小値 640。 |
| screen.height | number | 物理的な画面高さ(ピクセル)。screen.height プロパティにマッピングされ、幅とともにデバイスの解像度特性を決定します。デフォルト値: ランダムフィンガープリントに従う、最小値 480。 |
| localization | object | 言語、地域、タイムゾーンパラメータを含むブラウザのローカライズ環境設定を制御し、表示形式やコンテンツのローカライズ動作に影響を与えます。 |
| localization.basedOnIp | boolean | IP に基づいてタイムゾーンと言語を自動的に設定するかどうか。 |
| localization.timezone | string | IANA タイムゾーンデータベース形式に準拠したタイムゾーン識別子(例: “Asia/Shanghai”)。JavaScript の日付オブジェクトのデフォルトのタイムゾーン動作および Intl.DateTimeFormat の出力を制御し、タイムゾーンフィンガープリントの重要な構成要素です。デフォルト値: America/New_York |
| localization.languages | [string] | ブラウザがサポートする言語の優先度リスト。navigator.languages プロパティおよび HTTP Accept-Language リクエストヘッダーにマッピングされ、ウェブサイトのコンテンツ言語選択ロジックを決定します。デフォルト値: “en”, “en-US” |
| args | object | コマンドラインスイッチを使用してブラウザを実行します(例: --window-size、--proxy-bypass-list など、詳細はこちら)。以下の args はサポートされていないことにご注意ください: --load-extension, --user-data-dir, --fonts-dir, --remote-debugging-port |
userAgent
型: string
説明: ブラウザの HTTP リクエストヘッダー内の User-Agent 文字列を定義します。ブラウザエンジン、バージョン番号、OS などの主要な識別情報を含みます。ウェブサイトはこの値を使用してクライアント環境を識別し、コンテンツの適応や機能に影響を与えます。任意の userAgent をカスタマイズできます。
例:
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.6834.83 Safari/537.36Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.6834.83 Safari/537.36
platform
型: enum
説明: JavaScript の navigator.platform プロパティの戻り値を指定し、ランタイム環境の OS タイプを示します。このパラメータは機能検出およびシステム関連機能の有効化判定に使用されます。
指定可能な値の例:
| 値 | 説明 |
|---|---|
| ”Windows” | Windows OS、デフォルト値 |
| ”macOS” | macOS OS |
| ”Linux” | Linux OS |
screen
型: object
説明: ブラウザが報告する表示デバイスの物理的特性パラメータを定義し、JavaScript の window.screen オブジェクトに直接マッピングされます。
screen.width: 物理的な画面幅(ピクセル)。メディアクエリやレスポンシブレイアウトに影響します。最小値 640。 screen.height: 物理的な画面高さ(ピクセル)。幅とともにデバイスの解像度特性を決定します。最小値 480。
例:
| width | height |
|---|---|
| 1920 | 1080 |
| 1366 | 768 |
| 1280 | 720 |
| 768 | 1280 |
localization
型: object
説明: 言語、地域、タイムゾーンパラメータを含むブラウザのローカライズ環境設定を制御し、表示形式やコンテンツのローカライズ動作に影響を与えます。
localization.basedOnIp: IP に基づいてタイムゾーンと言語を自動的に設定するかどうか。
localization.timezone: IANA タイムゾーンデータベース形式に準拠したタイムゾーン識別子。JavaScript の日付オブジェクトのデフォルトのタイムゾーン動作および Intl.DateTimeFormat の出力を制御し、タイムゾーンフィンガープリントの重要な構成要素です。
例:
America/New_YorkAsia/ShanghaiEurope/London
localization.languages: ブラウザがサポートする言語の優先度リスト。navigator.languages プロパティおよび HTTP Accept-Language リクエストヘッダーにマッピングされ、ウェブサイトのコンテンツ言語選択ロジックを決定します。
例:
["fr-FR", "en-US", "zh-CN"]["en-US", "es-ES", "de-DE"]
args
型: object
説明: コマンドラインスイッチを使用してブラウザを実行します。詳細はこちら。以下の args はサポートされていないことにご注意ください: --load-extension, --user-data-dir, --fonts-dir, --remote-debugging-port
例:
- プロキシバイパス:
'--proxy-bypass-list': 'example.com' - ウィンドウサイズの設定:
'--window-size': '1280,1024'。screenフィンガープリントと同じ値に設定することを推奨します。
コード例
const { ScrapelessClient } = require('@scrapeless-ai/sdk');
const puppeteer =require('puppeteer-core');
const client = new ScrapelessClient({ apiKey: 'API Key' });
// custom browser fingerprint
const fingerprint = {
userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.1.2.3 Safari/537.36',
platform: 'Windows',
screen: {
width: 1280, height: 1024
},
localization: {
languages: ['zh-HK', 'en-US', 'en'], timezone: 'Asia/Hong_Kong',
},
args: {
'--proxy-bypass-list': 'example.com',
'--window-size': '1280,1024' // set window size as the same as the screen fingerprint
}
}
// Create browser session and get WebSocket endpoint
const { browserWSEndpoint } = client.browser.create({
sessionName: 'sdk_test',
sessionTTL: 180,
proxyCountry: 'US',
sessionRecording: true,
fingerprint,
});
(async () => {
const browser = await puppeteer.connect({browserWSEndpoint});
const page = await browser.newPage();
await page.goto('https://www.scrapeless.com');
const info = await page.evaluate(() => {
return {
screen: {
width:screen.width,
height:screen.height,
},
userAgent:navigator.userAgent,
timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
languages:navigator.languages
};
});
console.log(info);
await browser.close();
})();倫理規定
責任あるフィンガープリントのカスタマイズを推奨します:
- 法的に許可されたシナリオ(企業データのコンプライアンス収集、内部リスク管理テストなど)でのみ使用してください。
- 偽造されたフィンガープリントを使用してオンライン詐欺を行ったり、ユーザーのプライバシーを侵害したりすることは禁止されています。