Cloudflare Search
基于 Cloudflare Workers 的多引擎聚合搜索服务。并行搜索 Google、DuckDuckGo、Bing、Brave 四大引擎,快速获取更全面的搜索结果。
如果这个项目对你有帮助，可以 请作者喝杯咖啡 ☕️
⚙️ 服务配置状态
💡 提示: 配置 Google API 后可使用 Google 搜索引擎。在 Cloudflare Dashboard 的 Worker 设置中添加环境变量:
• GOOGLE_API_KEY - 获取 API Key
• GOOGLE_CX - 获取 CX ID
💡 建议:为防止服务被滥用,建议在 Cloudflare Dashboard 的 Worker 设置中添加环境变量 TOKEN 启用访问鉴权。
🔍 开始搜索
📖 如何使用 API
除了网页界面,您还可以通过 HTTP 请求直接调用搜索 API。支持 GET 和 POST 两种方式。
参数说明:
q/query- 搜索关键词 (必填)engines- 指定搜索引擎,多个用逗号分隔 (可选)
返回结果说明:
{
"query": "cloudflare", // 搜索关键词
"number_of_results": 15, // 结果总数
"enabled_engines": ["google", ...], // 启用的搜索引擎列表
"unresponsive_engines": [], // 无响应的搜索引擎列表
"results": [
{
"title": "...", // 结果标题
"description": "...", // 结果描述
"url": "...", // 结果链接
"engine": "google" // 来源引擎
}
]
}🚀 支持的搜索引擎
全球最大的搜索引擎,需要配置 Google Custom Search API
注重隐私保护的搜索引擎,无需配置
独立的搜索引擎,无需配置
微软的搜索引擎,目前结果质量不稳定,默认未启用
⚡ 快速开始
部署服务
已部署完成 ✓ 您现在看到的就是部署后的服务
配置环境变量 (可选)
在 Cloudflare Dashboard → Workers & Pages → 您的 Worker → 设置 → 变量 中添加:
GOOGLE_API_KEY和GOOGLE_CX- 启用 Google 搜索 (获取 API Key / 获取 CX)TOKEN- 启用访问鉴权 (建议)
开始使用
直接在上方搜索框输入关键词开始搜索,或通过 API 集成到您的应用
📚 更多配置说明请查看 GitHub README
🤖 MCP 集成
通过 MCP (Model Context Protocol) 让 AI 助手 (如 Claude) 直接调用你的搜索服务,获取实时搜索结果。
添加 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
重启应用
保存配置后重启 Claude Code 或 Claude Desktop。
验证安装
• 在 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