Search1API

Search1API MCP Server

中文文档 | Deutsch

Search1API의 공식 MCP 서버입니다. 하나의 API로 웹 검색, 뉴스, 페이지 가져오기, 사이트맵 검색, 인기 주제를 이용할 수 있습니다.

인증

• OAuth를 지원하는 클라이언트는 Remote MCP URL에 직접 연결한 다음, 브라우저에서 로그인하고 액세스를 승인할 수 있습니다.
• 기존 통합은 Search1API 대시보드의 API 키를 계속 사용할 수 있습니다.
• 모든 MCP 요청(도구 검색 initialize, tools/list 포함)에는 인증 정보가 필요합니다. 인증되지 않은 요청에는 OAuth 챌린지가 반환되며, 이를 통해 클라이언트가 로그인을 시작합니다. 연결 전 검사는 정적 서버 카드에서 제공합니다.

빠른 시작(Remote MCP)

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

인증

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

방법	형식
OAuth 2.1	키 없이 https://mcp.search1api.com/mcp에 연결하고 클라이언트의 로그인 절차를 따릅니다
Authorization Header	Authorization: Bearer YOUR_SEARCH1API_KEY
URL Query Parameter (legacy)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

OAuth 또는 Authorization 헤더를 사용하는 것이 좋습니다. 쿼리 매개변수에 포함된 인증 정보는 URL, 로그, 셸 기록에 노출될 수 있습니다.

선택적 검색 및 뉴스 UI

Remote MCP는 위의 표준 엔드포인트에서 render_results을 제공합니다. search, news, ask 같은 데이터 도구는 카드를 자동으로 표시하지 않고 결과를 반환합니다. 출처 목록이 유용한 경우 모델은 기존 결과를 선택하거나 조합해 render_results에 전달할 수 있습니다. MCP Apps 클라이언트에서는 출처 카드가 반환되고, 그 외 환경에서는 읽기 쉬운 전체 텍스트 목록이 반환됩니다. 렌더링은 검색을 다시 실행하거나 검색 크레딧을 사용하지 않으며, UI URL 매개변수도 필요하지 않습니다.

HTTP와 stdio 모두 표준 serverInfo.icons 메타데이터를 통해 정사각형 Search1API 로고를 제공합니다. 512×512 PNG는 인증이나 리디렉션 없이 https://mcp.search1api.com/assets/icon-square.png에서 공개적으로 제공됩니다. 서버 카드와 레지스트리 매니페스트에서도 같은 아이콘을 사용합니다. 아이콘을 표시할지는 클라이언트가 결정하며, 플러그인 디렉터리에 별도로 저장된 아이콘을 대체하지는 않습니다.

인수, 제한 사항, 대체 동작은 렌더링 계약을 참조하세요. npm 패키지에는 0.8.0 버전부터 이 렌더러가 포함됩니다. 기존 설치를 업데이트하고 MCP 연결을 다시 시작하세요. npx -y search1api-mcp@latest은 최신 게시 패키지를 실행합니다.

URL을 변경한 후에는 커넥터를 다시 연결하거나 도구 정의를 새로 고치세요. 클라이언트가 도구 정의를 캐시할 수 있습니다. 이 URL 설정은 Remote MCP에만 적용되며 로컬 stdio 동작은 변경되지 않습니다. 자세한 내용과 릴리스 상태는 MCP Apps UI를 참조하세요.

Claude Desktop

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

Claude.ai (Web)

Claude 디렉터리에서 Search1API를 설치하고 Connect를 클릭한 다음 Search1API 계정으로 로그인하세요.

Add custom connector를 통해 https://mcp.search1api.com/mcp을 추가하지 마세요. 별도의 사용자 지정 커넥터가 생성되며, 이름을 직접 입력하지 않으면 Claude가 URL의 호스트(mcp.search1api.com)를 커넥터 이름으로 사용합니다.

Cursor

Cursor 플러그인으로 설치하는 것을 권장합니다. 이 저장소에는 OAuth를 사용하는 Remote MCP용 Agent Plugins 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"
      }
    }
  }
}

Antigravity

Antigravity 플러그인으로 설치하세요. antigravity-plugin/에는 매니페스트, mcp_config.json(OAuth를 사용하는 Remote MCP), Search1API 스킬, Marketplace README가 포함되어 있습니다. GitHub에서 바로 설치한 다음, 브라우저가 열리면 로그인하세요.

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

로컬 테스트를 하려면 체크아웃한 저장소에서 agy plugin validate --strict ./antigravity-plugin 및 agy plugin install ./antigravity-plugin을 실행하세요.

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 Skill

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

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

로컬 모드(stdio)

서버를 로컬에서 실행하려면 Node.js 20 이상과 npx를 사용하세요. 저장소를 복제할 필요가 없습니다.

