Tools/fivetaku/insane-search

insane-search

Auto-bypass for blocked websites in Claude Code, Phase 0→3 adaptive scheduler, no API keys

2.5k+2/wkemergingPythonMIT Licensetrending

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Sep 2026

When Claude Code hits a 403 and gives up, insane-search keeps going. It installs from a plugin marketplace URL with no API keys and no configuration, then takes over automatically whenever an ordinary fetch gets blocked. MIT licensed, free, and it pulls in its own dependencies like curl_cffi and yt-dlp the first time it needs them.

The mechanism is an escalation ladder. It starts with public endpoints and feeds, drops to mobile and .json and /rss variants of the URL, then impersonates a real browser's TLS fingerprint, and finally spins up an actual headless browser for JavaScript-rendered pages. Every response gets scanned for OGP and JSON-LD, so even a partial page yields a title and a summary. At a login wall or paywall it stops and reports authentication required instead of pretending.

Solo research and one-off lookups: it works, and it works on sites that routinely stonewall agents. Teams building something durable: do not put this in a pipeline you depend on.

The catch: everything past the syndication step is precisely what anti-bot systems exist to detect, and the project hands you the terms-of-service question directly. Reddit, X, and LinkedIn all prohibit this in writing. The usual outcome is not a lawsuit, it is your IP quietly getting nowhere.

Free vs Self-Hosted vs Paid

fully free

Free

Everything. The full Phase 0 through Phase 3 escalation pipeline, platform-specific public readers, PDF text extraction, YouTube caption retrieval through yt-dlp, and OGP/JSON-LD extraction from partial responses. MIT licensed. No API keys, no signup, no paid tier.

Self-Hosted

It runs inside Claude Code on your own machine, so there is no server to stand up. Install is a marketplace add plus a plugin install. It auto-installs Python dependencies (curl_cffi, yt-dlp, and a headless browser once Phase 3 is reached) on first use, which is convenient and also worth knowing before you run it on a locked-down machine.

Paid

None from this project. One optional integration touches a paid service: when xAI credentials are already present, X keyword discovery is augmented with native x_search and billed by xAI. The free route stays active and can be forced with INSANE_SEARCH_XAI=off.

The Math

The cost here is not money, it is risk. Commercial scraping APIs charge for this same capability and absorb the blocking and the legal exposure as part of the price. Running it yourself moves that exposure onto your IP address and your accounts.

Verdict

Free, and money is not the question. Read DISCLAIMER.md and decide whether the terms-of-service exposure is yours to take.

Free and MIT with no paid tier. The cost is terms-of-service and IP-reputation risk, not dollars.

What to do by team size

Solo
free; useful for research, and the exposure is yours alone
Small team
free, but agree internally on which sites are in bounds before anyone leans on it
Medium team
free; do not build it into a pipeline, the blocking and legal risk scales with usage
Large team
Buy a commercial scraping API instead. Compliance and blocking are what you are paying them to absorb
Self-hosting ops:trivial

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Similar Tools

Score
70/100 · B+
Adoption17/30
Maintenance21/25
Community7/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

Community discussions enabled

License: MIT License

Use freely, including commercial. Just keep the license.

Commercial use: ✓ Yes

About

Owner
GPTaku (User)
Stars
2,488
Forks
294

Explore Further

More tools in the directory