{"data":{"slug":"cloakhq-cloakbrowser","name":"CloakBrowser","tagline":"Stealth Chromium that passes every bot detection test","github_url":"https://github.com/CloakHQ/CloakBrowser","owner":"CloakHQ","repo":"CloakBrowser","owner_avatar_url":"https://avatars.githubusercontent.com/u/263128610?v=4","primary_language":"Python","stars":30394,"forks":2517,"topics":["ai-agents","anti-detect","antidetect-browser","bot-detection","browser-automation","captcha-bypass","chromium","cloudflare","cloudflare-bypass","fingerprint","headless-browser","playwright","puppeteer","python","recaptcha","selenium","stealth-browser","undetected","web-scraping","webscraping"],"archived":false,"github_pushed_at":"2026-08-18T19:37:20+00:00","maintenance_label":"Very active","stars_delta_30d":1725,"url":"https://www.graphcanon.com/tools/cloakhq-cloakbrowser","markdown_url":"https://www.graphcanon.com/tools/cloakhq-cloakbrowser.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/cloakhq-cloakbrowser","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=cloakhq-cloakbrowser","description":"Stealth Chromium that passes every bot detection test. Drop-in Playwright replacement with source-level fingerprint patches. 30/30 tests passed.","homepage_url":"https://cloakbrowser.dev/","license":"MIT","open_issues":196,"watchers":140,"ai_summary":"A drop-in Playwright replacement with source-level fingerprint patches, built for web scraping and anti-detection needs. Passes all major bot detection tests.","readme_excerpt":"## Install\n\n**Python:**\n\n```bash\npip install cloakbrowser\n```\n\n**JavaScript / Node.js:**\n\n```bash\n\n---\n\n# ...or set it directly (env var, license_key= param, or ~/.cloakbrowser/license.key):\nexport CLOAKBROWSER_LICENSE_KEY=cb_xxxxxxxx\n```\n\nTry the latest free → **[cloakbrowser.dev/free](https://cloakbrowser.dev/free)**  ·  Scale up on Pro → **[cloakbrowser.dev](https://cloakbrowser.dev)**\n\n---\n\n# Auto-detect timezone/locale from proxy IP (requires: pip install cloakbrowser[geoip])\n\n---\n\n# Also auto-injects --fingerprint-webrtc-ip to prevent WebRTC IP leaks (no extra cost)\n\n---\n\n# Check binary installation status\nprint(binary_info())\n\n---\n\n# Pre-download binary (e.g., during Docker build)\nensure_binary()\n```\n\n---\n\n### Deployment Integrations\n\n| Platform | Example |\n|----------|---------|\n| [AWS Lambda](https://aws.amazon.com/lambda/) | [`aws_lambda/`](examples/integrations/aws_lambda/) — One-shot scrapes in Lambda (container image) |\n\n---\n\n## Docker\n\nPre-built image on Docker Hub — no install, no setup.\n\n> **Pro:** the image ships with the free binary. Set `CLOAKBROWSER_LICENSE_KEY` (e.g. `-e CLOAKBROWSER_LICENSE_KEY=cb_xxx`, or in Compose) and the latest binary downloads at runtime.\n\n---\n\n### Docker Compose\n\n```yaml\nservices:\n  cloakbrowser:\n    image: cloakhq/cloakbrowser\n    command: cloakserve\n    restart: unless-stopped\n    ports:\n      - \"127.0.0.1:9222:9222\"\n    healthcheck:\n      test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:9222/json/version\"]\n      interval: 30s\n      timeout: 5s\n      retries: 3\n      start_period: 10s\n```\n\n**Per-connection fingerprint seeds** — run multiple browser identities from a single container. Each unique seed spawns a separate Chrome process with its own fingerprint:\n\n```python\n\n---\n\n# Install Xvfb (virtual framebuffer)\nsudo apt install xvfb\n\n---\n\n### \"playwright install\" vs CloakBrowser binary\n\nYou do NOT need `playwright install chromium`. CloakBrowser downloads its own binary. You only need Playwright's system deps:\n\n```bash\nplaywright install-deps chromium\n```\n\n---\n\n---\n\n# Verify Docker image signature (Cosign/Sigstore)\ncosign verify \\\n  --certificate-identity-regexp \"https://github.com/CloakHQ/CloakBrowser/\" \\\n  --certificate-oidc-issuer \"https://token.actions.githubusercontent.com\" \\\n  cloakhq/cloakbrowser:latest\n```\n\n---\n\n## License\n\n- **Wrapper code** (this repository) — MIT. See [LICENSE](https://github.com/CloakHQ/CloakBrowser/blob/main/LICENSE).\n- **CloakBrowser binary** (compiled Chromium):\n  - **v146 and earlier** — free for personal and commercial use, no redistribution (OEM/SaaS license required to serve third parties).\n  - **v148 and later** — requires an active [CloakBrowser Pro](https://cloakbrowser.dev) subscription to download.\n  - See [BINARY-LICENSE.md](https://github.com/CloakHQ/CloakBrowser/blob/main/BINARY-LICENSE.md) for full terms.","github_created_at":"2026-02-22T08:09:57+00:00","created_at":"2026-07-07T17:40:15.327696+00:00","updated_at":"2026-08-19T18:02:09.170812+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"developer-tools","name":"Developer Tools","url":"https://www.graphcanon.com/categories/developer-tools","markdown_url":"https://www.graphcanon.com/categories/developer-tools.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/developer-tools"}],"tags":[{"slug":"anti-detect","name":"anti-detect"},{"slug":"antidetect-browser","name":"antidetect-browser"},{"slug":"bot-detection","name":"bot-detection"},{"slug":"browser-automation","name":"browser-automation"},{"slug":"captcha-bypass","name":"captcha-bypass"},{"slug":"cloudflare","name":"cloudflare"},{"slug":"fingerprint","name":"fingerprint"},{"slug":"headless-browser","name":"headless-browser"}],"trust":{"provenance":{"is_fork":false,"github_id":1163834030,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-08-19T18:02:08.325Z","maintenance":{"label":"Very active","score":96,"methodology":"github_public_v1","releases_90d":7,"days_since_push":0,"last_release_at":"2026-08-18T19:39:46Z","stars_delta_30d":1725,"open_issues_delta_30d":24},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:16:12.405Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-08-19T18:02:08.827Z"},"deploy":{"source":"dockerfile:Dockerfile","self_host":true,"observed_at":"2026-08-19T18:02:08.827Z","managed_saas":false},"has_cli":{"value":true,"source":"pyproject.toml:[project.scripts]","observed_at":"2026-08-19T18:02:08.827Z"},"languages":{"value":["python"],"source":"github.language+pyproject.toml","observed_at":"2026-08-19T18:02:08.827Z"},"has_docker":{"value":true,"source":"dockerfile:Dockerfile","observed_at":"2026-08-19T18:02:08.827Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-08-19T18:02:08.827Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["Use CloakBrowser when precise control over fingerprints and a high level of stealth are required to pass stringent bot detection tests.","Select it for projects that require robust bypassing of protections like Cloudflare, where traditional tools often fail."],"when_not_to_use":["Avoid using CloakBrowser if you prefer open-source solutions without license requirements for the latest binary versions.","Do not use CloackBrowser in environments where frequent updates to counter bot detection are unnecessary or overkill."],"source":"enrich:decision_facts","observed_at":"2026-07-11T13:19:03.909Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"CloakBrowser is a modified Chromium browser specifically tailored for passing bot detection tests, integrating fingerprint patches at source-level for advanced anti-detection in web scraping tasks. It offers both Python-"}]}}