\n\n`fingerprint-suite` is a handcrafted assembly of tools for browser fingerprint generation and injection.\nToday's websites are increasingly using fingerprinting to track users and identify them.\nWith the help of `fingerprint-suite` you can generate and inject browser fingerprints into your browser, allowing you to fly your scrapers under the radar.\n\n> Would you like to work with us on our fingerprinting tools or similar projects? [We are hiring!](https://apify.com/jobs)\n\n## Overview\n\n`fingerprint-suite` is a modular toolkit for browser fingerprint generation and injection. It consists of the following `npm` packages, which you can use separately, or together:\n\n- [`header-generator`](https://www.npmjs.com/package/header-generator): generates configurable, realistic HTTP headers\n- [`fingerprint-generator`](https://www.npmjs.com/package/fingerprint-generator): generates realistic browser fingerprints, affecting the HTTP headers and browser JS APIs\n- [`fingerprint-injector`](https://www.npmjs.com/package/fingerprint-injector): injects browser fingerprints into your Playwright or Puppeteer managed browser instance\n- [`generative-bayesian-network`](https://www.npmjs.com/package/generative-bayesian-network): our fast implementation of a Bayesian generative network used to generate realistic browser fingerprints\n\n## Quick start\n\nThe following example shows how to use the fingerprinting tools to camouflage your Playwright-managed Chromium instance.\n\n```typescript\nimport { chromium } from 'playwright';\nimport { newInjectedContext } from 'fingerprint-injector';\n\n(async () => {\n const browser = await chromium.launch({ headless: false });\n const context = await newInjectedContext(browser, {\n // Constraints for the generated fingerprint (optional)\n fingerprintOptions: {\n devices: ['mobile'],\n operatingSystems: ['ios'],\n },\n // Playwright's newContext() options (optional, random example for illustration)\n newContextOptions: {\n geolocation: {\n latitude: 51.50853,\n longitude: -0.12574,\n },\n },\n });\n\n const page = await context.newPage();\n // ... your code using `page` here\n})();\n```\n\nHere is the same example using Puppeteer:\n\n```typescript\nimport puppeteer from 'puppeteer';\nimport { newInjectedPage } from 'fingerprint-injector';\n\n(async () => {\n const browser = await puppeteer.launch({ headless: false });\n const page = await newInjectedPage(browser, {\n // constraints for the generated fingerprint\n fingerprintOptions: {\n devices: ['mobile'],\n operatingSystems: ['ios'],\n },\n });\n\n // ... your code using `page` here\n await page.goto('https://example.com');\n})();\n```\n\n## Support\n\nIf you find any bug or issue with any of the fingerprinting tools, please [submit an issue on GitHub](https://github.com/apify/fingerprint-suite/issues).\nFor questions, you can ask on [Stack Overflow](https://stackoverflow.com/questions/tagged/apify) or contact support@apify.com\n\n## Contributing\n\nYour code contributions are welcome and you'll be praised for eternity!\nIf you have any ideas for improvements, either submit an issue or create a pull request.\nFor contribution guidelines and the code of conduct,\nsee [CONTRIBUTING.md](https://github.com/apify/fingerprint-suite/blob/master/CONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the Apache License 2.0 -\nsee the [LICENSE.md](https://github.com/apify/fingerprint-suite/blob/master/LICENSE.md) file for details.\n","readmeFilename":"README.md"}
![\"Fingerprinting](\"https://raw.githubusercontent.com/apify/fingerprint-suite/master/static/logo_big_light.svg\"){kind=logo}
\n ![\"NPM](\"https://img.shields.io/npm/v/fingerprint-injector/latest.svg\")
\n ![\"Chat](\"https://img.shields.io/discord/801163717915574323?label=discord\")