核心用法
free-web-search 是一款基于 Playwright 浏览器实现的联网搜索工具，深度适配中文环境，默认使用 Bing 国内版搜索引擎。核心调用方式通过 web_search 工具完成，必填参数为简洁精准的搜索关键词（query），可选参数包括返回条数（max）、全文抓取条数（full）、搜索引擎切换（engine）及低质量域名过滤（filter）。
该工具具备独特的意图识别与Query改写能力：当原始搜索词质量不佳时，系统会自动优化查询（如将"城市游玩"改写为"景点推荐"），但仅在质量差时触发，避免破坏原本有效的查询。支持按需抓取目标网页完整正文内容（最多前5条），并采用多层反检测措施（stealth.js）绕过常见反爬限制。
显著优点
1. 中文环境深度优化：强制返回中文搜索结果，针对国内网络环境专项调优
2. 智能质量保障：意图识别 + 请求节流（≥3秒间隔）+ 结果质量评分 + 限流退避机制
3. 全文抓取能力：可提取目标网页完整正文，满足深度信息获取需求
4. 多引擎容错：支持 Bing/DuckDuckGo/auto 模式切换，过滤失败自动回退
5. 服务器友好：纯 Headless 模式运行，无需图形界面，适合自动化部署
潜在缺点与局限性
- 全文抓取受限：知乎等强反爬网站自动跳过，部分网站存在抓取失败可能
- Query质量依赖：虽提供改写机制，但搜索效果仍高度依赖初始关键词质量
- 引擎局限性：DuckDuckGo 在国内网络环境下快速失败（10秒超时）
- 结果集中度风险：单一域名结果过多时需人工优化关键词
适合人群
- 需要稳定中文联网搜索能力的 AI 应用开发者
- 需获取实时资讯、新闻、技术文档全文内容的自动化工作流
- 在服务器环境部署搜索服务的运维人员
- 对搜索结果结构化处理有需求的数据分析师
常规风险
- 网络依赖：VPN 可能影响 Bing 国内版访问
- 反爬对抗：搜索引擎策略变化可能导致临时失效
- 内容合规：全文抓取内容需遵守目标网站使用条款
- 时效性边界：抓取内容存在短暂延迟，非真正意义上的实时数据