explaingit

mrbaeksang/deepcloak

Analysis updated 2026-05-18

36PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

What is it built with?

PythonPlaywrightMCPCloakBrowser

How does it compare?

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 get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.