AnySearch Skill

面向 AI Agent 的统一实时搜索引擎 Skill。支持通用网页搜索、垂直领域搜索、并行批量搜索以及全页内容提取。

下载与安装

针对 AI Agent

如果你的 Agent 平台支持 Skill 市场/商店，请搜索 anysearch 并进行安装。否则，请手动下载并安装：

# 下载（指定到特定发布版本）
curl -L -o anysearch-skill.zip https://github.com/anysearch-ai/anysearch-skill/archive/refs/heads/main.zip
# 或: wget -O anysearch-skill.zip https://github.com/anysearch-ai/anysearch-skill/archive/refs/heads/main.zip

# 验证完整性（请替换为发布页面上的实际校验和）
# sha256sum anysearch-skill.zip

# 解压
unzip anysearch-skill.zip

# 移动到 Agent 的 skill 目录（以下为示例路径，请根据你的 Agent 进行调整）
# Claude Code:    mv anysearch-skill ~/.claude/skills/anysearch
# OpenCode:       mv anysearch-skill ~/.config/opencode/skills/anysearch
# Cursor/Windsurf: mv anysearch-skill /.skills/anysearch
# Generic:        mv anysearch-skill /anysearch
# Shared agents:  mv anysearch-skill ~/.agents/skills/anysearch

~/.agents/skills/ 是一个常用的共享安装位置，适用于多个 AI 工具读取同一 Skill 目录的情况，包括 Codex、Cursor 和 OpenClaw 个人 Agent Skill。

针对个人用户

1. 下载 zip 包：https://github.com/anysearch-ai/anysearch-skill/archive/refs/heads/main.zip
2. 解压到你的 Agent Skill 目录
3. 配置 API Key（见下文）
4. 运行入口测试以验证安装

API Key 配置

API Key 是可选的，但强烈建议配置。没有 Key 也可以通过匿名访问使用所有搜索功能，但会受到较低的速率限制和配额限制。

如何配置

复制示例环境变量文件并填入你的 Key：

cp .env.example .env
# 编辑 .env 并设置: ANYSEARCH_API_KEY=

或者直接设置环境变量：

export ANYSEARCH_API_KEY=   # Linux/macOS
set ANYSEARCH_API_KEY=       # Windows CMD
$env:ANYSEARCH_API_KEY=""    # Windows PowerShell

获取 API Key

访问 https://anysearch.com/console/api-keys 注册并创建免费的 API Key。

Key 优先级顺序：--api_key CLI 参数 > .env 文件 > 环境变量 > 匿名访问。

安装后验证

安装完成后，请探测平台并运行入口测试：

第 1 步：检测可用运行时 (Runtime)

按顺序运行这些检查，第一个成功的检查将确定活跃的 CLI：

# 检查 Python（推荐）
python --version   # 需要 >= 3.6，且需安装 `requests` 库
python3 --version  # 需要 >= 3.6，且需安装 `requests` 库
# 检查 Node.js（备选）
node --version     # 需要 >= 12，无外部依赖
# 检查 Shell（兜底）
# Windows: PowerShell 5.1+ / Linux/macOS: bash 4+

优先级：Python > Node.js > Shell

重要提示：不要假定 python 一定存在。在许多 macOS 系统上，正确的执行文件是 python3。请同时检查 python 和 python3；如果其中任何一个可用，则说明 Python 环境就绪。

第 2 步：运行入口测试（探测所有可用运行时）

使用每个可用的运行时运行 doc 命令来验证 Skill 是否正常工作，并观察哪个运行时运行没有报错或警告：

# Python
python /scripts/anysearch_cli.py doc

# Python 3 备选（macOS 常见）
python3 /scripts/anysearch_cli.py doc

# Node.js（如果可用）
node /scripts/anysearch_cli.js doc

# PowerShell (Windows)
powershell -ExecutionPolicy Bypass -File /scripts/anysearch_cli.ps1 doc

# Bash (Linux/macOS)
bash /scripts/anysearch_cli.sh doc

对于每个运行时，记录命令是否成功以及遇到的任何错误/警告。运行成功且输出最简洁的运行时，就是该环境推荐的运行时。

第 3 步：将推荐的运行时持久化到配置文件

根据入口测试结果，将推荐的运行时写入 /runtime.conf：

echo "Runtime: " > /runtime.conf
echo "Command: " >> /runtime.conf

以 Python 为例：

echo "Runtime: Python" > /runtime.conf
echo "Command: python /scripts/anysearch_cli.py" >> /runtime.conf

以 Python 3 为例：

echo "Runtime: Python" > /runtime.conf
echo "Command: python3 /scripts/anysearch_cli.py" >> /runtime.conf

以 Node.js 为例：

echo "Runtime: Node.js" > /runtime.conf
echo "Command: node /scripts/anysearch_cli.js" >> /runtime.conf

以 PowerShell 为例：

echo "Runtime: PowerShell" > /runtime.conf
echo "Command: powershell -ExecutionPolicy Bypass -File /scripts/anysearch_cli.ps1" >> /runtime.conf

以 Bash 为例：

echo "Runtime: Bash" > /runtime.conf
echo "Command: bash /scripts/anysearch_cli.sh" >> /runtime.conf

重要提示： 运行时首选项存储在 runtime.conf 中，而不是 SKILL.md 中。Agent 在加载 Skill 时会读取 runtime.conf 来确定活动的 CLI。如果该文件缺失或损坏，Agent 将无法继续。