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가 포함됩니다.

공급자 기능

설치

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