anysearch-ai/anysearch-mcp-server

Unified real-time search MCP server supporting general web search, vertical domain search, parallel batch search, and full-page URL content extraction.

AnySearch MCP Server

What it is – 1つの軽量HTTP MCP（Model‑Context‑Protocol）サーバーで、AIコーディングアシスタント（OpenCode、Claude Code、Cursor、VS Code、Cline、OpenAI Codex、Google Antigravity、DeepSeek Harness、Hermes Agent、Oh My Piなど）がリアルタイムでのウェブ検索、ドメイン固有の検索、バッチ検索、および完全なページコンテンツ抽出を実行できるようにします。

Why it matters – 現代のLLM駆動のエージェントは最新の情報を必要とします。AnySearch MCPは1つのエンドポイント（https://api.anysearch.com/mcp）を公開し、構造化されたツールコール（search、get_sub_domains、batch_search、extract）を返します。サーバーはオプションのAPIキー（高いレートリミット）または匿名（低いリミット）で動作し、デモや本番環境で即座に利用可能になります。

コア機能

機能	実行可能な操作
一般ウェブ検索	自然言語のクエリを送信し、最大10件の結果を取得できます。
垂直ドメイン検索	金融、学術、セキュリティ、法務、コードなど、構造化されたデータを検索できます。まず `get_sub_domains` を呼び出して許可されたサブドメインとそのパラメータスキーマを確認します。
並列バッチ検索	1〜5件の独立した検索を1回のリクエストで実行できます。失敗は個別に処理されます。
URLコンテンツ抽出	完全なHTMLページを取得し、Markdown形式（最大50 k文字）で返します。
匿名アクセス	APIキーは不要ですが、より厳格なレートリミットが適用されます。

APIキーの取得（オプション）

ワンクリック登録 – 実在かつ到達可能なメールアドレスを含めて https://api.anysearch.com/v1/auth/email/register にPOSTします。応答には1回限りのプレーンテキストキーが含まれます。
ダッシュボード – 代わりに https://anysearch.com/console/api-keys でキーを作成できます。
キーの優先順位 – CLIフラグ > ANYSEARCH_API_KEY 環境変数 > .env ファイル > 匿名。

ヒント: キーは環境変数やシークレットマネージャーに保管してください。ソースコードにコミットしないでください。

接続方法（MCPクライアントの例）

すべてのクライアントは同じリモートエンドポイントを使用し、2つのヘッダーを送信します：

Authorization: Bearer <YOUR_KEY>   # 匿名の場合は省略
X-Anysearch-Client: mcp/1.0.0

以下は最も一般的なエージェント用の最小限の設定スニペットです。

OpenCode（グローバル）

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "anysearch": {
      "type": "remote",
      "url": "https://api.anysearch.com/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

opencode mcp list を実行して確認します。

Claude Code（ユーザー単位）

claude mcp add --transport http anysearch https://api.anysearch.com/mcp \
  --scope user \
  --header 'Authorization: Bearer ${ANYSEARCH_API_KEY}' \
  --header 'X-Anysearch-Client: mcp/1.0.0'

プロジェクトレベルの設定の場合は、同じフィールドを持つ .mcp.json を作成します。

Cursor（プロジェクト）

{
  "mcpServers": {
    "anysearch": {
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

カスタマイズ > MCPs を確認してください。

VS Code（セキュアプロンプト）

{
  "inputs": [{
    "type": "promptString",
    "id": "anysearch-api-key",
    "description": "AnySearch API key",
    "password": true
  }],
  "servers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:anysearch-api-key}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

匿名利用の場合は Authorization 行を削除してください。

(READMEにはCline、OpenAI Codex、Google Antigravity、DeepSeek Harness、Hermes Agent、OMP用の類似スニペットが含まれており、すべて同じヘッダー形式に従います。)

ツール契約（サーバーが期待する入出力）

`search`

{
  "query": "string",               // 必須、単一の意図
  "domain": "finance"?,            // オプションの垂直ドメイン
  "sub_domain": "finance.us_stock"?,
  "sub_domain_params": {…}?,        // get_sub_domainsのスキーマと一致する必要あり
  "max_results": 10                 // 1〜10、デフォルトは10
}

`get_sub_domains`

{ "domain": "finance" }   // または "domains": ["finance","academic"]

返されるのはMarkdownテーブル sub_domain | description | params です。

`batch_search`

{ "queries": [ {…search‑object…}, {…} ] }

最大5件のクエリ。各クエリは search スキーマに従います。

`extract`

{ "url": "https://example.com" }

ページコンテンツをMarkdown形式で返します（最大50 k文字）。

レートリミットとエラー処理（READMEに記載の通り）

情況	推奨される対応
登録時の無効なメール	ユーザーに有効なアドレスを再入力するよう促す。
`409` / `email_already_registered`	提供された `login_url` でサインインするようユーザーに通知。再試行しない。
`429`（レート制限）	`Retry‑After` ヘッダーまたはメッセージを尊重。必要に応じて匿名モードにフォールバック。
`Key creation failed…`	メッセージからメールとURLを抽出し、ユーザーに手動でキーを作成するよう依頼。
`500` 内部エラー	後で再試行するか、匿名アクセスに切り替える。

いつ使うべきか

エージェント駆動のリサーチ – 新鮮なウェブデータが必要なLLMは、IDEから直接 search や extract を呼び出せます。
ドメイン固有のワークフロー – 金融アナリスト、法務研究者、開発者はまず get_sub_domains を呼び出して、自分のドメインに適した正確なスキーマを確認できます。
バッチ処理 – batch_search を使って複数の独立したクエリを並列実行し、ラウンドトリップを削減できます。
デモまたはプロトタイプ – APIキーは不要。クライアントをエンドポイントに接続するだけです。

制限事項

匿名モードではより厳格なレートリミットが適用されます（正確な数値はアカウントごとに異なります）。
extract はHTMLページでのみ動作し、50 k文字で切り捨てられます。
サーバーはモデルをホスティングしていません。純粋な検索ツール提供者です。
エラーはHTTPステータス、code、または message フィールドから解釈する必要があります。一貫したエラーオブジェクトは存在しません。

クイックスタートチェックリスト

（オプション）ワンクリックメールフローでAPIキーを登録。
環境変数に ANYSEARCH_API_KEY を設定するか、クライアント固有の設定ファイルに追加。
お気に入りのIDE/エージェント用のMCPサーバー設定を追加（上記のスニペットを参照）。
クライアントの mcp list / mcp test コマンドで接続を確認。
LLM駆動のツールから search、get_sub_domains、batch_search、extract を呼び出す。

結論 – AnySearch MCP Serverは、LLMエージェントがオープンウェブや多数の垂直データソースに即座に構造化されたアクセスを可能にする、即時利用可能な標準準拠のブリッジです。シンプルなキー管理と広範なIDEサポートを備えています。