Skip to main content
Glama

Search Toolkit

AI 에이전트를 위한 공식 우선 웹 도구로, 영구적인 다중 키 로테이션과 MCP, CLI, Agent Skills의 세 가지 진입점을 제공합니다.

중국어 간체

설계

Search Toolkit은 모든 백엔드를 하나의 일반 검색 엔드포인트로 평탄화하는 대신 공급자별 기능을 보존합니다.

  • 공식 원격 MCP 프록시: Exa, Tavily, LinkUp.

  • 공식 STDIO MCP 프록시: Firecrawl.

  • 경량 공식 API 어댑터: Querit, Serper, Brave, Jina Search, TinyFish Search, Doubao Search, xAI Responses Web/X Search.

  • SQLite 기반의 공급자별 영구 키 풀.

  • 공급자 접두사가 붙은 업스트림 도구 이름과 스키마는 시작 시 공식 MCP 서버에서 발견된 후 선택적 공급자 도구 정책으로 필터링됩니다.

  • 원시 키는 저장소 외부의 로컬 JSON 파일에 보관됩니다.

구현에 사용된 공식 참고 자료에는 Codex MCP 구성 가이드, MCP TypeScript SDK, Exa MCP, Tavily MCP, LinkUp MCP, Firecrawl MCP가 포함됩니다.

Related MCP server: qsearch

공급자 기능

용도

공급자 또는 도구 계열

일반적인 빠른 웹 검색

Querit

정확한 문자열, 의미론적 검색, 코드 및 페이지 콘텐츠

Exa 공식 MCP

최신 검색, 추출 및 에이전트 리서치

Tavily 공식 MCP

간결한 Google 결과, 뉴스 및 이미지

Serper

독립적인 웹/뉴스 인덱스

Brave Search

출처가 명시된 답변 및 리서치 작업

LinkUp 공식 MCP

검색, 스크래핑, 크롤링, 매핑 및 구조화된 추출

Firecrawl 공식 MCP

간결한 검색

Jina Search

간결한 독립 검색

TinyFish Search

명시적 할당량 사용이 필요한 중국 현지 검색

Doubao, 기본적으로 수동 전용

모델 합성을 지원하는 네이티브 Web + X 검색

Grok / xAI Responses

설치

git clone https://github.com/TheWiseWolfHolo/search-toolkit E:/Script/Services/search-toolkit
cd E:/Script/Services/search-toolkit
npm install
npm run build

Node.js 22 이상이 필요합니다. 영구 로테이션 저장소가 내장 node:sqlite 모듈을 사용하므로 Node.js 24를 권장합니다.

구성

config.example.json을 저장소 외부의 비공개 경로에 복사하고 플레이스홀더 키를 교체하세요:

$env:SEARCH_TOOLKIT_CONFIG = "$HOME/.config/search-toolkit/providers.json"

로컬 일회성 임포터는 구성된 Kelivo 검색 키를 독립형 텍스트 구성으로 마이그레이션할 수 있습니다:

npm run import:kelivo

임포터는 Kelivo를 한 번 읽고 Windows에서 %USERPROFILE%/.config/search-toolkit/providers.json에 씁니다. 이는 MSIX AppData/Local 가상화를 피하므로 Codex, Claude Code 및 일반 CLI 프로세스가 동일한 물리적 파일을 읽습니다. 런타임 MCP 및 CLI 프로세스는 Kelivo에 절대 접근하지 않습니다.

CLI

node dist/src/cli.js tools
node dist/src/cli.js status
node dist/src/cli.js call querit_search '{"query":"latest AI agent news","limit":5}'
node dist/src/cli.js probe querit "Search Toolkit rotation probe"

MCP

먼저 빌드한 다음 로컬 STDIO 서버를 Codex에 추가하세요:

[mcp_servers.searchToolkit]
command = "C:/path/to/node.exe"
args = ["E:/Script/Services/search-toolkit/dist/src/mcp-server.js", "--config", "C:/Users/you/.config/search-toolkit/providers.json"]
startup_timeout_sec = 30
tool_timeout_sec = 120
enabled = true
default_tools_approval_mode = "writes"

MCP 서버는 다음을 노출합니다:

  • 공급자의 도구 정책으로 선택된 공급자 접두사 공식 업스트림 도구. Firecrawl은 전체 관리 카탈로그 대신 7개의 집중된 검색/획득 도구를 기본으로 사용합니다.

  • 구성된 모든 REST 어댑터 도구.

  • 감사 가능한 {provider, tool, upstreamTool} 메타데이터로 기능 인식 기본 라우팅을 제공하는 search_auto.

  • 마스킹된 키 풀 진단을 위한 search_pool_status.

  • 실시간 할당량 소모 로테이션 증명을 위한 search_rotation_probe.

전체 업스트림 카탈로그를 의도적으로 노출하는 경우에만 공급자에 대해 toolPolicy.allow를 ["*"]로 설정하세요. 쓰기 및 파괴적 도구는 수정된 주석을 유지하므로 클라이언트가 승인을 요청할 수 있습니다.

키 로테이션

각 요청은 해당 공급자 풀에서 하나의 키를 선택합니다. 커서는 프로세스 재시작 후에도 유지되며 SQLite를 통해 동시 에이전트 프로세스 간에 조정됩니다.

  • 200: 정상 진행.

  • 429 또는 402: 현재 키를 쿨다운.

  • 401 또는 403: 현재 키를 비활성화.

  • 5xx 또는 네트워크 오류: 다음 키로 한 번 재시도.

  • 400, 404 또는 422: 다른 키를 탓하지 않고 요청 오류를 유지.

providers.json, 원시 키 및 로테이션 상태는 Git에서 무시됩니다. 명령 출력과 MCP 메타데이터는 마스킹된 키 슬롯만 표시합니다.

스킬

재사용 가능한 스킬은 skills/search-toolkit/에 있습니다. 에이전트의 스킬 디렉터리에 복사하거나 링크하세요. 일반 리서치를 Search Toolkit으로 직접 라우팅하고, 진정한 다단계 작업을 위한 딥 리서치 오케스트레이션을 유지합니다.

개발

npm test
npm run smoke:mcp
npm pack --dry-run

라이선스

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.
      2 npm
      4
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to perform unified web research through a single MCP server, including search, page fetching, recursive crawling, document parsing, YouTube transcript extraction, and deep multi-query research.
      3
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perform live web searches across 9 engines, scrape web pages into clean formats, and run agentic research with citations via MCP.
      60 PyPI
      6
      MIT