核心用法
baidu-search 是专为中文搜索场景设计的智能检索技能，采用「API优先、浏览器兜底」的双模架构。用户配置 BAIDU_API_KEY 后即可调用百度千帆AI搜索API，享受结构化数据返回与高级过滤能力；当配额耗尽或网络异常时，自动降级至浏览器模式，确保服务连续性。
API模式支持丰富的参数控制：时间过滤（周/月/半年/年）、安全搜索、站点白名单/黑名单、资源类型筛选（网页/视频等），并可通过 search_filter 实现精准的站点匹配。返回结果结构化程度高，便于下游解析。浏览器模式则作为应急方案，直接操作百度搜索页面，兼容传统网页抓取流程。
显著优点
1. 中文搜索权威性强：依托百度搜索生态，对中文内容、国内站点的覆盖度和时效性优于国际搜索引擎
2. 双模可靠性设计：API配额耗尽不中断服务，自动化降级策略保障业务连续性
3. 企业级过滤能力：支持站点级黑白名单、时间窗口、内容安全等多维度筛选
4. 轻量集成成本低：单环境变量配置，Python脚本封装降低接入门槛
潜在局限
- 配额成本约束：免费额度有限，高频调用需付费，成本敏感场景需规划用量
- 生态依赖风险：深度绑定百度体系，国际站点、英文长尾内容覆盖相对薄弱
- 浏览器模式脆弱性：依赖页面DOM结构，百度前端改版可能导致解析失效
- 隐私合规考量：搜索行为需经百度服务器，敏感关键词存在审核与数据留存风险
适合人群
- 中文内容运营者：新闻聚合、舆情监测、行业资讯采集
- 企业知识库建设：需整合公开网络信息补充内部文档
- AI Agent开发者：为LLM提供实时中文互联网检索能力增强
- 本地化优先团队：服务中国大陆用户，追求搜索结果地域相关性
常规风险
- API密钥泄露导致配额被盗刷（需妥善保管
BAIDU_API_KEY） - 过度依赖单一路由，建议对关键业务配置多搜索引擎 failover
- 时间过滤、安全搜索等参数组合不当可能导致结果集为空或过度收敛