系统环境准备
部署Free-Search需要满足以下技术条件:Python 3.7+运行环境、Git版本控制工具、以及稳定的网络连接。Windows/Mac/Linux系统均可支持,但Linux无图形界面时需要xvfb虚拟帧缓冲区。
分步安装指南
- 获取源码:通过
git clone https://github.com/HanzlaJavaid/Free-Search.git
或下载ZIP包 - 安装依赖库:执行
pip install fastapi uvicorn pydantic playwright beautifulsoup4
- 配置浏览器驱动:运行
playwright install chromium
安装无头浏览器
服务启动方式
- Linux系统:需使用
xvfb-run python main.py
启动服务 - Windows/Mac:直接执行
python main.py
即可 - 默认端口:服务运行在11235端口,可通过浏览器访问
http://localhost:11235/search
验证
常见问题处理
若遇Playwright报错,需检查Chromium是否安装成功;网络连接问题可能导致搜索结果获取失败;建议将项目添加到系统PATH以便全局调用。
本答案来源于文章《Free-Search:免费获取实时谷歌搜索结果的API工具》