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
BrowserProfileper 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-Propertieswith 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.