superagents-lab/search1api-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

173 stars 39 forks 품질 82 트렌드 37NOASSERTION

Repository Install

superagents-lab/search1api-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

superagents-lab/search1api-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

中文文档

Search1API의 공식 MCP 서버 — 웹 검색, 뉴스, 페이지 검색, 사이트맵 발견, 트렌드 주제를 하나의 API에서 제공합니다.

인증

OAuth 인식 클라이언트는 원격 MCP URL에 직접 접속한 후 로그인하여 브라우저에서 접근 권한을 승인할 수 있습니다.
기존 통합은 Search1API 대시보드의 API 키를 계속 사용할 수 있습니다.
모든 MCP 요청 — 도구 탐색 (initialize, tools/list) 포함 — 는 자격 증명이 필요합니다. 인증되지 않은 요청은 OAuth 챌린지를 끌어내며, 이는 클라이언트가 로그인을 유발하는 방식입니다; 사전 연결 검사는 정적 서버 카드가 대신 수행합니다.

퀵 스타트 (원격 MCP)

설치가 필요 없습니다. 원격 URL로 MCP 클라이언트를 설정하세요. 클라이언트가 지원할 때 OAuth를 사용하거나 API 키를 제공하세요.

인증

지원되는 세 가지 방법이 있습니다 — 고객이 지원하는 방법을 사용하세요:

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

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Search1API MCP Server

中文文档

The official MCP server for Search1API — web search, news, page retrieval, sitemap discovery, and trending topics in one API.

Authentication

OAuth-aware clients can connect to the Remote MCP URL directly, then sign in and approve access in the browser.
Existing integrations can continue to use an API key from the Search1API dashboard.
Every MCP request — including tool discovery (initialize, tools/list) — requires a credential. Unauthenticated requests draw the OAuth challenge, which is how clients trigger sign-in; pre-connect inspection is served by the static server card instead.

Quick Start (Remote MCP)

No installation required. Configure your MCP client with the remote URL. Use OAuth when the client supports it, or provide an API key.

Authentication

Three methods are supported — use whichever your client supports:

Method	Format
OAuth 2.1	Connect to `https://mcp.search1api.com/mcp` without a key and follow the client sign-in flow
Authorization Header	`Authorization: Bearer YOUR_SEARCH1API_KEY`
URL Query Parameter (legacy)	`https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY`

Prefer OAuth or the Authorization header. Query-parameter credentials can be exposed in URLs, logs, and shell history.

Optional search and news UI

Remote MCP exposes render_results at the standard endpoint above. Data tools such as search, news and ask return results without automatically showing cards. When a source list helps, the model can select or combine existing results and pass them to render_results. It returns source cards in MCP Apps clients and a complete readable text list elsewhere. Rendering does not repeat a search or consume search credits; no UI URL parameter is required.

Both HTTP and stdio advertise the square Search1API logo through standard serverInfo.icons metadata. The 512×512 PNG is served publicly at https://mcp.search1api.com/assets/icon-square.png, without authentication or redirects. The server card and registry manifest use the same icon. Clients choose whether to display it; this does not replace an icon stored separately by a plugin directory.

See the rendering contract for arguments, limits and fallback behavior. The npm package includes this renderer from version 0.8.0. Update existing installations and restart the MCP connection; npx -y search1api-mcp@latest starts the latest published package.

GitHub에서 전체 README 보기

설치

npx -y search1api-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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