insane-search — Claude Code에서 차단된 웹사이트를 자동으로 뚫는 플러그인
목차
Claude Code로 웹 리서치를 하다 보면 403, WAF, CAPTCHA 등에 막혀 "이 사이트는 접근할 수 없습니다"라는 답변을 받는 경우가 많다. insane-search는 바로 이 문제를 해결하기 위해 만들어진 Claude Code 플러그인이다. API 키도, 회원가입도, 별도 설정도 필요 없다. 설치만 하면 Claude Code가 포기하던 사이트들을 자동으로 뚫기 시작한다.
insane-search란?
insane-search는 차단된 웹사이트에 대해 Phase 0~3까지 4단계 적응형 스케줄러를 자동으로 실행하는 Claude Code 스킬이다. 각 단계는 이전 단계가 실패했을 때만 다음 단계로 에스컬레이션된다. 단순한 스크래퍼가 아니라 방법 선택 레이어로, 공개 API와 표준 기법들을 조합해 최적의 접근 경로를 찾아낸다.
4단계 적응형 스케줄러
insane-search의 핵심은 단계적으로 공격 수위를 높여가는 구조에 있다.
| 단계 | 방법 | 설명 |
|---|---|---|
| Phase 0 | 특수 엔드포인트 인덱스 | X/Twitter, Reddit, YouTube 등 15개 플랫폼별 전용 API 경로를 먼저 시도 |
| Phase 1 | 경량 프로브 (병렬) | WebFetch, Jina Reader, curl UA 변경, URL 변형(m.도메인, .json, /rss) 등을 동시에 시도 |
| Phase 2 | TLS 위장 + 신원 스푸핑 | curl_cffi로 브라우저 TLS 지문을 모방하고, 쿠키 워밍·리퍼러 체인·로케일 헤더로 완전한 브라우저 신원을 구축 |
| Phase 3 | 풀 브라우저 | Playwright MCP로 실제 브라우저를 구동하고, 네트워크 트래픽에서 숨겨진 JSON API까지 발견 |
주요 특징
- 신원 스푸핑(Identity Spoofing) — 단순한 UA 변경이 아니라, 홈페이지 쿠키 워밍 → 리퍼러 체인 → 로케일 매칭 헤더까지 완전한 브라우저 신원을 구축한다. fmkorea(HTTP 430)나 LinkedIn(로그인 월) 같은 사이트도 이 단계에서 뚫린다.
- 인텐트 라우팅(Intent Routing) — "이 URL 가져와"와 "X에서 이 키워드 검색해"는 다른 문제다. insane-search는 키워드 검색 요청을 WebSearch나 네이버 검색으로 먼저 보낸 뒤, 얻은 URL의 콘텐츠를 가져오는 2단계 파이프라인을 자동으로 실행한다.
- 자동 의존성 설치 — TLS 위장에 필요한
curl_cffi, RSS 파싱용feedparser, 미디어 사이트용yt-dlp가 없으면 자동으로 설치하고 시도한다. 사용자는 눈치채지도 못한다. - 숨겨진 API 발견 — Phase 3에서 단순히 페이지를 렌더링하는 데 그치지 않고, 브라우저의 네트워크 트래픽을 감시해 사이트가 내부적으로 사용하는 실제 JSON API를 포착한다.
지원 플랫폼
인덱스에 명시적으로 등록된 특수 엔드포인트는 약 15개 그룹이다. 나머지는 적응형 스케줄러가 자동으로 처리한다.
| 플랫폼 | 접근 방법 |
|---|---|
| X/Twitter | Syndication API + oEmbed + WebSearch 키워드 검색 |
| URL + .json + Mobile UA | |
| YouTube 등 1,858개 미디어 | yt-dlp --dump-json |
| Hacker News | Firebase API + Algolia Search |
| 네이버 검색/금융 | curl_cffi 신원 스푸핑 + search.naver.com |
| Bluesky / Mastodon | AT Protocol / 인스턴스별 Public API |
| arXiv / CrossRef / Wikipedia | 공개 REST/JSON API |
Coupang, LinkedIn, Medium, 한국 커뮤니티 등은 별도 인덱스 없이 Phase 1~3 체인에서 자동 처리된다.
설치 방법
설치는 단 두 줄이면 끝난다.
/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
/plugin install insane-search이후 Claude Code를 재시작하면 된다. 별도 명령어 없이 평소처럼 대화하면 차단된 사이트를 만났을 때 자동으로 작동한다.
사용 예시
"r/LocalLLaMA에서 뭐가 핫해?"
"X에서 insane-search 관련 포스트 검색해"
"이 YouTube 영상 요약해줘"
"네이버에서 클로드코드 관련 뉴스 찾아줘"
"LinkedIn에서 AI 에이전트 관련 글 찾아줘"별도 명령어 없이 자연어로 요청하면 insane-search가 자동으로 트리거된다. GitHub에서 358개의 스타를 받으며 개발자 커뮤니티에서 빠르게 주목받고 있는 이 플러그인은 MIT 라이선스로 누구나 자유롭게 사용할 수 있다.
참조 링크
- insane-search GitHub 리포지토리공식 소스코드 및 문서