Search1API

公式

検索、クローリング、サイトマップのための単一API

GitHub

175

Search1API MCPで何ができますか？

ウェブ検索 — アシスタントに、Google、Bing、GitHub、arXiv、Reddit などの検索エンジンを対象に、サイトフィルターや期間を指定して search を実行するよう依頼します。
ニュース検索 — news を使って、Google、Bing、DuckDuckGo、Yahoo、Hacker News から最近の記事を探します。必要に応じて上位の検索結果をクロールできます。
ページとサイトマップの取得 — URL からコンテンツ全体を抽出するか、サイト内の関連リンクをすべて一覧表示します。
トレンドトピック — GitHub または Hacker News のトレンド項目を取得します。
エージェント型検索 — 必要なことを自然言語で説明すると、ask が検索エンジンを選び、ランキング付きの引用可能な結果を返します。
地域の場所検索 — Google マップで、住所、評価、営業時間、連絡先などの情報とともに店舗や場所を検索します。

ドキュメント

Search1API MCP Server

中文文档 | Deutsch

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

認証

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

クイックスタート（Remote MCP）

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

認証

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

方法	形式
OAuth 2.1	キーを指定せずに `https://mcp.search1api.com/mcp` に接続し、クライアントのサインイン手順に従います
Authorization Header	`Authorization: Bearer YOUR_SEARCH1API_KEY`
URL Query Parameter（レガシー）	`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 を使用して Web を検索します。結果には引用可能な 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

パラメーター	必須	デフォルト	説明
`search_service`	はい	-	github、hackernews
`max_results`	いいえ	10	項目数

ask

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

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

maps

Google Maps で地域のビジネスや場所を検索します。引用可能な結果として、最大 20 件の場所を含む 1 ページを返します。title は場所の名前、url は Google Maps のリンク、metadata には住所、電話番号、ウェブサイト、カテゴリ、評価、レビュー件数、座標、営業時間、営業状況、価格帯が利用可能な場合に含まれます。1 ページあたり 3 クレジットを消費します。ページに含まれる場所の件数は料金に影響しません。

パラメーター	必須	デフォルト	説明
`query`	はい	-	検索対象。例: "coffee shops"、"dentists in Austin"
`country`	いいえ	us	2 文字の国コード
`language`	いいえ	en	結果の言語。例: en、de、zh-CN
`location`	いいえ	-	地点を中心に検索するための `{ latitude, longitude, zoom? }`。2 ページ目以降では必須
`page`	いいえ	1	Google Maps のページ番号（1～6）。ページごとに個別の呼び出しが必要です
`max_results`	いいえ	20	ページから返す場所の件数（1～20）。件数を減らしても料金は下がりません

deepcrawl

ドキュメントセクションなど、1 つのサイトの多数のページを 1 回のタスクで読み取ります。サイトマップから URL を検出し、パスルールに一致するものを残して、引用可能な結果として最大 max_pages ページを返します。結果には title、url、および text 内のページの Markdown が含まれます。また、stats（検出、該当、スキップ、クロール済み、失敗）、読み取れなかった URL とその理由を示す failed、API の message、全ページの全文を含む JSON ファイルである result_url も含まれます。タスクを開始するたびに 20 クレジットを消費します。読み取るページ数は料金に影響しません。

このツールは最大約 45 秒間待機します。クロールがまだ実行中の場合は、task_id を含む status: "running" を返します。ページを取得するには、その task_id を指定して deepcrawl を再度呼び出してください。この呼び出しは無料で、新しいクロールは開始しません。ページのテキストは 1 ページあたり 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: 1つのタスクで同一サイトの最大50ページを読み取る新しい deepcrawl ツール（1タスクあたり20クレジット。実行中のタスクの確認は無料）
v0.10.0: Google Maps の場所を検索する新しい maps ツール（最大20件の場所を含む1ページあたり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 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: Web クローリング
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 を参照してください。