核心用法
free-web-search 是一款基于 Playwright 浏览器实现的联网搜索工具，核心调用方式如下：
# 基础搜索 web_search(query="关键词", max=10) # 抓取全文内容 web_search(query="Python 异步编程", full=3) # 过滤低质量域名 + 引擎自动切换 web_search(query="技术文档", filter=True, engine="auto")
关键特性：强制中文环境、支持 Bing/DuckDuckGo 双引擎、可选全文抓取、知乎等低质量域名过滤。
显著优点
1. 中文搜索深度优化：强制 Bing 返回中文结果，适合国内信息检索场景
2. 反爬机制完善：集成 stealth.js 反检测措施，支持 headless 服务器部署
3. 结果质量控制：v12 新增结果集中度检测，自动警告单一域名过度聚集
4. 全文抓取能力：可抓取前 5 条结果的完整网页正文，省去人工打开链接
5. 容错设计：3 次重试、30 秒超时、引擎自动降级，稳定性较高
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| 依赖 Playwright | 需额外安装 Chromium 浏览器，占用磁盘空间约 100MB+ |
| 全文抓取限制 | 强反爬站点（如知乎）自动跳过，部分动态页面抓取不全 |
| VPN 干扰 | Bing 国内版可能受 VPN 影响，需切换 DuckDuckGo |
| Query 质量敏感 | 效果 90% 依赖关键词质量，口语化查询易返回空结果 |
| 无 API 直接调用 | 通过 Python 脚本封装，非标准 REST API 形态 |
适合人群
- 需要实时信息的研究者：新闻追踪、政策解读、行业动态
- 中文内容创作者：快速查证资料、获取一手信源
- 自动化工作流开发者：需集成搜索能力的 RPA/Agent 系统
- 服务器部署场景：无图形界面环境的信息采集任务
常规风险
- 合规风险：全文抓取需遵守目标网站 robots.txt 及使用条款
- 频率限制：高频调用可能触发搜索引擎 IP 封禁
- 信息准确性：返回结果为搜索快照，需人工核实关键数据
- 隐私泄露：Playwright 可能携带浏览器指纹特征