Search1API
公式検索、クローリング、サイトマップのための単一API
Search1API MCPで何ができますか?
- ソースフィルタリング付きウェブ検索 —
searchでウェブ結果を取得し、サイトで絞り込んだり、ドメインを除外したり、過去1日・1か月・1年に限定したりできます。 - ニュースの発見と全文取得 —
newsを使って最近の記事を見つけ、必要に応じて上位のヒットをクロールして見出しだけでなく完全なコンテンツを取得できます。 - ページコンテンツの抽出 — 検索スニペットだけでは不十分な場合、任意のURLを
crawlに渡して完全な読み取り可能なテキストを取得できます。 - サイト構造の探索 — ドメインに対して
sitemapを呼び出し、関連するすべてのリンクを列挙してページを発見できます。 - トレンドトピックの監視 —
trendingでGitHubやHacker Newsの現在のホットな項目を照会できます。
ドキュメント
Search1API MCP サーバー
Search1API の公式 MCP サーバー — Web 検索、ニュース、ページ取得、サイトマップ検出、トレンドトピックを 1 つの API で提供します。
認証
- OAuth 対応クライアントは、リモート MCP URL に直接接続し、ブラウザでサインインしてアクセスを承認できます。
- 既存の統合では、Search1API ダッシュボード の API キーを引き続き使用できます。
- ツール検出(
initialize、tools/list)を含むすべての MCP リクエストには認証情報が必要です。未認証のリクエストは OAuth チャレンジを引き起こし、これによりクライアントはサインインをトリガーします。接続前の検査は、静的 サーバーカード によって提供されます。
クイックスタート(リモート MCP)
インストールは不要です。MCP クライアントをリモート URL で設定してください。クライアントが対応している場合は 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、ログ、シェル履歴に露出する可能性があります。
Claude Desktop
{
"mcpServers": {
"search1api": {
"url": "https://mcp.search1api.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_SEARCH1API_KEY"
}
}
}
}
Claude.ai(Web)
設定 > コネクタ > カスタムコネクタを追加:
https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY
Cursor
Cursor プラグインとしてインストール(推奨): このリポジトリには、リモート MCP と OAuth 用の 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"
}
}
}
}
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 を使用して Web を検索します。結果には引用可能な id/title/url 構造が含まれます。完全なページが必要な場合は、結果 URL を crawl に渡してください。
| パラメータ | 必須 | デフォルト | 説明 |
|---|---|---|---|
query | はい | - | 検索クエリ |
max_results | いいえ | 10 | 結果数 |
search_service | いいえ | google、bing、duckduckgo、yahoo、x、reddit、github、youtube、arxiv、wechat、bilibili、imdb、wikipedia | |
crawl_results | いいえ | 0 | 完全なコンテンツをクロールする上位結果の数。クロールが成功するたびに、基本 1 クレジットの検索リクエストに 1 クレジットが追加されます |
include_sites | いいえ | [] | 含めるサイト |
exclude_sites | いいえ | [] | 除外するサイト |
time_range | いいえ | - | day、month、year |
news
ニュース記事を検索します。
| パラメータ | 必須 | デフォルト | 説明 |
|---|---|---|---|
query | はい | - | 検索クエリ |
max_results | いいえ | 10 | 結果数 |
search_service | いいえ | bing | google、bing、duckduckgo、yahoo、hackernews |
crawl_results | いいえ | 0 | 完全なコンテンツをクロールする上位結果の数。クロールが成功するたびに、基本 1 クレジットのニュースリクエストに 1 クレジットが追加されます |
include_sites | いいえ | [] | 含めるサイト |
exclude_sites | いいえ | [] | 除外するサイト |
time_range | いいえ | - | day、month、year |
crawl
URL からコンテンツを抽出します。
| パラメータ | 必須 | 説明 |
|---|---|---|
url | はい | クロールする URL |
sitemap
URL から関連リンクをすべて取得します。
| パラメータ | 必須 | 説明 |
|---|---|---|
url | はい | サイトマップを取得する URL |
trending
人気プラットフォームからトレンドトピックを取得します。
| パラメータ | 必須 | デフォルト | 説明 |
|---|---|---|---|
search_service | はい | - | github、hackernews |
max_results | いいえ | 10 | アイテム数 |
バージョン履歴
- 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 レジストリメタデータが同期されました。
robots.txtがトランスポートホストで提供されます - v0.5.0: 自動プロトコルネゴシエーションによる MCP 2026-07-28 サポート。2025 世代の HTTP クライアント向けのステートレス互換性。リクエストレベルの認証
- v0.4.0: 構造化出力スキーマ、OAuth セキュリティスキーム、安全性アノテーション、公式 MCP レジストリメタデータ
- v0.3.1: リモート MCP の OAuth 2.1 サポート。廃止された推論ツールを削除
- v0.3.0: Streamable HTTP によるリモート 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