anysearch-ai/anysearch-mcp-server

Unified real-time search MCP server supporting general web search, vertical domain search, parallel batch search, and full-page URL content extraction.

AnySearch MCP 서버

무엇인지 – AI 코딩 보조 도구(OpenCode, Claude Code, Cursor, VS Code, Cline, OpenAI Codex, Google Antigravity, DeepSeek Harness, Hermes Agent, Oh My Pi 등)가 실시간 웹 검색, 도메인 전용 검색, 배치 검색, 전체 페이지 콘텐츠 추출을 수행할 수 있도록 해주는 가벼운 HTTP MCP(Model‑Context‑Protocol) 서버입니다.

왜 중요한가 – 현대의 LLM 기반 에이전트는 최신 정보가 필요합니다. AnySearch MCP는 단일 엔드포인트(https://api.anysearch.com/mcp)를 노출하여 구조화된 도구 호출(search, get_sub_domains, batch_search, extract)을 반환합니다. 서버는 선택적 API 키(더 높은 레이트 제한) 또는 익명 방식(낮은 제한)으로 작동하여 데모 및 프로덕션 환경에서 즉시 사용 가능합니다.

핵심 기능

기능	수행 가능한 작업
일반 웹 검색	자연어 쿼리를 보내면 최대 10개의 결과를 받을 수 있습니다.
수직 도메인 검색	금융, 학술, 보안, 법률, 코드 등 구조화된 데이터를 쿼리합니다. 먼저 `get_sub_domains`를 호출하여 허용되는 하위 도메인과 파라미터 스키마를 확인해야 합니다.
병렬 배치 검색	하나의 요청에서 1~5개의 독립적인 검색을 실행할 수 있으며, 실패는 격리됩니다.
URL 콘텐츠 추출	전체 HTML 페이지를 가져와 최대 50 k 문자로 자르고 Markdown 형식으로 반환합니다.
익명 접근	API 키가 필요 없으며, 서버는 모든 호출에 응답하지만 더 엄격한 레이트 제한을 적용합니다.

API 키 발급 방법 (선택 사항)

한 번의 클릭 등록 – 실제 사용 가능한 이메일을 사용해 https://api.anysearch.com/v1/auth/email/register에 POST 요청을 보냅니다. 응답에는 일회용 평문 키가 포함됩니다.
대시보드 – 대신 https://anysearch.com/console/api-keys에서 키를 생성할 수 있습니다.
키 우선순위 – CLI 플래그 > ANYSEARCH_API_KEY 환경 변수 > .env 파일 > 익명.

팁: 키는 환경 변수나 시크릿 매니저에 저장하세요. 소스 코드에 커밋하지 마세요.

연결 방법 (MCP 클라이언트 예제)

모든 클라이언트는 동일한 원격 엔드포인트를 사용하며 두 개의 헤더를 전송합니다:

Authorization: Bearer <YOUR_KEY>   # 익명 사용 시 생략
X-Anysearch-Client: mcp/1.0.0

아래는 가장 일반적인 에이전트들에 대한 최소 구성 스크립트입니다.

OpenCode (전역)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "anysearch": {
      "type": "remote",
      "url": "https://api.anysearch.com/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

opencode mcp list를 실행하여 연결을 확인하세요.

Claude Code (사용자 수준)

claude mcp add --transport http anysearch https://api.anysearch.com/mcp \
  --scope user \
  --header 'Authorization: Bearer ${ANYSEARCH_API_KEY}' \
  --header 'X-Anysearch-Client: mcp/1.0.0'

프로젝트 수준 설정을 원하면 동일한 필드를 가진 .mcp.json 파일을 생성하세요.

Cursor (프로젝트)

{
  "mcpServers": {
    "anysearch": {
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

사용자 정의 > MCPs에서 확인하세요.

VS Code (보안 프롬프트)

{
  "inputs": [{
    "type": "promptString",
    "id": "anysearch-api-key",
    "description": "AnySearch API 키",
    "password": true
  }],
  "servers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:anysearch-api-key}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

익명 사용 시 Authorization 줄을 제거하세요.

(README에는 Cline, OpenAI Codex, Google Antigravity, DeepSeek Harness, Hermes Agent, OMP에 대한 유사한 스크립트가 제공되며, 모두 동일한 헤더 패턴을 따릅니다.)

도구 계약 (서버가 기대하는 입력과 반환 값)

`search`

{
  "query": "string",               // 필수, 단일 의도
  "domain": "finance"?,            // 선택적 수직 도메인
  "sub_domain": "finance.us_stock"?,
  "sub_domain_params": {…}?,        // get_sub_domains에서 반환된 스키마와 일치해야 함
  "max_results": 10                 // 1~10, 기본값 10
}

`get_sub_domains`

{ "domain": "finance" }   // 또는 "domains": ["finance","academic"]

sub_domain | 설명 | params 형식의 Markdown 테이블을 반환합니다.

`batch_search`

{ "queries": [ {…search‑object…}, {…} ] }

최대 5개의 쿼리; 각각은 search 스키마를 따릅니다.

`extract`

{ "url": "https://example.com" }

페이지 콘텐츠를 Markdown 형식으로 반환합니다(최대 50 k 문자).

레이트 제한 및 오류 처리 (README에 설명된 대로)

상황	권장 대응
등록 시 잘못된 이메일	사용자에게 유효한 주소를 다시 입력하도록 요청하세요.
`409` / `email_already_registered`	제공된 `login_url`을 통해 로그인하도록 사용자에게 안내하세요. 재시도하지 마세요.
`429` (레이트 제한)	`Retry‑After` 헤더 또는 메시지를 존중하세요. 필요 시 익명 모드로 전환하세요.
`Key creation failed…`	메시지에서 이메일과 URL을 추출하고 사용자가 수동으로 키를 생성하도록 요청하세요.
`500` 내부 오류	나중에 다시 시도하거나 익명 접근으로 전환하세요.

언제 사용할까

에이전트 기반 연구 – 최신 웹 데이터가 필요한 LLM은 IDE에서 직접 search 또는 extract를 호출할 수 있습니다.
도메인 전용 워크플로우 – 금융 분석가, 법적 연구자, 개발자는 먼저 get_sub_domains를 호출하여 자신의 수직 도메인에 맞는 정확한 스키마를 확인할 수 있습니다.
배치 처리 – batch_search를 사용해 여러 독립적인 쿼리를 병렬로 실행하여 라운드트립을 줄일 수 있습니다.
데모 또는 프로토타입 – API 키가 필요 없으며, 단지 클라이언트를 엔드포인트로 지정하면 됩니다.

제한 사항

익명 모드는 더 엄격한 레이트 제한을 적용합니다(정확한 수치는 계정별로 다릅니다).
extract는 HTML 페이지에서만 작동하며 최대 50 k 문자로 자릅니다.
서버는 어떤 모델도 호스팅하지 않습니다. 순수한 검색 도구 제공자입니다.
오류는 HTTP 상태 코드, code, 또는 message 필드에서 해석해야 하며, 통일된 오류 객체는 없습니다.

빠른 시작 체크리스트

(선택 사항) 한 번의 클릭 이메일 흐름을 통해 API 키를 등록하세요.
환경 변수에 ANYSEARCH_API_KEY를 설정하거나 클라이언트 전용 구성 파일에 추가하세요.
선호하는 IDE/에이전트용 MCP 서버 구성 설정을 추가하세요(위의 스크립트 참조).
클라이언트의 mcp list / mcp test 명령어로 연결을 확인하세요.
LLM 기반 도구에서 search, get_sub_domains, batch_search, extract를 호출하세요.

결론 – AnySearch MCP 서버는 LLM 에이전트가 즉시 구조화된 방식으로 오픈 웹과 다양한 수직 데이터 소스에 접근할 수 있도록 해주는, 즉시 사용 가능한 표준 준수 브리지입니다. 간단한 키 관리와 광범위한 IDE 지원을 제공합니다.