liustack/modsearch

ModSearch – LLM 채팅 앱용 무료 웹 검색 플러그인

개요

• DeepSeek, GLM, Claude Code, Codex, Pi, OpenCode 등과 같은 대규모 언어 모델(LLM)에 공개 웹 검색, 단일 페이지 가져오기, X(Twitter) 쿼리 기능을 추가하는 플러그인(스킬이라고 함)으로, 모델에 내장 브라우저가 없어도 작동합니다.
• 요청을 타사 검색 백엔드(Firecrawl, Antigravity CLI, Tavily, Exa, Grok Build 또는 로컬 페처) 체인을 통해 라우팅합니다. 기본값은 Firecrawl의 키리스 티어로, 가입 없이 월 1,000 무료 크레딧을 제공합니다.
• 한 엔진이 실패하거나 할당량을 소진하면 다음 엔진이 자동으로 시도됩니다(장애 조치). 엔진별로 여러 API 키를 제공할 수 있으며 오류 시 순환됩니다.

사용 방법

1. 설치 – 채팅 인터페이스 또는 명령줄에서 한 줄로, 예:

   npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.6
   # 또는
   npx skills add liustack/modsearch
   

2. 구성(선택 사항) – ~/.modsearch/config.json 또는 환경 변수(TAVILY_API_KEY 등)를 통해 Tavily, Exa, Firecrawl 등의 API 키를 추가합니다. 개별 엔진을 활성화/비활성화할 수도 있습니다.
3. 채팅 – 모델에게 최신 정보가 필요한 질문을 하거나 URL을 붙여넣습니다. 플러그인이 의도를 감지하고 엔진을 선택하며 검색/가져오기를 실행하고 소스, 신뢰도 메모, 선택적 uncertainty 필드가 포함된 JSON 구조화된 답변을 반환합니다.

주요 기능

• 기본적으로 무료: Firecrawl의 키리스 티어(월 1,000 크레딧)에서 즉시 작동합니다. 다른 엔진도 무료이거나 저비용 무료 할당량이 있습니다.
• 자동 장애 조치 및 키 순환 – 할당량이 소진되거나 요청 오류가 발생할 때 엔진 간 원활한 전환.
• X(Twitter) 검색: Grok Build를 통해 일반 웹 인덱스가 놓치는 콘텐츠를 모델이 볼 수 있습니다.
• 다양한 LLM 프런트엔드에서 작동 – DeepSeek Harness(dsh), Claude Code, Codex, Pi, OpenCode 등.
• CLI 및 구성 문서 – 전체 명령줄 인터페이스(modsearch), 자세한 구성 가이드, 출력 스키마, 보안 메모(SSRF 가드, 프라이빗 네트워크 차단).

지원되는 백엔드

엔진	기능	무료 티어	활성화 방법
Firecrawl(기본값)	웹 검색 + 페이지 가져오기	월 1,000 무료 크레딧, 키리스	즉시 작동
Antigravity CLI	웹 검색 + 가져오기(더 나은 합성)	무료, 브라우저 로그인	agy 설치 및 로그인
Tavily	웹 검색	월 1,000 무료 크레딧	modsearch config set tavily.apiKey <키>
Exa	웹 검색	월 $10 반복 크레딧(약 1,400 검색)	modsearch config set exa.apiKey <키>
Grok Build	X(Twitter) 검색	SuperGrok/X Premium 사용	grok 설치 및 로그인
local	페이지 가져오기 전용	내장	추가 단계 없음

일반적인 사용 사례

• URL을 보내 블로그 게시물의 간결하고 소스가 있는 요약을 얻습니다.
• "오늘 AI에서 흥미로운 점은?"이라고 묻고 신뢰도 메모와 함께 최근 소스가 있는 뉴스 항목을 여러 개 받습니다.
• 릴리스 페이지를 가져와 소프트웨어 프로젝트의 유지 관리 상태를 검색합니다.
• 모델의 지식이 오래된 경우 주제에 대한 최신 트윗을 가져옵니다.

문서 및 지원

• 설치 가이드, CLI 매뉴얼, 구성 참조, 출력 스키마, 보안 고려 사항, 문제 해결은 모두 리포지토리에 있습니다.
• 문제는 GitHub를 통해 처리되며, 커뮤니티 업데이트는 X(@liustack)에서 발표됩니다.
• 프로젝트는 MIT 라이선스이며 단일 작성자가 유지 관리합니다. 풀 리퀘스트는 받지 않지만 포크는 허용됩니다.

결론 ModSearch는 스마트한 엔진 폴백 시스템과 최소한의 설정으로 LLM에 라이브 웹 액세스를 복원하는 실용적이고 무료 우선의 플러그인입니다. 자체 검색 인프라를 관리하지 않고 최신 정보가 필요한 AI 에이전트 또는 채팅 기반 도구를 개발하는 개발자에게 특히 유용합니다.