Webify MCP는 DOM 그래프와 BM25 검색 (retrieval)을 사용하여 Claude Code에서의 웹 조사 토큰 사용량을 97% 절감합니다. 단 한 번의 pip 명령어로 설치하고 Claude가 웹 쿼리를 자동으로 이를 통해 라우팅하도록 하세요.

핵심 요약 (Key Takeaways)

• Webify MCP는 DOM 그래프와 BM25 검색 (retrieval)을 사용하여 Claude Code에서의 웹 조사 토큰 사용량을 97% 절감합니다.
• 단 한 번의 pip 명령어로 설치하고 Claude가 웹 쿼리를 자동으로 이를 통해 라우팅하도록 하세요.

변경 사항 — 구체적인 업데이트

Webify MCP는 Claude Code가 웹 조사를 처리하는 방식을 근본적으로 바꾸는 오픈 소스 MCP 서버입니다. 전체 웹페이지를 가져오는 대신 (URL당 3,00015,000 토큰), Webify는 DOM 구조 그래프를 구축하고, BM25를 사용하여 사용자의 쿼리에 따라 노드 점수를 매긴 뒤, 관련 있는 서브트리(subtree)만 반환합니다 — 즉, 80300 토큰만 사용합니다.

보이지 않는 15개의 쿼리에 대해 Claude의 내장 Deep Research와 비교한 블라인드 A/B 테스트에서, Webify는 매번 정확한 정보를 찾아냈습니다. 유일한 차이점은 철저한 다중 소스 쿼리에서의 완전성(completeness)이었으나, 이는 집중된 하위 쿼리(sub-queries)로 web_find()를 여러 번 호출함으로써 해결할 수 있습니다.

지금 바로 설치하세요:

pip install webify-mcp
claude mcp add webify -- webify-mcp

이것으로 끝입니다. Claude Code가 MCP 서버를 자동으로 검색하고 웹 조사를 이를 통해 라우팅하기 시작합니다.

사용자에게 미치는 의미 — 일상적인 Claude Code 사용에 미치는 구체적 영향

토큰 경제학 (Token Economics)

Claude Code가 컨텍스트(문서, API 사양, Stack Overflow, GitHub 이슈 등)를 위해 웹페이지를 가져올 때마다 컨텍스트 창(context window)을 소모합니다. 전형적인 API 문서 페이지는 5,00010,000 토큰이 소모됩니다. Webify는 이를 80300 토큰으로 줄여줍니다 — 이는 94~97%의 절감 효과입니다.

Claude가 10개의 페이지를 가져오는 세션의 경우, 50,000100,000 토큰에서 8003,000 토큰으로 줄어듭니다. 이는 작업 중간에 컨텍스트 제한에 도달하는 것과 실제 코드를 작성할 여유 공간을 확보하는 것의 차이입니다.

정확도 (Accuracy)

Webify는 단순히 페이지를 잘라내는 것이 아닙니다. DOM의 구조적 그래프 (structural graph)를 구축하고, 각 노드를 사용자의 특정 쿼리 (query)에 따라 점수를 매긴 뒤, 가장 관련성이 높은 서브트리 (subtree)를 반환합니다. 그 후 Haiku 합성 (synthesis) 단계를 통해 이를 간결한 답변으로 압축합니다.

A/B 테스트 결과, Webify는 모든 쿼리에서 정확한 답변을 찾아냈습니다. 완전성 격차 (completeness gap)는 6개 이상의 소스를 가로지르는 합성이 필요한 쿼리에서만 나타났으며, 이는 더 좁은 범위의 서브 쿼리 (sub-queries)로 web_find()를 여러 번 호출함으로써 해결할 수 있습니다.

자동 라우팅 (Automatic Routing)

설치하고 나면, Claude Code는 내장된 도구 대신 웹 조사 (web research)를 위해 Webify를 자동으로 사용합니다. 별도의 설정이나 프롬프트 변경은 필요하지 않습니다. 선호 정책 (preference policy)이 패키지 자체에 내장되어 있기 때문입니다.

지금 바로 시도해보세요 — 명령어, 설정 및 워크플로우

빠른 설정 (Quick Setup)

# 설치
pip install webify-mcp

...

실제 작동 방식

Webify는 두 가지 도구를 제공합니다:

• web_find(query) — 웹을 검색하고 (Brave API 또는 DuckDuckGo 폴백 (fallback)), 상위 3~6개 페이지를 가져와 그래프를 구축하며, 관련 서브트리를 검색하여 약 800 토큰 내외로 합성합니다.
• web_lookup(url, query) — 특정 페이지를 가져와 사용자의 쿼리와 관련된 80~300 토큰만을 반환합니다.

Claude Code는 웹 컨텍스트 (web context)가 필요할 때 이 도구들을 자동으로 호출합니다. 이를 트리거하는 프롬프트 예시는 다음과 같습니다:

"Raft와 Paxos 합의 알고리즘 사이의 트레이드오프 (tradeoffs)는 무엇인가요?"
→ Claude가 web_find()를 호출합니다 — 검색, 그래프 구축, 답변 합성 수행

"GitHub API 문서에서 속도 제한 (rate limits)을 찾아줘"
→ Claude가 web_lookup()을 호출합니다 — 해당 페이지를 가져와 관련 섹션만 반환

전문가 팁 (Pro Tips)

1. 심층 조사를 위해 집중된 하위 쿼리(sub-queries)를 사용하세요. 하나의 광범위한 쿼리 대신, 이를 3~5개의 구체적인 질문으로 나누고 각 질문에 대해 web_find()를 호출하세요. Webify의 아키텍처는 호출당 6개 이상의 소스까지 확장 가능하지만, 여러 번 호출하면 더욱 철저한 범위를 확보할 수 있습니다.

2. Brave API 키가 필요하지 않습니다. Brave API 키를 설정하지 않으면 Webify는 DuckDuckGo Lite(무료, 키 불필요)로 대체됩니다. 대부분의 쿼리에서 검색 품질은 유사합니다.

3. 모든 MCP 클라이언트에서 작동합니다. Claude Code, Cursor, Windsurf, VS Code 또는 Zed 사이를 전환하더라도 동일한 설정이 모든 곳에서 작동합니다. 한 번 설치하면 어디서든 혜택을 누릴 수 있습니다.

4. 정기적으로 업그레이드하세요. Webify는 활발하게 개발되고 있습니다. pip install --upgrade webify-mcp를 통해 최신 버전을 유지하세요.

결론 (The Bottom Line)

Webify MCP는 현재 Claude Code의 웹 조사(web research)를 위해 수행할 수 있는 가장 영향력 있는 토큰 최적화 방법입니다. 무료이며 오픈 소스이고, 10초 만에 설치할 수 있으며, 정확도를 유지하면서 웹 페치(web fetch) 토큰 비용을 97% 절감합니다. 문서, API 또는 웹 콘텐츠를 읽는 작업에 Claude Code를 사용한다면, 이는 고민할 필요도 없는 선택입니다.

한 가지 주의사항: 10개 이상의 페이지에서 모든 세부 정보를 가져와야 하는 철저한 다중 소스 조사(multi-source research)의 경우, 여러 번의 web_find() 호출이 필요합니다. 하지만 특정 API 파라미터 조회, 개념 이해, 코드 예제 찾기 등 90%의 사용 사례에서는 Webify가 비용의 5%만으로 심층 조사(Deep Research) 수준의 품질을 제공합니다.

출처: github.com

원문 게시처: gentic.news