Search1API

Search1API MCP 서버

中文文档

Search1API 공식 MCP 서버 — 웹 검색, 뉴스, 페이지 검색, 사이트맵 탐색, 인기 주제를 하나의 API로 제공합니다.

인증

• OAuth를 지원하는 클라이언트는 Remote MCP URL에 직접 연결한 후 브라우저에서 로그인 및 접근 승인을 진행할 수 있습니다.
• 기존 통합 환경에서는 Search1API 대시보드의 API 키를 계속 사용할 수 있습니다.

빠른 시작 (Remote MCP)

설치가 필요 없습니다. MCP 클라이언트를 원격 URL로 구성하세요. 클라이언트가 OAuth를 지원하면 OAuth를 사용하고, 그렇지 않으면 API 키를 제공하세요.

인증

세 가지 방법을 지원합니다 — 클라이언트가 지원하는 방법을 사용하세요:

방법	형식
OAuth 2.1	키 없이 https://mcp.search1api.com/mcp에 연결하고 클라이언트 로그인 흐름을 따르세요
Authorization 헤더	Authorization: Bearer YOUR_SEARCH1API_KEY
URL 쿼리 매개변수(레거시)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth 또는 Authorization 헤더를 권장합니다. 쿼리 매개변수 자격 증명은 URL, 로그, 셸 기록에 노출될 수 있습니다.

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (웹)

설정 > 커넥터 > 사용자 지정 커넥터 추가:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Cursor 플러그인으로 설치하는 것을 권장합니다: 이 저장소에는 Remote MCP + OAuth용 Agent 플러그인 plugin.json + mcp.json(휴대용) 및 .cursor-plugin/plugin.json(Cursor Marketplace 메타데이터/로고)가 포함되어 있습니다. cursor.directory / Cursor Marketplace에서 제출하거나 설치한 후, 메시지가 표시되면 로그인하세요.

로컬 테스트를 위해 플러그인 파일을 ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/)에 복사하세요. 해당 디렉터리 외부에서 심볼릭 링크를 만들지 마세요 — Cursor는 외부 심볼릭 링크 대상을 거부합니다.

또는 수동으로 구성:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Agent 스킬

Agent 스킬은 search1api-cli로 이동했습니다. 다음 명령으로 설치하세요:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

로컬 모드 (stdio)

서버를 로컬에서 실행하려면 npx와 함께 Node.js 20 이상을 사용하세요 — 클론이 필요 없습니다:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

프록시 뒤에서 자체 호스팅 HTTP 배포를 사용하는 경우, Node.js 프로세스에 도달하는 내부 호스트 이름을 쉼표로 구분된 MCP_ALLOWED_HOSTS 환경 변수에 추가하세요. mcp.search1api.com 및 localhost 주소는 기본적으로 허용됩니다. Origin 헤더를 보내는 브라우저 기반 클라이언트는 신뢰할 수 있는 출처 호스트 이름도 쉼표로 구분된 MCP_ALLOWED_ORIGINS 변수에 추가해야 합니다. 서버 측 MCP 클라이언트의 요청은 일반적으로 Origin를 생략하므로 항목이 필요하지 않습니다.

도구

search

Search1API를 사용하여 웹을 검색합니다. 결과에는 인용 가능한 id/title/url 구조가 포함됩니다. 전체 페이지가 필요하면 결과 URL을 crawl에 전달하세요.

매개변수	필수	기본값	설명
query	예	-	검색어
max_results	아니요	10	결과 수
search_service	아니요	google	google, bing, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	아니요	0	전체 콘텐츠를 크롤링할 상위 결과 수; 성공적인 크롤링마다 기본 1크레딧 검색 요청에 1크레딧이 추가됩니다
include_sites	아니요	[]	포함할 사이트
exclude_sites	아니요	[]	제외할 사이트
time_range	아니요	-	day, month, year

news

뉴스 기사를 검색합니다.

매개변수	필수	기본값	설명
query	예	-	검색어
max_results	아니요	10	결과 수
search_service	아니요	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	아니요	0	전체 콘텐츠를 크롤링할 상위 결과 수; 성공적인 크롤링마다 기본 1크레딧 뉴스 요청에 1크레딧이 추가됩니다
include_sites	아니요	[]	포함할 사이트
exclude_sites	아니요	[]	제외할 사이트
time_range	아니요	-	day, month, year

crawl

URL에서 콘텐츠를 추출합니다.

매개변수	필수	설명
url	예	크롤링할 URL

sitemap

URL에서 모든 관련 링크를 가져옵니다.

매개변수	필수	설명
url	예	사이트맵을 가져올 URL

trending

인기 플랫폼에서 인기 주제를 가져옵니다.

매개변수	필수	기본값	설명
search_service	예	-	github, hackernews
max_results	아니요	10	항목 수

버전 기록

• v0.5.3: OAuth 리소스 및 도구 메타데이터에 더 이상 OIDC 세션 범위가 필요하지 않음; Smithery 및 Glama 레지스트리 배지 추가
• v0.5.2: MCP Origin 검증이 이제 요청 파싱 및 인증 전에 실행됨; 자체 호스팅 HTTP 배포에서 MCP_ALLOWED_ORIGINS로 신뢰할 수 있는 브라우저 출처 구성 가능
• v0.5.1: 문서, LobeHub 매니페스트, MCP 레지스트리 메타데이터 동기화; robots.txt이 전송 호스트에서 제공됨
• v0.5.0: 자동 프로토콜 협상 기능을 갖춘 MCP 2026-07-28 지원; 2025년대 HTTP 클라이언트용 무상태 호환성; 요청 수준 인증
• v0.4.0: 구조화된 출력 스키마, OAuth 보안 체계, 안전 주석, 공식 MCP 레지스트리 메타데이터
• v0.3.1: Remote MCP용 OAuth 2.1 지원; reasoning 도구 제거
• v0.3.0: Streamable HTTP를 통한 Remote MCP 지원; 세션별 API 키 인증
• v0.2.0: LibreChat 통합용 폴백 .env 지원
• v0.1.8: X(Twitter) 및 Reddit 검색 서비스
• v0.1.7: GitHub 및 Hacker News용 trending 도구
• v0.1.6: Wikipedia 검색 서비스
• v0.1.5: 새로운 검색 매개변수 및 서비스(arxiv, wechat, bilibili, imdb)
• v0.1.3: 뉴스 검색
• v0.1.2: 사이트맵
• v0.1.1: 웹 크롤링
• v0.1.0: 최초 릴리스

라이선스

MIT