AnySearch

AnySearch MCP サーバー

English | 简体中文

汎用ウェブ検索、縦断型ドメイン検索、並列バッチ検索、URL の全ページコンテンツ抽出をサポートする、統合リアルタイム検索 MCP サーバーです。

機能

• 汎用ウェブ検索 — 自由形式の自然言語クエリ
• 縦断型ドメイン検索 — 金融、学術、セキュリティ、法務、コードなどにわたる構造化クエリ
• 並列バッチ検索 — 複数の独立したクエリを 1 回の呼び出しで実行
• URL コンテンツ抽出 — ページの全コンテンツを取得し Markdown として抽出
• 匿名アクセス — API キーなしで動作します（レート制限は低くなります）

API キーの設定

API キーは任意ですが推奨されます。キーがなくても、すべての機能は匿名アクセスとしてレート制限が低い状態で動作します。

API キーの登録（推奨）

エージェントは、1 回の呼び出しでユーザーを登録し API キーを取得できます。確認コードも手動サインアップも不要です。ユーザーに実際のメールアドレスを尋ねてください。それがアカウントのユーザー名になります。

curl -s -X POST "https://api.anysearch.com/v1/auth/email/register" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

成功レスポンス（code: 0）は、アカウント情報と 1 回限りの平文 API キーを返します。

{
  "code": 0,
  "message": "success",
  "data": {
    "username": "[email protected]",
    "email": "[email protected]",
    "login_url": "https://www.anysearch.com/login",
    "api_key": {
      "id": "key_xxxxxxxx",
      "key": "as_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "key_prefix": "as_sk_xxxxxx...",
      "name": "default",
      "rate_limit": 100,
      "quota_limit": 0,
      "expires_at": null,
      "created_at": "2026-06-23T10:23:00Z"
    }
  }
}

rate_limit などのクォータフィールドはアカウント固有のレスポンス値です。この例を固定のプランとして扱わないでください。

成功時、エージェントは必ず以下を行う必要があります。

1. data.api_key.key を MCP サーバー設定に Authorization: Bearer <key> の値として設定する（および/または ANYSEARCH_API_KEY を設定する）— このキーは 1 回しか表示されません（後からダッシュボードで取得することもできます）。
2. ユーザーにユーザー名（= メールアドレス）と login_url を伝えます。

エラーは HTTP ステータス、アプリケーションレベルの code、または message で表現されることがあります。すべてのエラーが code: -1 を使うと仮定しないでください。

status / code / message	対処方法
Invalid email address.	ユーザーにメールアドレスの再入力を求めます
HTTP 409 または email_already_registered	メールアドレスが使用済みです — ユーザーに login_url でサインインするよう伝えてください。再試行しないでください
code: 42901、rate_limited、または Rate limited を含む	Retry-After、レスポンスデータ、またはメッセージから再試行までの遅延を優先して取得してください。何も指定されていない場合は、繰り返しリクエストを停止し、後で再試行するか匿名アクセスを使用してください
Key creation failed. で始まる	アカウントは作成されたがキーの作成に失敗しました — メッセージからメールアドレスと URL を抽出し（"Key creation failed. Your account <email> was created; sign in at <url>."）、ユーザーにそこでサインインして手動でキーを作成するよう伝えてください
Internal server error.	後で再試行するか、匿名アクセスにフォールバックしてください

メールアドレスは実在し、受信可能である必要があります。

API キーの取得

別の方法として、https://anysearch.com/console/api-keys にアクセスして無料の API キーを作成できます。

キーの優先順位

優先順位	取得元
1（最高）	--api_key CLI フラグ / Authorization ヘッダー
2	環境変数 ANYSEARCH_API_KEY
3	.env ファイル（ANYSEARCH_API_KEY=<key>）
4	匿名アクセス（レート制限は低くなります）

キーの動作

シナリオ	動作
キーなし	匿名アクセスで続行します（レート制限は低くなります）
キーあり	Authorization: Bearer <key> ヘッダーで送信され、レート制限が高くなります
キーが枯渇し、自動登録されたキーが返された	エージェントはユーザーに確認を求め、その後新しいキーを永続化する必要があります
キーが枯渇し、新しいキーがない	ユーザーに通知し、新しい API キーを設定するよう提案します

