gitwtfhub

wtf is deepcloak?

mrbaeksang/deepcloak — explained in plain English

Analysis updated 2026-05-18

36PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A local-first research agent that bypasses Cloudflare, Datadome, and CAPTCHA bot walls to read blocked pages and produce cited reports.

Mindmap

mindmap
  root((DeepCloak))
    What it does
      Bot wall bypass
      Cited research reports
    Tech stack
      Python
      Playwright
      MCP
    Use cases
      Deep research
      Agent integration
      Local-first search
    Audience
      Developers and researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Research a topic and get a cited report that includes pages blocked by bot detection.

REASON 2

Connect an AI agent like Claude to a research tool via its MCP server.

REASON 3

Run deep research entirely locally with no API key using a local LLM.

What's in the stack?

PythonPlaywrightMCPCloakBrowser

How it stacks up

mrbaeksang/deepcloakakmessi/vexfredantb/spec-driven-development
Stars363636
LanguagePythonPythonPython
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs a one-time stealth browser download plus an LLM API key or a local model.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

DeepCloak is a research tool that reads web pages for you and writes a report with citations, even when those pages are protected by bot detection systems like Cloudflare, Datadome, Turnstile, or reCAPTCHA. Many research tools simply get blocked by these systems and quietly leave those pages out of their answer, without ever telling the user what was missed. The tool works by trying a normal, fast page fetch first. If that hits a bot wall, it escalates to what the project calls a stealth fetch, using a companion project called CloakBrowser to get past the block, and continues the research loop from another project called local deep research. At the end of every report, it lists exactly how many of these walls it had to bypass, so the user knows how much of the answer came from harder to reach sources. It can be used three ways: as a command line tool, as an MCP server that an AI agent like Claude can call directly, or as a Claude skill. Everything runs locally, meaning searches and page content stay on the user's own machine rather than being sent to a third party service, and no API key is required if a local model like Qwen is used instead of a cloud provider such as OpenAI or Anthropic. Setup is done through a Python package installer, followed by a one time setup command that downloads the stealth browser component. A person then needs an API key for a cloud AI provider, or a locally running model through Ollama, to generate the actual report text. The README is direct about the tradeoffs involved: the tool ignores site robots.txt rules by default, though this can be turned back on with a flag, and using it to bypass bot protection means the user is responsible for making sure they are actually allowed to access whatever they are reading. It is released under the MIT license.

Yoink these prompts

Prompt 1
Use DeepCloak to research this topic and tell me how many bot walls it bypassed.
Prompt 2
Set up DeepCloak as an MCP server so my Claude agent can call deep_research directly.
Prompt 3
Run DeepCloak locally with Ollama so no data leaves my machine.
Prompt 4
Explain DeepCloak's stance on robots.txt and responsible use before I run it.

Frequently asked questions

wtf is deepcloak?

A local-first research agent that bypasses Cloudflare, Datadome, and CAPTCHA bot walls to read blocked pages and produce cited reports.

What language is deepcloak written in?

Mainly Python. The stack also includes Python, Playwright, MCP.

What license does deepcloak use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is deepcloak to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is deepcloak for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.