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

注意事项

⚠️ 重要提示

1. 反机器人检测：内置的反机器人检测功能可防止大部分常见的检测方法，但为了提高安全性和成功率，建议配合使用代理服务器和动态用户代理，且部分网站可能仍能通过其他方式检测到自动化工具。
2. 性能：浏览器实例采用池化机制并可重复利用，空闲浏览器会自动回收，资源限制功能可防止系统过载。

📄 许可证

本项目采用 MIT 许可证。