Skip to main content

chrome-headers

Realistic Chrome browser header generation with TLS fingerprinting for HTTP clients. Generates deterministic browser profiles with accurate headers, cookies, and client metadata — making automated HTTP requests indistinguishable from a real browser session.

Install

pip install chrome-headers

Features

  • Deterministic BrowserProfile per client token (consistent UA, locale, timezone, resolution)
  • Auto-fetches and caches API build numbers from live JS assets
  • Fetches real fingerprint + cookies from API endpoints
  • Builds accurate X-Super-Properties with full client metadata
  • Complete header sets for REST, multipart, WebSocket, and analytics endpoints
  • Pre-built payload helpers for common HTTP operations

Usage

from chrome_headers import HeaderSpoofer

spoofer = HeaderSpoofer("your_token_here")

# REST headers
headers = spoofer.get_headers()

# Custom referer + context
headers = spoofer.get_headers(
    referer="https://example.com/channels/123/456",
    context_location="chat_input",
)

# WebSocket headers
ws_headers = spoofer.get_websocket_headers()

# Multipart (file upload)
mp_headers = spoofer.get_multipart_headers("multipart/form-data; boundary=----boundary")

# Build a message payload
payload = spoofer.build_message_payload("hello world")

# Full send_message bundle (url + headers + json)
bundle = spoofer.send_message(channel_id="123456", content="hi", guild_id="789")

Methods

Method Description
get_headers(...) Standard REST headers with Authorization
get_websocket_headers() Headers for WS upgrade handshake
get_multipart_headers(content_type) Headers for file/multipart uploads
get_analytics_headers() Headers for analytics endpoints
fetch_fingerprint() Fetch and cache fingerprint + cookies
refresh_build_number() Force re-fetch of build number
build_message_payload(...) Message JSON with optional reply, attachments, stickers
build_status_payload(...) Status JSON
build_profile_payload(...) Profile patch JSON
send_message(...) Ready-to-use {url, headers, json} bundle
join_guild(invite_code) Join guild bundle
add_friend(username) Add friend bundle
patch_avatar(image_bytes) Avatar patch bundle

License

Source Available — free to use, not to steal. See LICENSE.
Made by nox · github.com/pulbv

Metadata

Release files for chrome-headers 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chrome-headers 2.0.0
File Size Uploaded Provenance Actions
chrome_headers-2.0.0.tar.gz 9.3 kB Without provenance Details for chrome_headers-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for chrome-headers 2.0.0
File Interpreter ABI Platform Actions
chrome_headers-2.0.0-py3-none-any.whl Python 3 none any Details for chrome_headers-2.0.0-py3-none-any.whl

Total release size: 18.9 kB

Release files / chrome_headers-2.0.0.tar.gz

Download URL chrome_headers-2.0.0.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
0afc4e41e7699b7beeb4ca5a9619d035eb1835b2bb35d6e3fea34ac52e6f77f5
BLAKE2b-256 checksum
How to use checksums
4c024b52f560f3665e60e83b02a4859e6f64a633c6750fa1fc9d22587103fe68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.0

Release files / chrome_headers-2.0.0-py3-none-any.whl

Download URL chrome_headers-2.0.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8f49d3663bad087e7b04a9090e6fc840577b8ad4d619605a1255e634b0b45b4f
BLAKE2b-256 checksum
How to use checksums
c896573940a4aafb6ca61823c97053129322e40ac18623e56e5264f2a10f3c13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.0

Security for chrome-headers 2.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page