Search1API MCP Server

Search1API MCP サーバー

中文文档

Search1API の公式 MCP サーバーです。ウェブ検索、ニュース、ページ取得、サイトマップの検出、トレンドトピックを 1 つの API で利用できます。

認証

• OAuth 対応クライアントはリモート MCP URL に直接接続してから、ブラウザーでサインインし、アクセスを承認できます。
• 既存の連携では、Search1API ダッシュボードの API キーを引き続き使用できます。
• ツールの検出（initialize、tools/list）を含むすべての MCP リクエストには認証情報が必要です。認証されていないリクエストには OAuth チャレンジが返され、これによりクライアントはサインインを開始します。接続前の確認には、代わりに静的なサーバーカードが提供されます。

クイックスタート（リモート MCP）

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

認証

次の 3 つの方法に対応しています。クライアントがサポートしている方法を使用してください。

方法	形式
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、ログ、シェルの履歴に露出する可能性があります。

検索・ニュース用のオプション UI

リモート 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 設定はリモート 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 によるリモート MCP 用の Agent Plugins plugin.json + mcp.json（ポータブル）と、.cursor-plugin/plugin.json（Cursor Marketplace のメタデータ／ロゴ）が含まれています。cursor.directory または Cursor Marketplace から送信またはインストールし、プロンプトが表示されたらサインインしてください。

ローカルでテストする場合は、プラグインファイル（plugin.json、.cursor-plugin/、mcp.json、assets/）を ~/.cursor/plugins/local/search1api にコピーしてください。このディレクトリの外からシンボリックリンクを作成しないでください。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"
    }
  }
}

エージェントスキル

エージェントスキルは 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 に渡してください。

Parameter	Required	Default	Description
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 が追加されます。

Parameter	Required	Default	Description
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 からコンテンツを抽出します。

Parameter	Required	Description
url	はい	クロールする URL

sitemap

URL に関連するすべてのリンクを取得します。

Parameter	Required	Description
url	はい	サイトマップを取得する URL

trending

人気プラットフォームのトレンドトピックを取得します。

Parameter	Required	Default	Description
search_service	はい	-	github、hackernews
max_results	いいえ	10	項目数

ask

エージェント型検索：必要な情報を自然言語で説明すると、Search1API が最大5つの検索エンジンと期間を選択し、関連性の低い結果を除外して、関連性順に並べた引用可能な結果を最大10件返します。結果には、使用したキーワード、検索エンジン、期間を示すintentと、ほかの検索エンジンが正常に完了する一方で失敗した検索エンジンを示すerrorsも含まれます。リクエストが正常に完了するごとに5クレジットを消費します。検索エンジンがすでに決まっている場合は、searchを使用してください。

パラメーター	必須	説明
query	はい	自然言語でのリクエスト。最大500文字

send_feedback

誤った結果、空の結果、不完全な結果、解決できなかったエラー、動作と一致しないドキュメント、不足している機能について、Search1API チームに報告します。無料で、クレジットは消費しません。サーバーに Search1API の認証情報が設定されている場合、報告はそのアカウントに紐付けられ、チームが折り返し連絡できます。認証情報や個人データは含めないでください。

パラメーター	必須	説明
message	はい	問題または不足している内容。最大4000文字
intent	いいえ	達成しようとしていたこと
category	いいえ	bug、feature_request、docs、other
request_id	いいえ	問題が発生した呼び出しのリクエスト ID
model	いいえ	使用しているモデル名

バージョン履歴

• v0.7.0：エージェント型検索用の新しいaskツールを追加。searchにbingcn、yandex、grokipediaエンジンとpageパラメーターを追加。searchとnewsでtime_range: "week"を使用できるようになり、GitHub と Hacker News のpublished_dateおよびフィールドを結果の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 issuer を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 セキュリティスキーム、安全性アノテーション、Official 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 をご覧ください。