insane-search

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

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.

New in v0.16.3

• One fetch for content and trace: --json-content returns metadata, trace, and wrapped untrusted text together, without fetching the same URL again for diagnostics. Existing --json output still omits the body.
• Lazy PDF parsers: pdfplumber and pypdf load only when PDF extraction is needed, not during ordinary HTML startup. PDF extraction and fallback behavior are preserved.

⚡ 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 through free Brave/Yahoo discovery plus tweet-result validation, YouTube captions — with no login and no API key. If xAI credentials are already available, X keyword discovery is automatically augmented with native x_search; the free route remains active and can be forced with INSANE_SEARCH_XAI=off.

🌐 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.
• 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

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

✨ What just happened

🔁 How it works

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 for JS-rendered pages
• 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.
• You are responsible for lawful, authorized use — each site's Terms of Service, robots.txt, rate limits, and applicable law. This is a dual-use developer tool; see DISCLAIMER.md.

License

MIT — see DISCLAIMER.md for acceptable-use and user-responsibility terms.

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