Search1API

公式

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

Search1API MCPで何ができますか?

  • ソースフィルタリング付きウェブ検索 — search でウェブ結果を取得し、サイトで絞り込んだり、ドメインを除外したり、過去1日・1か月・1年に限定したりできます。
  • ニュースの発見と全文取得 — news を使って最近の記事を見つけ、必要に応じて上位のヒットをクロールして見出しだけでなく完全なコンテンツを取得できます。
  • ページコンテンツの抽出 — 検索スニペットだけでは不十分な場合、任意のURLをcrawlに渡して完全な読み取り可能なテキストを取得できます。
  • サイト構造の探索 — ドメインに対してsitemapを呼び出し、関連するすべてのリンクを列挙してページを発見できます。
  • トレンドトピックの監視 — trendingでGitHubやHacker Newsの現在のホットな項目を照会できます。

ドキュメント

Search1API MCP サーバー

smithery badge Glama

中文文档

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いいえgooglegoogle、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いいえbinggoogle、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