import { env } from "../envs.js"; // ============================================ // HTML 界面 - HTML UI // ============================================ export function getSearchHtml() { const TOKEN_ENABLED = !!env.TOKEN; const DEFAULT_ENGINES = env.DEFAULT_ENGINES || []; const handlerEngineDefaultChecked = (engine) => DEFAULT_ENGINES.includes(engine) ? "checked" : ""; return ` Cloudflare Search - 多引擎聚合搜索服务
🔍

Cloudflare Search

基于 Cloudflare Workers 的多引擎聚合搜索服务。并行搜索 DuckDuckGo、Bing 等搜索引擎,快速获取更全面的搜索结果。

如果这个项目对你有帮助，可以 请作者喝杯咖啡 ☕️

⚙️ 服务配置状态

访问鉴权 ${TOKEN_ENABLED ? "✓ 已启用" : "○ 未启用 (公开访问)"}
搜索引擎 (DuckDuckGo/Bing) ✓ 可用
${ !TOKEN_ENABLED ? `

💡 建议:为防止服务被滥用,建议在 Cloudflare Dashboard 的 Worker 设置中添加环境变量 TOKEN 启用访问鉴权。

` : "" }

🔍 开始搜索

📖 如何使用 API

除了网页界面,您还可以通过 HTTP 请求直接调用搜索 API。支持 GET 和 POST 两种方式。

GET 请求示例
适合快速测试
POST 请求示例
适合程序调用
${ TOKEN_ENABLED ? `
🔒 鉴权已启用

当前服务已启用访问鉴权,请在请求时添加 token 参数或 Authorization 头。
示例: ?token=YOUR_TOKEN 或 Authorization: Bearer YOUR_TOKEN

` : "" }

参数说明:

  • q / query - 搜索关键词 (必填)
  • engines - 指定搜索引擎,多个用逗号分隔 (可选)
    • ${ TOKEN_ENABLED ? '
  • token - 访问令牌 (必填)
    • ' : "" }

返回结果说明:

{
  "query": "cloudflare",              // 搜索关键词
  "number_of_results": 15,            // 结果总数
  "enabled_engines": ["duckduckgo", ...], // 启用的搜索引擎列表
  "unresponsive_engines": [],         // 无响应的搜索引擎列表
  "empty_engines": [],                // 响应成功但无结果的搜索引擎列表
  "engine_errors": {},                // 各搜索引擎错误信息
  "results": [
    {
      "title": "...",                 // 结果标题
      "description": "...",           // 结果描述
      "url": "...",                   // 结果链接
      "engine": "duckduckgo"          // 来源引擎
    }
  ]
}

🚀 支持的搜索引擎

DuckDuckGo
✓ 可用

注重隐私保护的搜索引擎,无需配置

Bing
⚠ 不稳定

微软的搜索引擎,目前结果质量不稳定,默认未启用

⚡ 快速开始

1

部署服务

已部署完成 ✓ 您现在看到的就是部署后的服务

2

配置环境变量 (可选)

在 Cloudflare Dashboard → Workers & Pages → 您的 Worker → 设置 → 变量 中添加:

    ${ !TOKEN_ENABLED ? '
  • TOKEN - 启用访问鉴权 (建议)
    • ' : "" }
3

开始使用

直接在上方搜索框输入关键词开始搜索,或通过 API 集成到您的应用

📚 更多配置说明请查看 GitHub README

🤖 MCP 集成

通过 MCP (Model Context Protocol) 让 AI 助手 (如 Claude) 直接调用你的搜索服务,获取实时搜索结果。

1

添加 MCP 服务器配置

编辑配置文件 (配置指南):

Claude Code: ~/.claude/config.json 或 ~/.claude.json

Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop (Windows): %APPDATA%\\Claude\\claude_desktop_config.json

2

重启应用

保存配置后重启 Claude Code 或 Claude Desktop。

3

验证安装

• 在 Claude Code 中运行 /mcp 命令,应该能看到 cloudflare-search 工具

• 或 使用 claude mcp list, 看到 cloudflare-search: ... - ✓ Connected 说明配置成功

💬 使用示例

用 cloudflare-search 搜索 "Cloudflare Workers 最佳实践"
用 cloudflare-search 搜索 "Next.js 14 新特性"

AI 会返回来自多个搜索引擎的聚合结果,包括标题、描述和链接。

📦 NPM 包: @yrobot/cf-search-mcp | 📚 MCP 文档: modelcontextprotocol.io

多引擎聚合
容错机制
SearXNG 兼容
全球加速
`; }