AnySearch MCP Server

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

功能特性

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

API 密钥配置

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

注册获取 API 密钥（推荐）

代理可以通过一次调用为用户注册并获取 API 密钥——无需验证码，无需手动注册。请向用户索要一个真实邮箱地址：它将作为账户用户名，随机生成的密码会发送到该邮箱。

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

成功响应（code: 0）返回账户信息和一次性明文 API 密钥：

{
  "code": 0,
  "message": "success",
  "data": {
    "username": "you@example.com",
    "email": "you@example.com",
    "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"
    }
  }
}

成功后代理必须：

1. 将 data.api_key.key 放入 MCP 服务器配置，作为 Authorization: Bearer 的值（和/或设置 ANYSEARCH_API_KEY）——该密钥仅显示一次（之后也可以从控制台获取）。
2. 告知用户其用户名（= 邮箱）、login_url，以及随机密码已发送至该邮箱。
3. 向用户转达此提示：验证邮件已发送至您的收件箱。如果几分钟内未收到，请检查垃圾邮件或广告邮件文件夹。您可能需要将其标记为"非垃圾邮件"，以确保后续邮件正常送达。

错误处理（出错时始终返回 code: -1；根据 message 字符串分支处理）：

| message | 处理方式 | | --- | --- | | Invalid email address. | 请用户重新输入邮箱 | | email_already_registered | 邮箱已被注册——告知用户在 login_url 登录；不要重试 | | 包含 Rate limited | 从消息中读取重试秒数（例如 "Rate limited, retry after 300 seconds."），等待后重试 | | 以 Key creation failed. 开头 | 账户已创建但密钥创建失败——从消息中提取邮箱和 URL（"Key creation failed. Your account was created; sign in at ."），告知用户前往该处登录并手动创建密钥 | | 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=） | | 4 | 匿名访问（速率限制较低） |

密钥行为

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

MCP 传输方式

AnySearch MCP 服务器原生支持 Streamable HTTP 传输（MCP 规范 2025-03-26）。SSE 和 stdio 客户端可通过代理连接。

| 传输方式 | 原生支持？ | 最适合 | | --- | --- | --- | | Streamable HTTP | 是 | OpenCode、Claude Desktop（2025.6+）、基于 Web 的客户端 | | SSE | 通过代理 | Cursor、Windsurf | | stdio | 通过代理 | Claude Desktop（旧版）、VS Code Copilot、Cline |

安装

Streamable HTTP（推荐——无需代理）

对于 age…