PlaywrightとPuppeteerの自動化にブラウザフィンガープリント生成・注入機能を追加するTypeScriptツールキット
中辛 の解説
header-generator、fingerprint-generator、fingerprint-injector、generative-bayesian-networkの4つのパッケージから構成されています。PlaywrightまたはPuppeteerのマネージドブラウザに対し、HTTPヘッダーとブラウザJavaScript の両方に影響するリアルなフィンガープリントを注入できます。デバイス種別（デスクトップ・モバイル）やOS、地理情報などの制約を指定して、カスタマイズされたコンテキストを生成できます。難易度は中程度で、TypeScript開発環境があれば即座に利用可能です。
이런 레포예요
이럴 때 쓰면 좋아요
- Playwrightやn.scrapping.jsでブラウザ検出を回避するスクレイパーの構築
- モバイルやiOSなど特定デバイスを装ったAPI接続テストの実施
- 地理情報と矛盾しないリアルなブラウザコンテキストでのウェブスクレイピング
핵심 기능
대안 대비 차별점
単なるランダムなヘッダー生成ではなく、統計的に一貫性のあるフィンガープリントをブラウザのJavaScript層にも注入するため、HTTPレベルとブラウザAPI両方の検出を同時に回避できます。
食べた人たち
実際に使ってみた人の記録です — 一言も完走の記録も、確認のうえで公開しています。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
준비물
- Node.js環境
- PlaywrightまたはPuppeteerのインストール
すぐ動かしてみるNode.js (pnpm)
ギット飯がリポジトリの構成を確認して組み立てた実行コマンドです。ターミナルに貼り付ければ、取得から実行までまとめて進みます。
git clone --depth 1 https://github.com/apify/fingerprint-suite.git && cd fingerprint-suite && pnpm install
실행 명령은 README를 확인하세요.
コードは自分の環境で動きます — はじめて見るリポジトリなら、中身にひととおり目を通してから実行するのがおすすめです。
README가 안내하는 자세한 단계 보기
- fingerprint-injectorをインストールします。
npm install fingerprint-injector
- Playwrightを使う場合、chromiumブラウザを起動し、フィンガープリント注入済みのコンテキストを作成します。
import { chromium } from 'playwright';
import { newInjectedContext } from 'fingerprint-injector';
(async () => {
const browser = await chromium.launch({ headless: false });
const context = await newInjectedContext(browser, {
fingerprintOptions: {
devices: ['mobile'],
operatingSystems: ['ios'],
},
newContextOptions: {
geolocation: {
latitude: 51.50853,
longitude: -0.12574,
},
},
});
const page = await context.newPage();
// ここでpageを使ってスクレイピングを実施
})();
- Puppeteerを使う場合、newInjectedPage()関数で同様に注入できます。
import puppeteer from 'puppeteer';
import { newInjectedPage } from 'fingerprint-injector';
(async () => {
const browser = await puppeteer.launch({ headless: false });
const page = await newInjectedPage(browser, {
fingerprintOptions: {
devices: ['mobile'],
operatingSystems: ['ios'],
},
});
await page.goto('https://example.com');
})();
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try apify/fingerprint-suite
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
スター推移 · 7日
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2022 年に作成
「데이터·크롤링」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/apify/fingerprint-suite)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る