Google Search

🚀 网络搜索 MCP 服务器

本 MCP 服务器具备 Google 搜索功能与网页内容查看功能，还集成了先进的反机器人检测技术，能为用户提供高效、安全的网络搜索体验。

🚀 快速开始

本服务器提供 Google 搜索功能和网页内容查看功能，集成了先进的反机器人检测技术，能有效防止常见的机器人检测。

✨ 主要特性

• 高级搜索：带有高级筛选功能的 Google 自定义搜索。
• 内容转换：支持网页内容查看与 Markdown 转换。
• 性能优化：具备速率限制和缓存功能，同时采用浏览器实例池化技术。
• 安全防护：使用 rebrowser - puppeteer 实现反机器人检测。

📦 安装指南

先决条件

• Bun 运行时 v1.0 或更高版本。
• Google API 凭据（API 密钥和搜索引擎 ID）。

安装步骤

# 安装依赖项
bun install

# 构建 TypeScript 文件
bun run build

📚 详细文档

配置

Cookie 设置

为了实现身份验证访问，请按照以下步骤操作：

1. 安装 Get cookies.txt LOCALLY 浏览器扩展。
2. 访问需要登录的网站并完成身份验证。
3. 使用浏览器扩展导出 cookies.txt 文件。
4. 将导出的 cookie 文件放置在 config/cookies.txt 目录中。

环境变量配置

请确保以下环境变量已正确设置：

• GOOGLE_API_KEY：您的 Google API 密钥。
• SEARCH_ENGINE_ID：您的目标搜索引擎 ID。

开发

# 以开发模式运行并启用实时更新
bun --watch run dev

# 执行测试
bun run test

# 运行代码检查
bun run lint

注意事项

⚠️ 重要提示

反机器人检测：

• 内置的反机器人检测功能可防止大部分常见的检测方法。
• 为了提高安全性和成功率，建议配合使用代理服务器和动态用户代理。
• 部分网站可能仍能通过其他方式检测到自动化工具。

⚠️ 重要提示

性能：

• 浏览器实例采用池化机制并可重复利用。
• 空闲浏览器会自动回收。
• 资源限制功能可防止系统过载。

📄 许可证

本项目采用 MIT 许可证。