liustack/modsearch

🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件，免费免注册免 API key。为不能联网的模型补上搜索，问网页或 X，拿回结构化 JSON 证据（搜索、抓取、引用）。

ModSearch란?

ModSearch는 대규모 언어 모델(LLM) 채팅 앱(특히 DeepSeek Harness(dsh))에 실시간 웹 검색, X(Twitter) 검색, 개별 페이지 가져오기 기능을 추가하는 플러그인입니다. 이는 무료 또는 저비용 검색 백엔드(Firecrawl, Antigravity CLI, Tavily, Exa, Grok, 내장 로컬 페처)를 연결하고, 할당량이 소진되거나 요청이 실패하면 자동으로 다음 백엔드로 폴백하는 방식으로 작동합니다.

중요한 이유

많은 인기 LLM(DeepSeek, GLM, Claude 등)은 직접 인터넷 액세스 없이 실행되어 최신 정보 활용이 제한됩니다. ModSearch는 기본 엔진(Firecrawl의 키리스 티어는 월 1,000 무료 크레딧 제공)에 API 키나 신용카드 등록 없이 이 기능을 복원합니다. 개발자와 최종 사용자는 모델에게 최신 뉴스를 묻거나, 블로그 게시물을 요약하거나, 특정 페이지를 검색하도록 요청할 수 있으며, 소스와 신뢰도 메모가 포함된 구조화된 JSON 응답을 받을 수 있습니다.

핵심 기능

기능	설명
기본 무료 웹 검색	기본 설정으로 Firecrawl의 키리스 티어(월 1,000 무료 크레딧)를 사용합니다.
자동 장애 조치가 있는 다중 엔진	Antigravity CLI, Tavily, Exa, Grok(X), 로컬 페처를 추가할 수 있습니다. 할당량이나 오류 발생 시 키를 순환하고 엔진을 전환합니다.
엔진별 키 순환	단일 엔진에 여러 API 키를 제공할 수 있습니다. ModSearch는 폴백 전에 순서대로 시도합니다.
X(Twitter) 검색	Grok Build 도구가 설치된 경우 ModSearch는 X 코퍼스를 쿼리하여 일반적인 웹 인덱스에서 놓치는 콘텐츠에 도달할 수 있습니다.
DeepSeek Harness 원클릭 설치	`npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@<version>` 명령으로 dsh에 직접 플러그인을 설치합니다.
다양한 채팅 환경에서 작동	Claude Code, Codex, Pi, OpenCode 및 CLI(`modsearch`)에서도 사용할 수 있습니다.
구조화된 출력	결과, 소스 URL, 집계 또는 저신뢰 정보를 나타내는 `uncertainty` 필드를 포함한 JSON을 반환합니다.

작동 방식(하이레벨 흐름)

모델에게 질문합니다(최신 정보가 필요하거나 URL을 제공).
ModSearch 스킬이 요청을 감지하고 최적의 사용 가능한 엔진(Firecrawl부터 시작)을 선택합니다.
인증, 속도 제한, 할당량 확인을 자동으로 처리하며 검색 또는 페이지 가져오기를 수행합니다.
원시 결과가 LLM에 반환되어 응답을 종합하고 소스 목록과 신뢰도 메모를 추가합니다.

시작하기

설치(가장 빠른 경로)

# DeepSeek Harness 플러그인으로 설치(가장 일반적인 사용 사례)
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modsearch@5.10.2

또는 일반 스킬 설치 프로그램 사용:

npx skills add liustack/modsearch

기본 Firecrawl 키리스 엔진은 즉시 작동합니다. 계정이나 API 키가 필요 없습니다.

추가 엔진 설정(선택 사항)

# Antigravity CLI – 브라우저 로그인 필요
curl -fsSL https://antigravity.google/cli/install.sh | bash
agy   # 로그인 후 종료

# Tavily 키 추가(있는 경우)
modsearch config set tavily.apiKey <YOUR_TAVILY_KEY>

# Exa 키 추가
modsearch config set exa.apiKey <YOUR_EXA_KEY>

환경 변수(TAVILY_API_KEY, EXA_API_KEY, FIRECRAWL_API_KEY)로도 키를 설정할 수 있습니다.

기본 사용법

설치 후 명령을 실행할 필요가 없습니다. 채팅만 하면 됩니다:

"최신 AI 뉴스를 요약해줘." → ModSearch가 웹 검색을 실행하고 최근 기사 6개를 집계하여 소스와 uncertainty 메모가 포함된 JSON을 반환합니다.
"Node.js 릴리스 페이지에 유지보수에 대해 뭐라고 쓰여 있나요?" → ModSearch가 페이지를 가져와 일정을 추출하고 표와 소스 링크로 응답합니다.

테스트용으로 CLI를 선호하는 경우:

modsearch search "AI breakthroughs 2024"
modsearch read_page https://example.com/blog/post

CLI는 스킬이 백그라운드에서 수행하는 작업을 그대로 반영합니다.

설정 하이라이트

엔진 활성화/비활성화 – modsearch config set tavily.enabled false
키 순환 – 여러 키를 쉼표로 구분: modsearch config set exa.apiKey key1,key2
자체 호스팅 엔드포인트 – 엔진을 사용자 지정 URL로 지정: modsearch config set tavily.baseURL https://my-proxy.example.com
보안 – 내장 SSRF 가드, DNS 리바인딩 보호, 개인 네트워크 주소 차단 옵션(docs/security.md 참조).

모든 설정은 ~/.modsearch/config.json에 권한 0600으로 저장됩니다.

대상 사용자

유료 검색 API 비용 없이 최신 정보가 필요한 AI 에이전트를 개발하는 개발자.
더 풍부한 웹 검색 경험을 원하는 DeepSeek Harness 사용자.
LLM 기반 어시스턴트(Claude Code, Codex, Pi, OpenCode)를 실험 중이며 즉시 작동하는 플러그인이 필요한 모든 사람.

제한 사항 및 주의 사항

무료 티어에는 월간 크레딧 제한이 있습니다(예: Firecrawl 1,000 크레딧). 소진되면 ModSearch는 다음 엔진으로 폴백하지만 전체 처리량은 무료 할당량 합계로 제한됩니다.
X(Twitter) 검색에는 Grok Build 도구와 유효한 X Premium 또는 SuperGrok 구독이 필요합니다.
리포지토리는 풀 리퀘스트를 받지 않습니다. 기여는 이슈 또는 개인 포크로 제한됩니다.

자세한 정보

설치 가이드 – INSTALL.md
CLI 참조 – skills/modsearch/references/cli.md
엔진 구성 – skills/modsearch/references/configure.md
출력 스키마 – skills/modsearch/references/output-schema.md
보안 세부 정보 – docs/security.md
데모 스크린샷 – README에 플러그인 작동 모습이 포함되어 있습니다.

빠른 요약

ModSearch는 LLM 채팅 앱을 위한 무료 플러그 앤 플레이 웹 검색 레이어입니다.
자동 키 순환 및 장애 조치가 있는 여러 검색 백엔드를 번들로 제공합니다.
DeepSeek Harness 설치는 단일 명령으로 가능하며 기본 엔진은 사용자 제공 자격 증명 없이 작동합니다.
이 도구는 소스와 신뢰도 정보가 포함된 구조화된 JSON을 반환하여 안정적인 AI 어시스턴트 구축을 용이하게 합니다.