核心用法
wechat-search-weread 是一个基于浏览器自动化的微信公众号文章搜索方案，用于绕过微信读书官方API的-2041限制。完整流程包含5个关键步骤：启动浏览器、QR扫码登录、搜索滚动加载、CDP拦截提取URL、清理标签页。
显著优点
- 唯一可行路径：官方API已封锁公众号文章搜索，本方案是当前唯一能获取
mp.weixin.qq.com直链的技术路线 - 数据完整：返回标题、公众号、发布时间、简介、完整URL（含chksm校验参数）
- 批量能力：通过滚动可获取最多500篇文章
- 结构化输出：生成
/tmp/urls.json便于后续处理
潜在缺点与局限性
- 环境依赖重：需agent-browser、CDP端口转发（WSL）、Python+websockets
- 登录脆弱：QR码易过期，必须单terminal完成全流程
- 稳定性风险：标签页误关会导致流程中断；长滚动需前台保持
- 维护成本高：微信反爬策略变化可能导致方案失效
- 非实时：依赖微信读书的索引更新，非微信原生搜索
适合人群
- 需要原始文章链接进行存档、分析的研究者
- 对Exa/搜狗结果不满意的专业用户
- 具备技术背景、能处理CDP/浏览器自动化的开发者
常规风险
- 账号安全：扫码登录意味着微信读书账号暴露给自动化环境
- 反爬对抗：频繁操作可能触发微信风控
- 数据截断：URL必须从文件读取，控制台复制会丢失参数
- Session依赖：流程中任何环节中断都需重新登录