Search1API

Search1API MCP Server

中文文档

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

認証

• OAuth対応クライアントはRemote MCP URLに直接接続し、ブラウザでサインインしてアクセスを承認できます。
• 既存の統合は、Search1APIダッシュボードのAPIキーを引き続き使用できます。

クイックスタート（Remote 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

OAuthまたは認証ヘッダーを推奨します。クエリパラメータの認証情報は、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プラグインとしてインストール（推奨）：このリポジトリには、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"
      }
    }
  }
}

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	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.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