{
  "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, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	아니요	1	결과 페이지(1-100). 페이지 이동은 bing, bingcn, baidu, grokipedia에서만 지원됩니다
crawl_results	아니요	0	전체 콘텐츠를 가져올 상위 결과 수. 크롤링에 성공할 때마다 기본 검색 요청 비용 1크레딧에 1크레딧이 추가됩니다
include_sites	아니요	[]	포함할 사이트
exclude_sites	아니요	[]	제외할 사이트
time_range	아니요	-	day, week, month, year

검색 엔진에서 제공하는 경우 결과의 metadata에 published_date가 포함됩니다. github 결과에는 kind, stars, language, num_comments가 추가됩니다.

news

뉴스 기사를 검색합니다. hackernews 결과는 토론 스레드로 연결되며, metadata에 story_url, points, num_comments가 추가됩니다.

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

crawl

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

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

sitemap

URL과 관련된 모든 링크를 가져옵니다.

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

trending

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

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

ask

에이전트 기반 검색입니다. 필요한 내용을 자연어로 설명하면 Search1API가 최대 5개의 엔진과 기간을 선택하고, 주제와 관련 없는 결과를 제외한 뒤 관련성 순으로 정렬된 인용 가능한 결과를 최대 10개 반환합니다. 결과에는 intent(사용된 키워드, 엔진, 기간)와 errors(다른 엔진의 작업이 완료되는 동안 실패한 엔진)도 포함됩니다. 요청이 완료될 때마다 5크레딧이 소요됩니다. 사용할 엔진을 이미 알고 있다면 search를 사용하세요.

매개변수	필수	설명
query	예	자연어로 작성한 요청(최대 500자)

maps

Google Maps에서 지역 업체와 장소를 찾습니다. 인용 가능한 결과로 최대 20개 장소가 포함된 페이지 하나를 반환합니다. title은 장소 이름, url은 Google Maps 링크이며, metadata에는 주소, 전화번호, 웹사이트, 카테고리, 평점, 리뷰 수, 좌표, 영업시간, 영업 상태, 가격대가 제공되는 경우 포함됩니다. 페이지당 장소 수와 관계없이 3크레딧이 소요됩니다.

매개변수	필수	기본값	설명
query	예	-	"커피숍" 또는 "오스틴의 치과"처럼 찾을 대상
country	아니요	us	두 글자 국가 코드
language	아니요	en	결과 언어(예: en, de, zh-CN)
location	아니요	-	지점 주변을 검색하는 { latitude, longitude, zoom? }. 2페이지 이상을 요청할 때 필요합니다
page	아니요	1	Google Maps 페이지(1-6). 페이지마다 별도의 호출이 필요합니다
max_results	아니요	20	해당 페이지에서 반환할 장소 수(1-20). 장소 수를 줄여도 가격은 낮아지지 않습니다

deepcrawl

문서 섹션처럼 한 사이트의 여러 페이지를 단일 작업으로 읽습니다. 사이트맵에서 사이트 URL을 찾고 경로 규칙에 맞는 URL만 남긴 다음, 인용 가능한 결과로 최대 max_pages개 페이지를 반환합니다. 결과에는 title, url, 페이지의 Markdown인 text가 포함됩니다. 또한 stats(검색, 일치, 건너뜀, 크롤링, 실패 수), failed(읽지 못한 URL과 그 이유), API message, 모든 페이지의 전체 내용을 담은 JSON 파일인 result_url도 포함됩니다. 읽은 페이지 수와 관계없이 작업을 시작할 때마다 20크레딧이 소요됩니다.

도구는 약 45초 동안 대기합니다. 크롤링이 계속 진행 중이면 status: "running"과 task_id를 반환합니다. 페이지를 가져오려면 해당 task_id을 사용해 deepcrawl을 다시 호출하세요. 이 호출은 무료이며 새 크롤링을 시작하지 않습니다. 페이지 텍스트는 페이지당 8,000자, 전체 80,000자로 제한됩니다. 축약된 페이지에는 metadata.truncated: true이 포함되며, 전체 텍스트는 result_url에 있습니다.

매개변수	필수	기본값	설명
url	예. 단, task_id이 제공된 경우는 제외	-	크롤링할 사이트 또는 섹션(예: https://example.com/docs/)
max_pages	아니요	10	경로 규칙을 적용한 뒤 검색 순서대로 읽을 최대 페이지 수(1-50). 페이지 수와 관계없이 가격은 동일합니다
include_paths	아니요	-	유지할 URL 경로 규칙(최대 20개). *이 없으면 규칙은 경로 세그먼트 경계에 적용되는 경로 접두사입니다(/docs은 /docs/api과 일치하지만 /docsearch과는 일치하지 않음). *이 있으면 전체 경로와 일치해야 하며, *은 /과도 일치합니다
exclude_paths	아니요	-	제외할 경로 규칙(최대 20개). 구문은 동일하며 제외 규칙이 우선합니다
type	아니요	sitemap	sitemap은 사이트맵을 사용하고, 사이트맵이 없으면 시작 페이지의 링크를 사용합니다. all는 시작 URL에서 발견한 모든 링크를 사용합니다
task_id	아니요	-	아직 실행 중인 크롤링의 task_id. 상태만 확인하며 다른 매개변수는 무시됩니다

send_feedback

잘못되었거나 비어 있거나 불완전한 결과, 해결하지 못한 오류, 실제 동작과 일치하지 않는 문서, 누락된 기능을 Search1API 팀에 보고하세요. 무료이며 크레딧이 소모되지 않습니다. 서버에 Search1API 인증 정보가 있으면 보고 내용이 해당 계정에 연결되어 팀에서 후속 조치를 할 수 있습니다. 인증 정보나 비공개 데이터는 포함하지 마세요.

매개변수	필수	설명
message	예	무엇이 잘못되었거나 누락되었는지, 최대 4000자
intent	아니요	달성하려던 목표
category	아니요	bug, feature_request, docs, other
request_id	아니요	문제가 발생한 호출의 요청 ID
model	아니요	모델 이름

버전 기록

• v0.11.0: 한 작업에서 한 사이트의 페이지를 최대 50개까지 읽는 새 deepcrawl 도구 추가(작업당 20크레딧, 실행 중인 작업 확인은 무료)

• v0.10.0: Google Maps 장소 검색을 위한 새 maps 도구 추가(최대 20개 장소가 포함된 페이지당 3크레딧)

• v0.7.0: 에이전트형 검색을 위한 새 ask 도구 추가. search에 bingcn, yandex, grokipedia 엔진과 page 매개변수가 추가됨. search 및 news는 time_range: "week"을 허용하고, published_date, GitHub, Hacker News 필드를 결과 metadata에 전달함

• v0.6.1: 버그 수정 — MCP 검색(initialize, tools/list, resources/*, prompts/list, server/discover)에 다시 인증 정보가 필요합니다. 익명으로 제공하면 "도구 목록 표시"를 "로그인 완료"와 동일하게 간주하는 클라이언트가 OAuth 흐름을 시작할 방법 없이 연결된 상태로 표시되었습니다. 이제 401 챌린지가 인증되지 않은 모든 요청에 응답하여 연결 시 OAuth 로그인을 복원합니다. 정적 서버 카드와 레지스트리 메타데이터를 통한 디렉터리 공개 여부는 변경되지 않았습니다

• v0.6.0: MCP 검색(initialize, tools/list, resources/*, prompts/list, server/discover)은 인증 정보 없이 제공되므로 클라이언트와 디렉터리에서 로그인 전에 도구를 열거할 수 있습니다. 도구 호출에는 여전히 OAuth 또는 API 키가 필요합니다. Stdio 모드는 SEARCH1API_KEY 없이 시작되어 도구 메타데이터를 제공하며, 호출 시에만 요청을 거부합니다. 잘못된 요청에는 HTML 오류 페이지 대신 JSON-RPC로 응답합니다

• v0.5.4: OAuth 발급자가 clerk.s1.dev로 변경되었으며 OAUTH_AUTHORIZATION_SERVER로 설정할 수 있습니다. MCP 서버 카드가 /.well-known/mcp/server-card.json에 게시되었습니다. 이제 OAuth 검색 문서에 캐시 헤더가 포함됩니다

• v0.5.3: OAuth 리소스 및 도구 메타데이터에 더 이상 OIDC 세션 범위가 필요하지 않습니다. Smithery 및 Glama 레지스트리 배지가 추가되었습니다

• v0.5.2: MCP Origin 검증이 이제 요청 파싱 및 인증 전에 실행됩니다. 자체 호스팅 HTTP 배포에서는 MCP_ALLOWED_ORIGINS을 사용해 신뢰할 수 있는 브라우저 출처를 설정할 수 있습니다

• v0.5.1: 문서, LobeHub 매니페스트, MCP Registry 메타데이터가 동기화되었습니다. 전송 호스트에서 robots.txt을 제공합니다

• v0.5.0: 자동 프로토콜 협상을 통한 MCP 2026-07-28 지원, 2025년대 HTTP 클라이언트와의 무상태 호환성, 요청 수준 인증

• v0.4.0: 구조화된 출력 스키마, OAuth 보안 체계, 안전성 주석, 공식 MCP Registry 메타데이터

• v0.3.1: Remote MCP용 OAuth 2.1 지원, 사용 중단된 추론 도구 제거

• 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용 인기 급상승 도구

• v0.1.6: Wikipedia 검색 서비스

• v0.1.5: 새 검색 매개변수 및 서비스(arxiv, wechat, bilibili, imdb)

• v0.1.3: 뉴스 검색

• v0.1.2: 사이트맵

• v0.1.1: 웹 크롤링

• v0.1.0: 최초 릴리스

라이선스

MIT

UI 및 타사 크레딧

render_results MCP Apps 뷰는 기존 소스를 제목과 도메인이 표시된 카드로 보여 줍니다. 모든 클라이언트는 전체 텍스트와 구조화된 결과 목록도 받습니다. 이 구성 요소는 Swami Malode가 제작한 Rare UI를 바탕으로 수정되었습니다. 해당 MIT + Commons Clause + Attribution 조건은 THIRD_PARTY_NOTICES.md에 재현되어 있습니다.

UI 설정, 샌드박스 출처 및 릴리스 확인: MCP Apps UI.