GetQzonehistory 上手指南:四步把QQ空间历史说说批量导出成本地Excel
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
QQ空间网页版只能翻到最近几年的动态,更早的说说其实还在,只是没有入口可进。GetQzonehistory 是一个开源工具,通过一次扫码登录,把账号下的历史说说批量抓下来,存成 Excel、网页版和图片文件。这篇讲清从安装到运行的四步流程、跑完你会拿到哪些文件,以及它的抓取边界在哪。
四步从零装到扫出二维码
唯一的前置要求:本机 Python 是 3.9 及以上(依赖清单里固定的 pandas 版本不支持更低的版本),然后照下面四步做。
第一步,拿代码:
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory进入目录后,你会看到 main.py 和 fetch_all_message.py 两个入口脚本、util/ 工具目录和 requirements.txt,就这几样。
第二步,建虚拟环境:
python -m venv myenv myenv\Scripts\activate # Windows source myenv/bin/activate # macOS / Linux激活成功后终端提示符前会多出 myenv 字样,说明环境生效了。
第三步,装依赖:
pip install -r requirements.txtrequirements.txt 里一共 11 个包,解析、表格、请求、二维码各占几个;装完最后会打印一行 Successfully installed。
第四步,运行:
python main.py终端会显示一个二维码,用手机 QQ 扫一下,扫码通过后会立刻打印"登录成功"。
时间上:安装加登录大约三到五分钟。抓取本身每 10 条歇 3 秒,一千条历史动态光等待就要 5 分钟以上,说说越多等得越久。
看看导出目录里能拿到什么
跑完之后,程序会自动打开 resource/result/你的QQ号/ 目录,里面是这么几样东西:
- 全部列表.xlsx:所有抓到的历史消息都在这一份里,时间、内容、图片链接、评论四列,适合整体盘点。
- 分类列表:main.py 按类型拆成说说、转发、留言、其他四份 xlsx,只看自己发过的内容就打开说说列表。
- 好友列表.xlsx:从消息互动记录里提取出的每个好友的昵称、QQ 号、空间主页链接,等于一份社交关系花名册。
- 说说网页版.html:把说说和转发按时间倒序渲染成网页,头像、图片、评论都还原在原位,离线也能打开翻。
- pic/ 目录:说说里的图片按内容命名批量下载,方便单独整理。
还有两处替你想到了:中途按 Ctrl+C,程序会先把已抓的数据存盘再退出,重跑不用从头来;历史消息列表和可见说说是两条数据通道,合并时自动去重,你不用手动筛重复。想要"所有未删除说说"(含 2014 年之前)的完整 Markdown 加高清图,可以单独跑 fetch_all_message.py。
原理一句话:从扫码到归档只走四步
整条链路就是:扫码拿登录态 → 每 10 条一页翻完历史消息列表 → 用当前可见说说补漏去重 → 分类落盘。它不碰任何接口破解,登录和请求都走网页版空间自己的官方机制,util/LoginUtil.py 负责登录,util/RequestUtil.py 负责请求,util/ToolsUtil.py 和 util/GetAllMomentsUtil.py 负责解析和补漏。
边界也要说在前面:设置成"仅自己可见"的说说不会出现在任何公开列表里,删除过的内容也不在抓取范围内,这两类它拿不到。
三个高频问题及应对办法
三个问题出现频率最高,都有明确答案。
Q:启动时报找不到 zbar 库?这是 pyzbar 依赖的系统库没装。macOS 先执行 brew install zbar,RPM 系的 Linux 执行 sudo dnf install -y zbar,装好后重装 Python 依赖再运行。
Q:终端长时间不动,是卡死了吗?不是,程序每抓 10 条会主动歇 3 秒,防止请求过密被风控。别强杀它;实在要停,已抓到的数据也会先存盘,损失有限。
Q:为什么导出的结果感觉不全?数据来源只有历史消息列表和当前可见说说两条通道,仅自己可见的说说两条里都没有。跑完终端会打印"最早的一条说说发布在……",拿它判断你的覆盖范围即可。
跑完这一轮,你手里会多一份能搜索、能筛选、能分析的本地档案:说说是说说的文件,好友关系、图片、网页版各自独立存放。平台入口哪天调整,这份数据也不受影响。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考