此分支为dev, 仅用于开发, 可能存在各种问题, 需要稳定版请下 release 里的
若使用dev分支出现问题欢迎反馈, 可以缩短我的测试流程

twitter-media-downloader 推特媒体文件下载工具

用于下载推特页面中包含的媒体文件（支持文本, 图片, 视频, 动图）的脚本工具, 使用推特网页版的 api 获取数据

支持输入如下四种格式的链接(***为推主 id):

https://twitter.com/***/status/*** (爬取单条推文)
https://twitter.com/*** (推主主页, 爬取推主所有推文)
https://twitter.com/***/media (推主媒体页, 爬取推主所有媒体推文)
https://twitter.com/***/likes (推主喜爱页, 爬取所有喜爱推文)
https://twitter.com/***/following (推主关注页, 爬取关注列表)
@*** (爬取搜索页)

不同接口区别： api_关于接口

donate 赞助

若喜欢本项目, 欢迎前往爱发电支持作者

tips 提示

默认下载文件名格式: {推主 id}_{推文 id}_{服务器文件名}, 例如 memidesuyo_1441613758988574723_FAGkEkFVEAI8GSd.jpg
- 1.3.0改为推主id-推文id-日期_时间(UTC)-数据类型+序号 例如 memidesuyo-1614977212545844224-20230213_114210-img1.jpg
- 若需要旧版的格式, 请将自定义保存文件名设置为: {userName}_{twtId}_{ori}
爬取视频文件时, 会自动选择最高分辨率下载, 图片文件则自动选择原图画质
程序的配置文件路径:
- linux: ~/tw_media_downloader.conf
- win: %userprofile%/tw_media_downloader.conf

usage 使用方法

若使用python3环境运行py代码，注意先安装依赖：
```
pip install -r requirements.txt
```
1. 交互模式:
 直接运行后根据提示输入命令或链接即可.
```
python twitter-media-downloader.py
```
 示例：
 - 下载单条推文 https://twitter.com/user/status/0000000000000000000
 - 下载用户主页 https://twitter.com/user
 - 下载用户媒体页 https://twitter.com/user/media
 - 下载用户搜索页 @user
 - 下载用户搜索页并指定日期 @user&2022-12-1|2022-12-10
 - 高级搜索，包含#tag1和#tag2，并指定推文来自用户user @&advanced=(#tag1 AND #tag2) (from:user)
 - 注：脚本搜索页默认不包含回复，如需爬取回复请使用高级搜索详情
2. 命令行调用:
```
 usage: twitter-media-downloader.py [-h] [-c COOKIE] [-p PROXY] [-d DIR] [-n CONCURRENCY] [-t TYPE] [-f FILENAME] [-m] [-q] [-r] [-v] [url ...]

 positional arguments:
 url tw url to collect, must be like:
 1. https://twitter.com/***/status/***
 2. https://twitter.com/***(/media|likes|following) (user page, *** is user_id)
 3. @*** (search page, plz check README)

 options:
 -h, --help show this help message and exit
 -c COOKIE, --cookie COOKIE
 for access locked users&tweets, default use cfg file, input " " to clear
 -p PROXY, --proxy PROXY
 support http&socks5, default use cfg file, input " " to clear
 -d DIR, --dir DIR set download path, default: twitter_media_download/ or use cfg file
 -n CONCURRENCY, --num CONCURRENCY
 downloader concurrency, default: 8 or use cfg file
 -t TYPE, --type TYPE desired media type, default: photo&animated_gif&video&full_text or use cfg file
 -f FILENAME, --fileName FILENAME
 output fileName, valid var: {userId},{twtId},{ori},{date},{time},{type}
 default: {userName}-{twtId}-{date}_{time}-{type} or use cfg file
 -m, --media exclude non-media tweets
 -q, --quoted exclude quoted tweets
 -r, --retweeted exclude retweeted
 -v, --version show version and check update
```
 示例：
 - 下载用户主页 python twitter-media-downloader.py https://twitter.com/user
 - 下载用户主页，排除转推 python twitter-media-downloader.py -r https://twitter.com/user
 - 下载用户媒体页，排除引用 python twitter-media-downloader.py -q https://twitter.com/user/media
 - 下载用户搜索页，排除引用 python twitter-media-downloader.py -q @user
 - -r 和 -q 用于排除转推和引用, -m 用于排除非媒体(纯文本)推文
 - 下载用户搜索页，指定下载类型为图片和视频 python twitter-media-downloader.py -t "photo&video" @user
 - 下载用户搜索页，指定日期为2022-12-1到2022-12-20 python twitter-media-downloader.py "@user&2022-12-1|2022-12-20"
 - 高级搜索详情，搜索包含#tag1和#tag2，并指定推文来自用户user python twitter-media-downloader.py "@&advanced=(#tag1 AND #tag2) (from:user)"
