AnySearch

AnySearch MCP 服务

English | 简体中文

统一的实时搜索 MCP 服务，支持通用网页搜索、垂直领域搜索、并行批量搜索以及整页 URL 内容提取。

功能特性

• 通用网页搜索 — 开放式自然语言查询
• 垂直领域搜索 — 覆盖金融、学术、安全、法律、代码等领域的结构化查询
• 并行批量搜索 — 一次调用执行多个独立查询
• URL 内容提取 — 抓取并提取整页内容为 Markdown
• 匿名访问 — 无需 API key 即可使用（速率限制较低）

API Key 配置

API key 是可选的，但推荐配置。没有 key 时，所有功能仍可通过匿名访问使用，但速率限制较低。

注册 API Key（推荐）

Agent 可以在一次调用中完成用户注册并获取 API key — 无需验证码，无需手动注册。请向用户索取真实邮箱地址：它将作为账号用户名。

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

成功响应（code: 0）会返回账号信息以及一次性明文 API key：

{
  "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 等配额字段是账号特定的响应值；不要把示例当作固定套餐。

成功后 Agent 必须：

1. 将 data.api_key.key 作为 Authorization: Bearer <key> 的值放入 MCP 服务配置中（和/或设置 ANYSEARCH_API_KEY）— 它仅显示一次（之后也可从控制台重新获取）。
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. 开头	账号已创建但 key 创建失败 — 从消息中提取邮箱和 URL（"Key creation failed. Your account <email> was created; sign in at <url>."），告知用户前往该地址登录并手动创建 key
Internal server error.	稍后重试或回退到匿名访问

邮箱必须真实且可接收邮件。

获取 API Key

或者，访问 https://anysearch.com/console/api-keys 创建免费 API key。

Key 优先级

优先级	来源
1（最高）	--api_key 命令行参数 / Authorization 请求头
2	环境变量 ANYSEARCH_API_KEY
3	.env 文件（ANYSEARCH_API_KEY=<key>）
4	匿名访问（速率限制较低）

Key 行为

场景	行为
无 key	以匿名访问继续（速率限制较低）
有 key	通过 Authorization: Bearer <key> 请求头发送，速率限制更高
Key 已耗尽，返回自动注册的 key	Agent 应征求用户确认，然后持久化新 key
Key 已耗尽，无新 key	告知用户并建议配置新的 API key

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 key 是可选的。如果客户端文档中说明了自定义 header 的环境变量或密钥存储方式，示例会采用推荐的认证配置。如果没有说明，示例则保持匿名，并仅在私有用户配置中说明如何添加认证。若要在其他地方使用匿名访问，只需移除 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-key 认证的服务触发不必要的 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 scope 会将服务存储在 ~/.claude.json 中，并使其在此机器的所有项目中可用。单引号会保留变量引用，因此明文 key 不会被写入配置；请在启动 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 endpoint，并支持 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。此示例使用密码输入，因此 key 会被提示输入并安全存储，而不是被提交到代码库：

{
  "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 打开命令行向导，或运行 cline config mcp --json 列出配置。官方网页文档仍写作 ~/.cline/mcp.json，而当前源码默认使用 ~/.cline/data/settings/cline_mcp_settings.json；请使用 IDE 中的 Configure MCP Servers 或命令行向导打开实际生效的文件，而不要依赖硬编码路径。

以下五条配置已于 2026-08-27 对照第一方配置文档进行核对。这只能证明客户端兼容性有文档记载，并不代表完成了本地的端到端连接认证。

OpenAI Codex

官方文档：Model Context Protocol。

可在全局使用 ~/.codex/config.toml，或在受信任的项目中使用 .codex/config.toml。Codex 命令行、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

官方文档：Antigravity 中的 MCP 服务。

可在全局使用 ~/.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，或在命令行中运行 /mcp，以查看实时状态、日志和工具。

DeepSeek Harness

官方来源：DeepSeek Harness 和 @deepseek-ai/dsh-mcp-client。

DeepSeek Harness 通过其第一方 Cordis 插件配置 MCP，而非独立的 mcp.json。将此补丁合并到 ~/.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，确认配置文件包含 mcp-anysearch，之后再使用 npx @deepseek-ai/dsh web 启动它。当前的 MCP 插件仅提供工具；尚不支持 MCP 资源和提示词。DeepSeek Harness 是开发者预览版，升级时请重新查阅所链接的插件文档。

Hermes Agent

官方文档：MCP 集成。

将该服务添加到 $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 配置。

在项目中使用 .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	是	自然语言搜索查询。每次调用仅一个意图
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

查询垂直领域目录。任何使用 domain 的搜索前都必须先执行——返回有效的 sub_domains 及其参数模式。

参数	类型	必填	描述
domain	string	二选一	要查询的单个领域
domains	string[]	二选一	批量最多 5 个领域（推荐——覆盖面更广）

返回 Markdown 表：sub_domain | description | params

batch_search

并行执行 1–5 个独立搜索查询。单个失败不会阻塞其他查询。

参数	类型	必填	描述
queries	object[]	是	1–5 个查询对象，每个对象字段与 search 相同

extract

从 URL 获取完整页面内容并以 Markdown 返回。截断于 50,000 个字符。仅限 HTML 页面。

参数	类型	必填	描述
url	string	是	目标 URL（http:// 或 https://）