核心用法
wechat-search-weread 是一款基于浏览器自动化（Browser Automation）的微信公众号文章搜索技能，通过微信读书「搜一搜」入口获取文章数据。用户配置 agent-browser 后，执行五步骤流程：启动浏览器 → 扫码登录 → 搜索+滚动加载 → CDP 拦截提取 URL → 清理标签页。搜索时自动滚动至「暂无更多内容」，最多可获取约500篇文章，通过 Python + WebSockets 连接 CDP 批量点击文章卡片，拦截 window.open 事件获取真实的 mp.weixin.qq.com 链接。
显著优点
- 数据权威性：直接来自微信官方生态，文章时效性、公众号认证状态准确
- 链接完整性：获取带
chksm和#rd参数的完整 URL，非截断短链 - 覆盖补偿：弥补 Exa 索引滞后、搜狗微信搜索下线后的空白
- 去重机制：基于
data-id唯一标识自动去重，支持持久化存储 - WSL 兼容：提供 CDP 端口转发方案，跨平台可用
潜在缺点与局限性
- 登录依赖：必须微信扫码登录，首次使用门槛高，且登录态需维持
- 流程脆弱：5 步骤环环相扣，误关 weread 标签页会导致滚动中断仅返回15篇
- QR 时效性：二维码快速过期，需单 terminal 一气呵成完成扫码流程
- 资源占用：长滚动需前台保持 600s timeout，多轮滚动消耗浏览器资源
- 反爬风险：高频搜索可能触发微信风控，未明确说明请求频率限制
- 无 API 兜底：官方 API 明确不支持该场景（返回 -2041），浏览器方案是唯一途径
适合人群
- 需要获取微信生态内最新公众号文章的研究者、舆情分析师
- 对文章原始链接完整性有要求的自动化工作流开发者
- Exa/搜狗方案无法满足时效性或覆盖率需求的用户
- 具备一定技术能力、可处理浏览器自动化复杂流程的进阶用户
常规风险
- 隐私安全：需登录个人微信账号，存在账号关联风险
- 数据持久化：
/tmp/urls.json等临时文件未及时清理可能泄露搜索历史 - 稳定性风险：微信读书页面改版可能导致 DOM 选择器失效、流程中断
- 合规边界：批量获取微信内容需遵守《微信公众平台服务协议》，存在平台政策风险