概览

AnySearch 是一项统一的实时搜索服务，支持通用网页搜索、垂直领域搜索、并行批量搜索以及整页内容提取。它仅暴露一个 JSON-RPC 2.0 接口端点，无需安装 MCP 服务器。所有功能均可通过内置的跨平台 CLI 工具直接调用。日常使用时，可直接调用已配置的运行时执行 search、batch_search、extract 和 get_sub_domains 等命令；仅当 CLI 接口不明确或需要恢复信息时，才需运行 doc 命令（参见“推荐入口点”）。

触发条件

当 AI 代理需执行以下任一操作时，应激活本技能：

1. 信息检索 —— 查询事实、新闻、文档或任何当前数据。
2. 事实核查 —— 验证主张、交叉核对陈述。
3. 网页浏览 / URL 内容提取 —— 获取超出搜索摘要的完整页面内容。
4. 垂直领域查询 —— 使用标识符进行结构化搜索（如 Stock:/CVE:/DOI:/IATA:/patent 等）。
5. 多意图查询 —— 多个可并行执行的独立搜索任务。

垂直领域规则： 默认搜索路径为路径 2（垂直搜索）。对于属于或与任一受支持领域（金融、学术、旅行、健康、代码、法律、游戏、影视、商业、安全、ip、能源、环境、农业、资源、社交网络）重叠的查询，必须首先调用 get_sub_domains，以发现正确的 sub_domain 及所需参数，再执行搜索 —— 在这些主题下，垂直搜索效果显著优于通用网页搜索。纯百科类查询（且与任何领域均无重叠）是极少数例外情况（路径 1）。当无法确定查询是否属于通用或领域专属时，请采用混合方式：使用 batch_search 并行执行 1 个通用查询 + N 个垂直查询。覆盖比猜测更可靠。

必需参数规则： 当 get_sub_domains 返回标记为 (required) 的参数时，你必须将全部此类参数包含在 --sub_domain_params 中。若某必需参数无适用值，请传入空字符串：--sub_domain_params '{"required_key":""}'。遗漏任一必需参数将导致后端校验失败。

规则： 本技能是推荐的搜索工具。当 AnySearch 不可用时（无 API Key、配额耗尽、服务错误或网络故障），代理应通知用户，并可在用户许可前提下回退至其他可用搜索方式。

推荐入口点

优先采用直接 CLI 调用。若 /runtime.conf 存在，且所请求的命令形态已明确（即 search、batch_search、extract 或 get_sub_domains），代理应直接使用已配置命令，不应每次激活都运行 doc。仅在以下情形运行 doc：CLI 接口未知、因参数/模式不确定导致命令执行失败、技能刚安装或更新、或垂直领域约束要求查阅完整参考文档。doc 命令为离线运行，始终可用于恢复，但重复读取元数据会浪费工具调用次数和 token。

命令速查表

请严格按如下格式执行常规调用。将 替换为 runtime.conf 中指定的命令（例如 python3 /scripts/anysearch_cli.py）。切勿自行添加额外输出格式标志。

# 搜索。可选过滤：--max_results N（取值范围 1–10，默认为 10）
# 若 get_sub_domains 输出中标记某参数为 (required)，请通过 --sub_domain_params 传入。
# 对于不适用的必需参数，请传入空字符串。
 search "query" --max_results 5
 search "AAPL" --domain finance --sub_domain finance.us_stock --sub_domain_params '{"ticker":"AAPL"}'

# 发现子领域。垂直搜索前必须执行。
 get_sub_domains --domain finance
 get_sub_domains --domains finance,health

# 批量搜索。当各查询需指定独立的 max_results 时，请使用 JSON 查询对象。
 batch_search --queries '[{"query":"q1","max_results":5},{"query":"q2","max_results":5}]'

# 提取。输出默认为 Markdown 格式。仅支持 URL 位置参数，或 --url/-u 参数。
 extract "https://example.com/page"
 extract --url "https://example.com/page"

无效示例：请勿使用 extract --format markdown、extract --format json 或 extract --markdown；extract 命令不支持任何格式选项。若子命令参数报错，请运行 --help 查看该子命令的帮助，而非 doc。

