カスタムフィンガープリント

はじめに

ブラウザフィンガープリントは、ブラウザとデバイスの構成情報を利用して、ほぼ一意の「デジタルフィンガープリント」を作成します。これは、Cookieがなくてもオンラインアクティビティを追跡するために使用できます。良いニュースは、スクレイピングブラウザではフィンガープリントの設定がオプションであることです。ブラウザのフィンガープリントに対して、ブラウザのユーザーエージェント、タイムゾーン、言語、画面解像度などのコアパラメータのような高度なカスタマイズ機能を提供しています。機能はカスタムスタートアップパラメータを通じて拡張できます。これは、マルチアカウント管理、データ収集、プライバシー保護などのシナリオに適しており、Scrapelessの独自のChromiumブラウザを使用して検出を完全に回避します。デフォルトでは、当社のスクレイピングブラウザサービスを使用すると、セッションごとにランダムなフィンガープリントが生成されます。

コア機能と制限事項

ユーザーエージェント制御

機能: HTTPリクエストヘッダー内のユーザーエージェント文字列のカスタマイズをサポートし、ブラウザエンジンバージョンとオペレーティングシステムの種類を定義できます。
制限: 現在、レンダリングエンジンの詳細（例：WebGLレンダリング機能）を変更することはできません。

画面解像度マッピング

機能: screen.widthとscreen.heightの戻り値をカスタマイズして、基本的なデバイスの画面サイズをシミュレートできます（物理的なアスペクト比に準拠する必要があります）。
制限: 現在、デバイスピクセル比（DPR）またはRetinaディスプレイの特性を偽造することはできません。

プラットフォーム属性の固定

機能: navigator.platformの固定された戻り値を設定できます（Windows / macOS / Linuxのみサポート）。これは、ブラウザの機能検出ロジックに影響を与えます。
制限: 現在、オペレーティングシステムのバージョン番号やハードウェアアーキテクチャ情報を変更することはできません。

その他の制限事項:

この機能は、ブラウザによってネイティブに公開されている標準化されたパラメータに対する限定的な調整のみをサポートします。ハードウェアレベルのフィンガープリントまたは高度な動作マスキングは含まれていません。

アプリケーションシナリオ

基本的なマルチアカウント分離: ユーザーエージェントと画面解像度を区別することで、単純なアカウント関連付けの検出を回避します。
軽量データ収集: 主流のブラウザ環境（Windows + Chrome）をシミュレートして、ターゲットWebサイトの基本的なアンチスクレイピング戦略（例：ユーザーエージェントブラックリスト）をバイパスします。
互換性テスト: さまざまなオペレーティングシステム（Windows / macOS）と画面サイズでのWebサイトの基本的なレンダリングロジックを確認します。

操作ガイド

フィンガープリントパラメータの説明

パラメータ名	タイプ	説明
userAgent	string	ブラウザのHTTPリクエストヘッダー内のユーザーエージェント文字列を定義します。ブラウザエンジン、バージョン番号、オペレーティングシステムなどの重要な識別情報が含まれています。Webサイトはこの値を使用してクライアント環境を識別し、コンテンツの適応と機能に影響を与えます。デフォルト値：ブラウザに従います
platform	enum	JavaScriptの`navigator.platform`プロパティの戻り値を指定し、ランタイム環境のオペレーティングシステムの種類を示します。「Windows」、「macOS」、または「Linux」がオプションの値です。このパラメータは、機能検出とシステム関連機能の有効化判定に使用されます。デフォルト値：Windows
screen	object	ブラウザによって報告されるディスプレイデバイスの物理的特性パラメータを定義し、JavaScriptの`window.screen`オブジェクトに直接マップされます。
screen.width	number	物理的な画面幅（ピクセル）。`screen.width`プロパティにマップされ、メディアクエリとレスポンシブレイアウトに影響を与えます。デフォルト値：ランダムなフィンガープリントに従います。最小値は640です。
screen.height	number	物理的な画面高さ（ピクセル）。`screen.height`プロパティにマップされ、幅と共にデバイスの解像度特性を決定します。デフォルト値：ランダムなフィンガープリントに従います。最小値は480です。
localization	object	言語、地域、タイムゾーンパラメータを含むブラウザのローカリゼーション環境設定を制御し、表示形式とコンテンツのローカリゼーション動作に影響を与えます。
localization.timezone	string	IANAタイムゾーンデータベース形式に準拠したタイムゾーン識別子（例：「Asia / Shanghai」）。JavaScriptのdateオブジェクトと`Intl.DateTimeFormat`出力のデフォルトのタイムゾーン動作を制御します。これはタイムゾーンフィンガープリントの重要なコンポーネントです。デフォルト値：America / New_York
localization.languages	[string]	ブラウザでサポートされている言語の優先順位リスト。`navigator.languages`プロパティとHTTP `Accept-Language`リクエストヘッダーにマップされ、Webサイトのコンテンツ言語選択ロジックを決定します。デフォルト値：「en」、「en-US」