MCP トランスポート

本番エンドポイントは以下です。

https://api.anysearch.com/mcp

これはネイティブで Streamable HTTP を使用します。現在の OpenCode、Claude Code、Cursor、VS Code、Cline、OpenAI Codex、Google Antigravity、DeepSeek Harness、Hermes Agent、および OMP のリリースは、これに直接接続できます。SSE や stdio プロキシは不要です。以下の設定は、各クライアントの現在の公式ドキュメントに従っています。

インストール

API キーは任意です。クライアントがカスタムヘッダー用の環境変数またはシークレットストレージについて文書化している場合は、例では推奨される認証済みセットアップを使用します。文書化していない場合は、例は匿名のままとし、認証を追加する方法をプライベートなユーザー設定でのみ説明します。他の場所で匿名アクセスを使用するには、Authorization エントリのみを削除し、X-Anysearch-Client は保持してください。

OpenCode

公式ドキュメント: MCP servers および configuration locations。

グローバル設定には ~/.config/opencode/opencode.json を、プロジェクトルートには opencode.json を使用します。Windows では、グローバルパスは %USERPROFILE%\.config\opencode\opencode.json です。

{
  "$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 は環境変数の置換に {env:NAME} を使用します。"oauth": false は、この API キー認証のサーバーにとって不要な OAuth ディスカバリフローを防ぎます。

保存後、opencode mcp list を実行し、anysearch が connected として表示されることを確認してください。

Claude Code

公式ドキュメント: Connect Claude Code to tools via MCP。

プライベートなユーザー全体のインストールには、次を実行します:

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'

user スコープはサーバーを ~/.claude.json に保存し、マシン上のすべてのプロジェクトで利用できるようにします。単一引用符は変数参照を保持するため、平文のキーは設定に書き込まれません。Claude Code を起動する前に ANYSEARCH_API_KEY を設定してください。匿名アクセスの場合は、Authorization の --header オプションを省略します。

共有可能なプロジェクト設定には、プロジェクトルートに .mcp.json を作成します:

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

Claude Code は .mcp.json 内の ${VAR} と ${VAR:-default} を展開します。これは url および headers の内部も含みます。Claude Code を起動する前に ANYSEARCH_API_KEY を設定してください。プロジェクトスコープのサーバーは、最初に対話形式で開く際に承認が必要です。

次のコマンドで接続を確認します:

claude mcp get anysearch
claude mcp list

Claude Code 内では、/mcp がサーバーのステータスと利用可能なツールを表示します。

Cursor

公式ドキュメント: Model Context Protocol。

プロジェクトには .cursor/mcp.json を、グローバルには ~/.cursor/mcp.json を使用します:

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

Cursor はリモート HTTP エンドポイントを自動的に認識し、url および headers 内で ${env:NAME} の補間をサポートします。

Customize > MCPs または Output > MCP Logs で接続を確認してください。Cursor CLI がインストールされている場合は、次も実行できます:

agent mcp list
agent mcp list-tools anysearch

VS Code

公式ドキュメント: Add and manage MCP servers および MCP configuration reference。

ユーザー全体のサーバーには MCP: Open User Configuration を実行するか、ワークスペースに .vscode/mcp.json を作成します。この例ではパスワード入力を使用しているため、キーは入力を求められて安全に保存され、コミットされません:

{
  "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 エントリと inputs 配列全体を削除します。

MCP: List Servers を実行し、anysearch を選択してから Start または Show Output を選び、接続を確認してください。${input:...} はローカルの VS Code では動作しますが、対話的な入力を必要とするサーバーは Agent Host に転送されないことに注意してください。Agent Host や他の Copilot ツールと共有する設定には、ワークスペースの .mcp.json またはユーザーの ~/.copilot/mcp-config.json を使用し、対話的な入力を避けてください。

Cline

公式ドキュメント: MCP。

Cline パネルで MCP Servers > Configure > Configure MCP Servers を開くか、Remote Servers タブからホスト型エンドポイントを追加します。明示的に streamableHttp タイプを指定してください。省略すると従来の SSE 動作にフォールバックします。

{
  "mcpServers": {
    "anysearch": {
      "type": "streamableHttp",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cline IDE は url、headers、env 内で ${env:VAR} をサポートしています。cline mcp を実行して CLI ウィザードを開くか、cline config mcp --json で設定を一覧表示できます。公式の Web ドキュメントにはまだ ~/.cline/mcp.json と記載されていますが、現在のソースではデフォルトで ~/.cline/data/settings/cline_mcp_settings.json が使用されます。ハードコードされたパスに頼るのではなく、IDE の Configure MCP Servers または CLI ウィザードを使って実際に有効なファイルを開いてください。

以下の 5 つのエントリは、2026-08-27 にファーストパーティの設定ドキュメントと照合して確認しました。これはドキュメント化されたクライアント互換性を示すものであり、ローカルでのエンドツーエンド接続の認定ではありません。

OpenAI Codex

公式ドキュメント: Model Context Protocol。

グローバルには ~/.codex/config.toml を、信頼されたプロジェクトでは .codex/config.toml を使用します。Codex CLI、IDE 拡張機能、デスクトップアプリはこの設定を共有します:

[mcp_servers.anysearch]
url = "https://api.anysearch.com/mcp"
bearer_token_env_var = "ANYSEARCH_API_KEY"
http_headers = { "X-Anysearch-Client" = "mcp/1.0.0" }

Codex を起動する前に ANYSEARCH_API_KEY を設定してください。匿名アクセスの場合は bearer_token_env_var を削除します。codex mcp list を実行するか、Codex TUI 内で /mcp を使用して、サーバーとそのツールが利用可能であることを確認してください。

Google Antigravity

公式ドキュメント: MCP servers in Antigravity。

グローバルには ~/.gemini/config/mcp_config.json を、ワークスペースでは .agents/mcp_config.json を使用します。リモートサーバーは serverUrl を使用する必要があり、従来の url および httpUrl キーはサポートされていません:

{
  "mcpServers": {
    "anysearch": {
      "serverUrl": "https://api.anysearch.com/mcp",
      "headers": {
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

Antigravity の公式ドキュメントでは現在、カスタムヘッダーの値をリテラルで記載していますが、リモートヘッダーでの環境変数展開についてはドキュメント化されていません。認証が必要な場合は、"Authorization": "Bearer YOUR_API_KEY" をプライベートなグローバルファイルにのみ追加し、決して .agents/mcp_config.json にコミットしないでください。IDE で MCP Servers > Manage MCP Servers を開くか、CLI で /mcp を実行して、ライブステータス、ログ、ツールを確認してください。

DeepSeek Harness

公式ソース: DeepSeek Harness および @deepseek-ai/dsh-mcp-client。

DeepSeek Harness は、単独の mcp.json ではなく、ファーストパーティの Cordis プラグインを通じて MCP を設定します。このパッチを ~/.dsh/profiles/web/cordis.patch.yml(または $DSH_HOME 配下の対応するプロファイル)にマージしてください:

- insert:
    - id: mcp-anysearch
      name: "@deepseek-ai/dsh-mcp-client"
      config:
        serverName: anysearch
        transport: streamable-http
        url: "https://api.anysearch.com/mcp"
        headers:
          Authorization: !!js '`Bearer ${process.env.ANYSEARCH_API_KEY}`'
          X-Anysearch-Client: "mcp/1.0.0"
        failOnStartupError: true

ANYSEARCH_API_KEY を設定し、npx @deepseek-ai/dsh --profile web --dump-config を実行して、npx @deepseek-ai/dsh web で起動する前にプロファイルに mcp-anysearch が含まれていることを確認してください。現在の MCP プラグインはツールのみを公開しており、MCP リソースとプロンプトはまだサポートされていません。DeepSeek Harness は開発者プレビューであるため、アップグレード時にはリンク先のプラグインドキュメントを再確認してください。

Hermes Agent

公式ドキュメント: MCP integration。

サーバーを $HERMES_HOME/config.yaml に追加し、ANYSEARCH_API_KEY を $HERMES_HOME/.env またはプロセス環境に保存します。macOS と Linux では $HERMES_HOME のデフォルトは ~/.hermes です。ネイティブ Windows インストーラーは現在のところ %LOCALAPPDATA%\hermes がデフォルトです:

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

hermes mcp test anysearch と hermes mcp list で確認してください。セッション中に設定を編集した後は、/reload-mcp を実行するか新しいセッションを開始してください。

OMP (Oh My Pi)

公式ドキュメント: MCP configuration。

プロジェクトでは .omp/mcp.json を、グローバルには ~/.omp/agent/mcp.json を使用します:

{
  "$schema": "https://raw.githubusercontent.com/can1357/oh-my-pi/main/packages/coding-agent/src/config/mcp-schema.json",
  "mcpServers": {
    "anysearch": {
      "type": "http",
      "url": "https://api.anysearch.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ANYSEARCH_API_KEY}",
        "X-Anysearch-Client": "mcp/1.0.0"
      }
    }
  }
}

OMP は設定値内の ${VAR} および ${VAR:-default} を展開します。ANYSEARCH_API_KEY を設定し、OMP 内で /mcp reload、/mcp test anysearch、/mcp list を実行してください。

クライアント早見表

クライアント	公式の接続方式	設定ファイルの場所	ダイレクト Streamable HTTP 対応?
OpenCode	リモート MCP 設定	~/.config/opencode/opencode.json またはプロジェクトの opencode.json	はい
Claude Code	リモート HTTP MCP	ユーザーの ~/.claude.json またはプロジェクトの .mcp.json	はい
Cursor	リモート MCP 設定	.cursor/mcp.json または ~/.cursor/mcp.json	はい
VS Code	HTTP MCP 設定	ローカルユーザー設定または .vscode/mcp.json、Agent Host は .mcp.json / ~/.copilot/mcp-config.json を使用	はい
Cline	リモート Streamable HTTP	Cline IDE または CLI ウィザードから有効な設定を開く	はい
OpenAI Codex	リモート MCP 設定	~/.codex/config.toml または信頼済みプロジェクトの .codex/config.toml	はい
Google Antigravity	serverUrl を使用するリモート MCP 設定	~/.gemini/config/mcp_config.json またはワークスペースの .agents/mcp_config.json	はい
DeepSeek Harness	ファーストパーティの MCP クライアントプラグイン	$DSH_HOME/profiles/<name>/cordis.patch.yml	はい
Hermes Agent	リモート HTTP MCP	$HERMES_HOME/config.yaml	はい
OMP (Oh My Pi)	HTTP MCP 設定	.omp/mcp.json または ~/.omp/agent/mcp.json	はい

利用可能なツール

search

検索クエリを実行します — 一般または垂直ドメイン。

パラメーター	型	必須	説明
query	string	はい	自然言語の検索クエリ。1 回の呼び出しにつき 1 つの意図
domain	string	いいえ	垂直ドメイン（例: finance、academic、security）。get_sub_domains の列挙値から指定する必要があります
sub_domain	string	いいえ	サブドメインのルーティングキー（例: finance.us_stock）。get_sub_domains の出力から指定する必要があります
sub_domain_params	object	いいえ	get_sub_domains の params 列にある構造化パラメーター。値を決して勝手に考案しないでください
max_results	integer	いいえ	1〜10、デフォルトは 10

get_sub_domains

垂直ドメインのディレクトリを照会します。ドメインを使用するすべての検索の前に必須 — 有効な sub_domains とそのパラメータースキーマを返します。

パラメーター	型	必須	説明
domain	string	いずれか	照会する単一のドメイン
domains	string[]	いずれか	最大 5 つのドメインを一括指定（推奨 — より広範囲をカバー）

Markdown テーブルを返します: sub_domain | description | params

batch_search

1〜5 件の独立した検索クエリを並列で実行します。1 件の失敗が他をブロックすることはありません。

パラメーター	型	必須	説明
queries	object[]	はい	1〜5 件のクエリオブジェクト。それぞれ search と同じフィールドを持ちます

extract

URL からページ全文を取得し、Markdown として返します。50,000 文字で切り捨てられます。HTML ページのみです。

パラメーター	型	必須	説明
url	string	はい	対象 URL（http:// または https://）