wxlivespy：一款可快速上手的微信视频号直播弹幕抓取工具实战指南

wxlivespy一款可快速上手的微信视频号直播弹幕抓取工具实战指南【免费下载链接】wxlivespy微信视频号直播间弹幕信息抓取工具项目地址: https://gitcode.com/gh_mirrors/wx/wxlivespy一次被手工记录逼疯的直播你有没有经历过这样的场景直播间里弹幕像流水一样滚过礼物特效闪个不停而你在后台只能盯着一个几乎不刷新的界面靠截图和复制粘贴去整理用户评论。一场两小时的直播下来数据零零散散、缺东少西更别提还要去回答谁来了几次谁打赏最多这类问题。wxlivespy 就是为这个场景而生的。它是一款基于 Electron 的微信视频号直播数据抓取工具能在你开播或观看直播时实时抓取直播间里的弹幕、礼物、进场、点赞等互动消息并把这些数据通过 HTTP 接口转发到你自己的服务端。换句话说它是你和结构化直播数据之间的那座桥。为什么要用它比起肉眼盯屏它强在哪传统的人工记录方式有三个绕不开的痛点慢弹幕是瞬时的等你看到、复制下来下一条已经过去了漏点赞、进场这类消息没有独立界面根本无从记录散数据进了 Excel 或聊天记录之后没法做实时统计、没法触发自动回复。wxlivespy 给出的解法是拦截-解析-转发三步走先拿到微信服务端返回给浏览器的原始数据再按消息类型解码成结构化的 JSON最后推给你指定的地址。你只需要写一个接收 HTTP POST 的接口就能拿到每一条弹幕的昵称、内容、时间、用户 ID以及每次送礼的礼物 ID、数量和微信币价值。3 分钟跑通第一版上手流程比想象中简单核心就四步。第一步拉取代码并安装依赖git clone https://gitcode.com/gh_mirrors/wx/wxlivespy cd wxlivespy npm install第二步准备 Chrome。工具依赖 Puppeteer 控制浏览器安装完成后它会在C:\Users\用户名\.cache\puppeteer\chrome下放好一份 Chrome。把它整个复制到项目目录下的assets\puppeteer_chrome让工具能找到浏览器程序。第三步启动开发环境npm start第四步体验完整链路点击界面上的开始监听工具会弹出一个浏览器窗口跳转到微信视频号管理后台你用微信扫码登录后开始直播。此时工具界面会实时滚动显示直播间状态与互动消息。再填一个转发地址默认是http://127.0.0.1:8000/forward消息就会源源不断地 POST 到你的服务端。核心原理它凭什么能认出同一批人整个工具最值钱的技术点有两个一个是抓什么一个是怎么认人。精准拦截而不是全盘照收Puppeteer 在浏览器层面监听每一个 HTTP 响应但视频号页面里图片、CSS、视频请求占了绝大多数全部处理会浪费大量资源。工具在src/main/listener.ts里做了两道过滤按 Content-Type 排除视频、图片、音频和静态资源按 URL 只保留mmfinderassistant-bin/live/msg这条接口——它就是弹幕和礼物的总水管。跨场次认人从加密 ID 里挖出稳定标识这是最有意思的部分。微信返回的数据里sec_openid是加密过的用户标识同一个用户在每场直播中都会变化直接用它做用户画像毫无意义。但开发者发现在评论和进场的msg_id里藏着一个以_o9h开头的后缀它就是稳定的decoded_openidstatic getOpenIDFromMsgId(msgId: string): string | null { const idx msgId.indexOf(_o9h); if (idx 0) { return msgId.substring(idx 1, msgId.length); } return null; }可问题来了送礼消息的msg_id结构不同解析不出_o9h后缀。解决思路很巧妙——先靠评论和进场把sec_openid ↔ decoded_openid的映射存进内存缓存src/main/idcache.ts当同一位用户后续送礼时就能顺着映射把身份补上。如果用户一进场就送礼、缓存里还没映射工具会记录警告日志等待下一次评论补齐。正是这套先建索引、再关联查表的思路让同一用户在单场直播内的所有行为都能归到同一个身份下。真实效果一场直播拿到了什么假设你在本地起一个简单的接收服务把forward_url指向它。一场 30 分钟的直播过后你会收到类似这样的结构化数据每条评论{ nickname, content, seq, decoded_openid, msg_time }每次送礼{ nickname, gift_id, gift_num, gift_value, decoded_openid }直播间状态在线人数、点赞总数、打赏总金额微信币用户等级变化from_level → to_level你可以在自己的服务端做去重靠seq序号也可以直接拿它做实时统计谁在哪个时间段最活跃、谁的礼物贡献最大、哪段内容引发评论高峰。写一个弹幕游戏、接一个自动化欢迎机器人数据源都够了。另外工具还在21201端口内置了一个/getLiveStatus接口其他程序可以直接拉取当前的直播间状态。避坑指南四个容易踩的坑Chrome 路径不对工具只认assets\puppeteer_chrome目录下的浏览器复制错位置或漏了这一步启动监听时会直接报错。先确认目录存在再点开始监听。只在 Windows 上验证过README 明确写着工具只在 Win64 系统发布并测试其他系统macOS、Linux没有验证记录跨平台使用要自行承担风险。点赞次数不精确能拿到谁点赞了这类事件和直播间点赞总数但拿不到单个用户的精确点赞次数这是平台协议本身决定的不是工具的 bug。转发会重复服务端收到的数据可能重复推送务必根据seq自己实现去重逻辑forward_url未配置时数据只会显示在界面上不会外发。进阶玩法把工具改造成你想要的样子项目结构非常清晰二次开发基本是对号入座想加新消息类型在src/main/WXDataDecoder.ts的liveMessageFromAppMsg里按msgType补一个分支比如礼物消息对应20009、连击送礼对应20013、点赞对应20006、升级对应20031其他未知类型会保留原始数据存入original_data字段想改数据处理逻辑在src/main/service.ts里扩展事件处理流程比如对接数据库、发到消息队列想换转发协议参考src/main/EventForwarder.ts它已经实现了普通 JSON 和 gzip 压缩两种 POST 方式照着加一个 WebSocket 转发并不难。消息识别的字段约定都在src/CustomTypes.ts的类型定义里写得清清楚楚想改哪里注释都能领路。结语wxlivespy 的价值在于把视频号直播数据抓取这个听起来很玄的事情压缩成了一条看得见的流水线拦截请求、解析消息、识别身份、转发数据。它没有把复杂度藏起来反而把每段逻辑都拆成了独立的小模块让你既能开箱即用也能顺着源码理解微信直播数据的组织方式。项目地址https://gitcode.com/gh_mirrors/wx/wxlivespy克隆后按 README 操作即可。核心源码集中在src/main/目录监听器、解码器、转发器、ID 缓存各司其职界面代码在src/renderer/。如果你正在做视频号直播监控、弹幕数据实时抓取或者直播数据接口转发的需求它值得你花一个下午研究一遍。【免费下载链接】wxlivespy微信视频号直播间弹幕信息抓取工具项目地址: https://gitcode.com/gh_mirrors/wx/wxlivespy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考