userAgent

タイプ: string 説明: ブラウザのHTTPリクエストヘッダー内のユーザーエージェント文字列を定義します。ブラウザエンジン、バージョン番号、オペレーティングシステムなどの重要な識別情報が含まれています。Webサイトはこの値を使用してクライアント環境を識別し、コンテンツの適応と機能に影響を与えます。

例:

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.6834.83 Safari/537.36
Mozilla/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プロパティの戻り値を指定し、ランタイム環境のオペレーティングシステムの種類を示します。このパラメータは、機能検出とシステム関連機能の有効化判定に使用されます。

使用可能な値:

値	説明
”Windows”	Windowsオペレーティングシステム、デフォルト値
”macOS”	macOSオペレーティングシステム
”Linux”	Linuxオペレーティングシステム

screen

タイプ: object 説明: ブラウザによって報告されるディスプレイデバイスの物理的特性パラメータを定義し、JavaScriptのwindow.screenオブジェクトに直接マップされます。

screen.width: 物理的な画面幅（ピクセル）。メディアクエリとレスポンシブレイアウトに影響を与えます。最小値は640です。 screen.height: 物理的な画面高さ（ピクセル）。幅と共にデバイスの解像度特性を決定します。最小値は480です。

例:

width	height
1920	1080
1366	768
1280	720
768	1280

localization

タイプ: object 説明: 言語、地域、タイムゾーンパラメータを含むブラウザのローカリゼーション環境設定を制御し、表示形式とコンテンツのローカリゼーション動作に影響を与えます。

localization.timezone: IANAタイムゾーンデータベース形式に準拠したタイムゾーン識別子。JavaScriptのdateオブジェクトとIntl.DateTimeFormat出力のデフォルトのタイムゾーン動作を制御します。これはタイムゾーンフィンガープリントの重要なコンポーネントです。

例:

America/New_York
Asia/Shanghai
Europe/London

localization.languages: ブラウザでサポートされている言語の優先順位リスト。navigator.languagesプロパティとHTTP Accept-Languageリクエストヘッダーにマップされ、Webサイトのコンテンツ言語選択ロジックを決定します。

例:

["fr-FR", "en-US", "zh-CN"]
["en-US", "es-ES", "de-DE"]

参照: タイムゾーンデータベースのタイムゾーンリスト

例コード

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',
    }
}
 
// Create browser session and get WebSocket endpoint
const { browserWSEndpoint } = client.browser.create({
    session_name: 'sdk_test',
    session_ttl: 180,
    proxy_country: 'US',
    session_recording: 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();
})();

const puppeteer =require('puppeteer-core');
 
// 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',
    }
}
 
const query = new URLSearchParams({
  token: 'APIKey',// required
  session_ttl: 180,
  proxy_country: 'ANY',
  fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
 
const connectionURL = `wss://browser.scrapeless.com/browser?${query.toString()}`;
 
(async () => {
    const browser = await puppeteer.connect({browserWSEndpoint: connectionURL});
    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();
})();

const { chromium } = require('playwright-core');
 
// 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',
    }
}
 
const query = new URLSearchParams({
  token: 'APIKey',// required
  session_ttl: 180,
  proxy_country: 'ANY',
  fingerprint: encodeURIComponent(JSON.stringify(fingerprint)),
});
 
const connectionURL = `wss://browser.scrapeless.com/browser?${query.toString()}`;
 
(async () => {
    const browser = await chromium.connectOverCDP(connectionURL);
    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();
})();

倫理規定

責任あるフィンガープリントのカスタマイズを推奨します。

法的に認められたシナリオ（企業データコンプライアンスの収集、内部リスク管理テストなど）の場合のみ。
偽造されたフィンガープリントを使用してオンライン詐欺に関与したり、ユーザーのプライバシーを侵害したりすることは禁止されています。

セッションリプレイ CDP API