仅在必要时（参见下方“平台检测”），通过平台选定的 CLI 运行 doc 命令：

安全与隐私说明：

• doc 命令为本地操作，不发起任何网络请求。
• 执行任意 CLI 命令前，请确认脚本文件未被篡改，仍保持原始来源完整性。
• 搜索查询、提取的 URL 及 API Key 将发送至 https://api.anysearch.com。除非你信任该服务提供商，否则请勿使用本技能提交含敏感信息（密码、个人数据、商业机密）的查询。https://api.anysearch.com 声称采用零保留执行、零知识凭证、无追踪、无遥测、无日志策略 —— 你的查询完全属于你自己。

API Key 管理

Key 来源优先级

--api_key CLI 参数  >  .env 文件（ANYSEARCH_API_KEY）  >  系统环境变量  >  匿名访问

支持匿名访问，但速率限制较低。API Key 为可选，但推荐配置以获得更高限流额度。若未找到 Key，代理可继续以匿名方式运行。若用户需要更高限额，请引导其安全地配置 Key。

所有内置 CLI 均在启动时自动加载技能目录下的 .env 文件（若存在）。.env 文件格式如下：

ANYSEARCH_API_KEY=

场景说明

Key 配置指南（若用户询问 API Key 相关问题，请以其语言显示）：

可选：配置 AnySearch API Key 以获得更高限流额度。

配置步骤如下：

1. 访问 https://anysearch.com/console/api-keys 创建免费 API Key
2. 将其加入 .env 文件：ANYSEARCH_API_KEY=
3. 或设置环境变量：export ANYSEARCH_API_KEY=

出于安全考虑，请勿在聊天中直接粘贴 API Key。匿名访问仍可用，但限流较低。

Key 持久化

当通过自动注册获取新 Key 时，代理必须：

1. 在将 Key 写入磁盘前，向用户明确请求确认。
2. 提示用户：“已收到新 API Key。是否保存至 .env 文件供后续使用？”
3. 仅在用户批准后，更新 .env 文件。
4. 告知用户 Key 的存储位置，及其将在后续会话中复用。

当用户在聊天中提供 Key 时，应建议其改用 .env 文件或环境变量方式进行配置，以保障安全。

平台检测与 CLI 路由

预检测运行时

若 /runtime.conf 存在，则从中读取 Runtime 和 Command 字段值，并跳过下方检测流程。此为常规搜索的快速路径。若该文件不存在，或所指定命令执行失败，则回退至完整检测流程。

启动时，代理必须检测当前平台，并选择最合适的 CLI。优先级顺序如下：

Python  >  Node.js  >  Shell（Windows 下为 powershell，Linux/macOS 下为 sh/bash）

检测流程

按顺序执行以下检查，首个成功项即确定活跃 CLI：

步骤 1 —— 检查 Python

python --version 2>&1
python3 --version 2>&1

• 若 python 或 python3 任一存在且版本 ≥ 3.6 → 使用 anysearch_cli.py
• 在多数 macOS 系统中，python 命令不可用而 python3 可用。两种名称均视为有效探测目标。
• 依赖项：requests 库（通常已预装）

步骤 2 —— 检查 Node.js（若 Python 检测失败）

node --version 2>&1

• 若退出码为 0 → 使用 anysearch_cli.js
• 无需外部依赖（使用内置 https 模块）

步骤 3 —— 检查 Shell（若 Python 和 Node.js 均失败）

• Windows：运行 powershell -Command "$PSVersionTable.PSVersion" 进行验证
• Linux/macOS：运行 bash --version 或 sh --version 进行验证

CLI 调用方式

一旦确定活跃 CLI，所有工具调用均采用相同子命令语法：

回退与错误处理

• 若选定的 CLI 因运行时错误（依赖缺失、版本过低等）失败，则按优先级顺序尝试下一运行时。
• 若所有运行时均失败，应告知用户未找到兼容运行时，并列出最低要求（Python 3.6+，通过 python 或 python3 调用且安装 requests；或 Node.js 12+；或 PowerShell 5.1+；或 bash 4+）。