Skip to content

miter37/insane-search

 
 

Repository files navigation

English | 한국어 | 中文 | 日本語 | Español

Fork notice — This is a fork of fivetaku/insane-search maintained by @miter37. It includes the upstream codebase plus PR #8 (v0.10.0, awaiting upstream review): 9 backward-compatible upgrades — JS shell detection, bot-wall classification, transient-status retry, body size cap, multi-strategy content extraction (trafilatura → JSON-LD → __NEXT_DATA__ → og:description → crude), PDF extraction, Playwright render-merge, cookie banner removal, heavy-resource blocking. See CHANGELOG.md for the full list. Use fivetaku/insane-search if you want the upstream release; use this fork for the additional extraction / recovery features.

insane-search

Impossible is nothing. If it's public, insane-search gets in.

A resilient public-page reader for Claude Code. No API keys, no proxy setup.

Claude Code No API key part of gptaku-plugins stars

Cinematic split: on the left a blocked site shows 403 Forbidden, a CAPTCHA, and a WAF wall; it shatters down the middle as insane-search breaks through on the right, returning a real public post from @claudeai (Claude Code Plugins) with its source — no API key.

⚡ Install

/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
/plugin install insane-search@gptaku-plugins
/reload-plugins

No commands to learn. Ask Claude Code normally — insane-search kicks in when a fetch gets blocked.

💬 Try it

Just ask normally — insane-search kicks in when a fetch gets blocked:

"Find what people are saying about Claude Code on Reddit and summarize the top threads." "Search X for posts about insane-search." "Summarize this YouTube video."

Expected: Claude reaches each site's public route — Reddit's feed, X via oEmbed, YouTube captions — with no login and no API key, and returns usable text, where the same request returns "I can't access that" without the plugin.

🌐 Works on

X · Reddit · YouTube · Hacker News · Naver · Coupang · LinkedIn · Medium · Substack · arXiv · GitHub · Stack Overflow · Bluesky · Mastodon — plus any site with a public page, feed, or /rss. Full platform list & methods → PLATFORMS.md.

⚙️ Why it gets through

  • It escalates, never pre-judges — public API readers → syndication gateways → TLS impersonation → a real headless browser, trying each route until one works.
  • It looks human — builds a full browser identity (real TLS fingerprint, cookie warming, referer chain), not just a swapped User-Agent.
  • It finds hidden APIs — watches the real browser's network traffic and reuses the site's own internal JSON.
  • Zero setup — auto-installs what it needs (curl_cffi, yt-dlp, …) on first use. No API keys, no signup.

🆚 Default Claude Code vs + insane-search

When you hit… Claude Code alone + insane-search
A 403 / WAF-blocked page ✖ gives up ✓ escalates until one route gets through
Platform content (X, Reddit, HN) ✖ often blocked or empty ✓ public API readers + syndication
An anti-bot / CAPTCHA challenge ✖ stops ✓ TLS impersonation, then a real headless browser
A media page (YouTube, 1,800+ sites) ✖ no transcript yt-dlp metadata + captions
Missing tools (curl_cffi, yt-dlp) ✓ auto-installs on first use
API keys / signup ✓ none
A login wall or paywall stops here, and says so (see Boundaries)

The differentiating row is the one thing the default fetcher can't do: it keeps trying public routes until one works.

✨ What just happened

Without it With insane-search
Ordinary fetch hits 403 and Claude says it can't read the page The plugin picks a public-access route and returns usable text
You manually try mirrors, archives, mobile URLs Fallbacks escalate automatically, public-only
A blocked page is a dead end Metadata and structured data still yield titles, prices, summaries

🔁 How it works

Phase 0→3 escalation pipeline: a blocked URL flows through special public endpoints → lightweight probes → TLS impersonation → a real headless browser until one returns clean public content; a login or paywall exits as 'authentication required'. Every response is scanned for OGP / JSON-LD.

Phase 0→3 adaptive scheduler — details

Each phase runs only if the previous one fails or detects a blocking signal:

  • Phase 0 — special public endpoints (platform APIs, feeds) it can't discover generically
  • Phase 1 — lightweight probes: public API readers, syndication gateways, mobile / .json / /rss URL variants
  • Phase 2 — TLS impersonation (curl_cffi: safari → chrome → firefox) with a full browser identity
  • Phase 3 — a real headless browser, which also surfaces the public JSON APIs a site uses internally
  • Exit — a login or paywall is detected: it reports "authentication required" rather than pretending

Every response is also scanned for OGP / JSON-LD, so even partial pages yield titles, summaries, and prices.

🔒 Boundaries

insane-search is a reader for public content, not a way around authentication.

  • Reaches what's available through public pages, public APIs, feeds, archives, and a browser's public responses.
  • Stops at logins and paywalls — it reports authentication required instead of trying to defeat them.
  • Never logs in as you and never stores or transmits credentials.
  • All routes use no-auth public endpoints and standard, documented techniques.

License

MIT


Part of gptaku-plugins — Claude Code plugins that break through the walls everything else stops at.

About

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

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages

  • Python 89.6%
  • JavaScript 7.8%
  • Shell 2.6%