项目地址：
https://github.com/web-agent-master/google-search?tab=readme-ov-file

中文说明：
https://github.com/web-agent-master/google-search/blob/main/README.zh-CN.md

核心亮点

• 本地化 SERP API 替代方案：无需依赖付费的搜索引擎结果 API 服务，完全在本地执行搜索操作
• 先进的反机器人检测绕过技术：智能浏览器指纹管理，模拟真实用户行为自动保存和恢复浏览器状态，减少验证频率无头/有头模式智能切换，遇到验证时自动转为有头模式让用户完成验证多种设备和区域设置随机化，降低被检测风险
• MCP 服务器集成：为 Claude 等 AI 助手提供实时搜索能力，无需额外 API 密钥
• 完全开源免费：所有代码开源，无使用限制，可自由定制和扩展

笔者已经在vscode的cline里安装成功，正常可以搜索

使用方法：

# 直接使用命令行

google-search "搜索关键词"

# 使用命令行选项

google-search --limit 5 --timeout 60000 --no-headless "搜索关键词"

# 或者使用 npx

npx google-search-cli "搜索关键词"

# 开发模式运行

pnpm dev "搜索关键词"

# 调试模式运行（显示浏览器界面）

pnpm debug "搜索关键词"

Google Search 工具文档

概述

基于 Playwright 的 Node.js 工具，支持绕过搜索引擎反爬机制，提供本地化 Google 搜索和结果提取功能。可作为 CLI 工具直接使用，或通过 MCP 服务器为 Claude 等 AI 助手提供实时搜索能力。

核心亮点

o 本地化 SERP API 替代方案
完全本地执行搜索，无需依赖付费 API 服务
o 先进反检测技术
智能浏览器指纹管理
自动保存/恢复浏览器状态
无头/有头模式智能切换
多设备区域随机化
o MCP 服务器集成
原生支持 Claude 等 AI 助手实时搜索
o 完全开源免费
MIT 许可，无使用限制

技术特性

项目结构

google-search/
├── src/
│   ├── index.ts       # 主入口
│   ├── search.ts      # 搜索实现
│   └── mcp-server.ts  # MCP 服务
├── dist/              # 编译输出
├── bin/               # 可执行文件
└── types.ts           # 类型定义

错误处理机制

o 浏览器启动失败检测
o 网络异常自动重试
o 结果解析异常日志
o 超时优雅退出机制

注意事项

使用规范
o 遵守 Google 服务条款
o 避免高频请求（防封禁）
o 部分地区需代理访问

状态文件安全
o 包含浏览器敏感数据
o 建议定期清理/更换
o 避免共享给第三方

MCP 要求
o Node.js ≥ v16
o Claude Desktop 最新版
o 配置使用绝对路径

与商业 API 对比

此文档采用模块化结构组织信息，通过清晰的层级划分和视觉元素（表格/代码块/图标）提升可读性。关键技术细节与使用场景分离，既方便快速上手，也便于深入定制开发。