搜索接口用法
1. 构成： @用户名&附加命令
2. 使用 @ 开头
3. 使用 & 连接用户名与附加命令
4. 使用 | 连接日期 2020-1-1|2021-1-1
5. 使用命令行传入参数运行时一定要使用双引号包住 "@user&2020-1-1|2021-1-1"
6. 高级搜索：前往推特高级搜索页填写并搜索，然后复制搜索框内容，将内容粘贴至 @&advanced= 后面
7. 关于高级搜索的tag：推特默认使用 #taga OR #tagb 意为包含taga或者包含tagb，但是可以手动修改为 #taga AND #tagb ，意为含taga并且包含tagb

build 编译

执行如下命令生成 当前平台的可执行文件(可免python环境运行)：

pip install -r requirements.txt
pyinstaller -F twitter-media-downloader.py

输出路径: ./dist

api_关于接口

目前有5个不同的下载接口，分别是单条推文、用户主页、用户媒体页、搜索页、喜爱页。

搜索接口: 能获取到用户所有推文, 但锁推推主的旧推文(2023年以前)可能会缺失(应该是服务端的问题)
主页/媒体页/喜爱页接口: 推文数量过多时会部分缺失

综上, 爬取锁推推主时, 建议同时使用 搜索接口+主页/媒体页接口 以防止缺失数据

接口	单条推文	用户主页	用户媒体页	搜索页	喜爱页
推文数量	★☆☆☆☆	★★☆☆☆	★★★☆☆	★★★★★	★★★☆☆
包含引用	✔	✔	✔	✔	✔
包含转推	❌	✔	❌	❌	❌
高级用法（标签、日期等）	❌	❌	❌	✔	❌

TODO 待实现需求

GUI (可能要等很久才能写出来)
~~添加socks代理支持, 优化代理配置流程~~(完成)
~~添加用户like页爬取功能~~(完成)
修改默认输出文件名格式为 推主id-推文id-日期_时间-img1/-vid1/-gif1/-text(完成)
- 例如 ***-1614977212545844224-20230213_114210-img1.jpg
~~添加输出文件名自定义可选元素: 推主id, 推文id, 日期, 时间, 类型+序号~~(完成)
支持单条推文的评论(回复)爬取
尝试添加其他平台(linux mac)的自动获取系统代理
实现增量爬取模式(提供配置选项), 以避免不必要的爬取请求

已完成 [点击展开]

支持 cmd 传参调用
支持爬取视频/动图文件
支持批量爬取推主所有媒体
下载进度显示
分模块重构代码方便后续开发
支持手动设置 UA 和代理
支持设置 cookie 用于爬取锁推
完善程序错误 log 导出 (完成, 现会在崩溃后写入完整 log 到文件)
批量爬取时输出进度记录, 并在程序异常退出重启后导入进度继续下载 (废弃)
在文件名前添加推文 id, 方便定位推文
支持自定义下载路径
提供推文 id 转推文 url 功能
退出时保存 UA/代理/cookie 到配置文件, 下次运行程序自动读取设置
在直接运行程序的交互模式下加入 cookie,下载路径,代理的设置命令
添加自动更新功能&CI 自动编译
废弃推文 id 转 url 功能, 并将下载文件的格式设置为: {推主 id}_{推文 id}_{服务器文件名} (方便定位推文 url)
添加自定义关键字/正则表达式, 提取推文中的 url 链接 (废弃, 由 TODO#22 替代)
添加媒体文件的筛选提取功能(例如仅图片, 仅视频)
添加推主转载推文的媒体提取功能 (废弃, 转载推文没有独立的获取接口)
优化启动逻辑, 启动时网络检查失败不再强制跳出程序
下载文件时跳过目标路径下已存在的文件, 避免重复下载
添加爬取推文文本内容的功能(可选参数)
使用多线程并发下载多个文件, 提高下载速度(可选线程并发数)
已知 UserMedia api 会把已删除的推文一起返回, 占用 count, 导致爬取内容不完整, 尝试修复
支持输入空配置项(例如cookie设置), 用于重置对应配置 (完成, cookie, proxy, ua均已支持)
配置cookie时添加完整的cookie校验, 防止输错cookie导致接口返回403 (已修复, 其实是正则写错导致cookie解析错误)
userMedia接口老是缺数据, 将批量爬取的逻辑改为从userMedia提取tw_id, 然后丢到singlePageTask去执行 (已修复, 实际问题为部分用户/推文有年龄限制, 需要设置cookie才能正常访问, 1.2.3版本已加入提示)
直接运行模式下, 完善操作提示, 照顾小白

preview 预览

批量下载:

dd178 / twitter-media-downloader