superagents-lab/search1api-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

172 stars 39 forks 品質 83 トレンド 37NOASSERTION

Repository Install

superagents-lab/search1api-mcp は、https://github.com/superagents-lab/search1api-mcp. からインポートされたMCPサーバー候補です。

概要

superagents-lab/search1api-mcp は、https://github.com/superagents-lab/search1api-mcp. からインポートされたMCPサーバー候補です。

概要（AI 翻訳）

中文文档

Search1APIの公式MCPサーバー — ウェブ検索、ニュース、ページ検索、サイトマップ発見、トレンドトピックを一つのAPIでまとめています。

認証

OAuth対応クライアントはリモートMCPのURLに直接接続し、ブラウザ上でサインインしてアクセスを承認できます。
既存の統合はSearch1APIダッシュボードのAPIキーを引き続き使用できます。
すべてのMCPリクエスト(ツールディスカバリー(initialize、tools/list)を含む)は認証情報を必要とします。認証されていないリクエストはOAuthチャレンジを引き出し、クライアントはこれがサインインをトリガーする方法です。事前接続検査は静的サーバーカードによって提供されます。

クイックスタート(リモートMCP)

インストールは不要です。MCPクライアントをリモートURLで設定してください。クライアントが対応している場合はOAuthを使うか、APIキーを提供します。

認証

サポートされている方法は3つあり、クライアントがサポートしている方法を使いましょう。

方法	フォーマット
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

中文文档 | Deutsch

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"
      }
    }
  }
}