Skip to content

About

Direct Douyin share parser and downloader without third-party parse APIs

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

Repository files navigation

Douyin Direct Parser / DY解析

一个自行实现的抖音分享链接解析与下载脚本。项目不调用其他第三方解析站接口,而是直接读取抖音分享页中的公开 SSR 数据,并基于抖音播放接口构造可下载的视频地址。

功能特性

  • 从抖音分享文案中自动提取短链接。
  • 自动跟随 v.douyin.com 跳转并提取 aweme_id。
  • 解析抖音移动分享页 window._ROUTER_DATA。
  • 提取标题、作者、作品 ID、封面、统计信息、图集图片。
  • 构造 1080p / 720p / 540p 等无水印播放地址。
  • 可解析最终签名视频地址和文件大小。
  • 支持 JSON 输出、批量解析、下载视频、下载封面、下载图集。
  • 仅依赖 Python 与 requests,适合本地命令行使用和二次开发。

实现原理

当前实现流程:

  1. 从输入文本中提取 URL。

  2. 如果是短链,跟随跳转到抖音分享页。

  3. 从 URL 或页面路径中提取 aweme_id。

  4. 请求移动分享页:

    https://www.iesdouyin.com/share/video/{aweme_id}/
    
  5. 从页面脚本中的 window._ROUTER_DATA 读取:

    videoInfoRes.item_list[0]
    
  6. 从作品数据中取出 video.play_addr.uri。

  7. 构造抖音播放接口:

    https://aweme.snssdk.com/aweme/v1/play/?video_id={video_id}&ratio={ratio}&line=0
    
  8. 可选跟随跳转,拿到最终签名 MP4 地址并下载。

安装

要求 Python 3.9+。

git clone https://github.com/FanhuaAwA/douyin-direct-parser.git
cd douyin-direct-parser
python -m pip install -r requirements.txt

快速使用

解析单条分享链接并输出到终端:

python dy_parser.py "https://v.douyin.com/J4IQiholWbo/"

解析分享文案并保存 JSON:

python dy_parser.py "7.92 :9pm TLJ:/ u@F.Hi 04/03 爱情公寓|第三季|第257集  https://v.douyin.com/J4IQiholWbo/ 复制此链接,打开Dou音搜索,直接观看视频!" --pretty-json --json-output result.json

下载默认清晰度视频:

python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download

下载探测到的最大文件体积清晰度:

python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality best

下载指定清晰度:

python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality 1080p

下载全部构造出的清晰度:

python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality all

同时下载封面:

python dy_parser.py "https://v.douyin.com/J4IQiholWbo/" --download --quality 1080p --download-cover

批量解析

准备 links.txt,每行一个抖音分享文案或 URL:

https://v.douyin.com/xxxx/
复制此链接,打开Dou音搜索,直接观看视频!https://v.douyin.com/yyyy/

执行:

python dy_parser.py --input-file links.txt --json-output results.json --pretty-json

命令行参数

--download                下载选中的视频
--quality main|best|all   选择下载清晰度
--quality 1080p           下载指定清晰度
--ratios 1080p,720p,540p  指定要构造的清晰度列表
--no-resolve              不解析最终签名 MP4 地址,只输出播放接口地址
--download-cover          下载封面
--download-images         下载图集图片
--json-output PATH        保存解析结果为 JSON
--output-dir DIR          下载目录,默认 downloads
--input-file PATH         批量输入文件
--pretty-json             格式化 JSON 输出
--quiet                   减少终端输出

输出字段

JSON 结果包含:

source_url    原始输入 URL
resolved_url  短链跳转后的 URL
aweme_id      抖音作品 ID
title         视频标题
type          内容类型
cover         封面地址
videos        视频地址和多清晰度信息
pics          图集图片地址
author        作者信息
statistics    点赞、评论、收藏等统计字段
raw           抖音页面中的原始作品数据

项目结构

.
├── dy_parser.py
├── requirements.txt
├── LICENSE
├── README.md
└── dyjiexi
    ├── __init__.py
    ├── cli.py          # 命令行参数、批量、输出、下载调度
    ├── client.py       # 抖音短链解析、分享页 SSR 解析、播放地址构造
    └── downloader.py   # 文件名清理和流式下载

已验证样例

测试链接:

https://v.douyin.com/J4IQiholWbo/

已验证:

  • 成功解析标题:爱情公寓|第三季|第257集
  • 成功提取作品 ID:7624728488368732900
  • 成功生成 1080p / 720p / 540p 视频地址
  • 成功下载 1080p MP4 文件
  • 下载文件头为标准 MP4:ftypisom

维护说明

抖音页面和播放接口可能变化。如果后续失效,优先检查:

  • window._ROUTER_DATA 是否仍存在。
  • videoInfoRes.item_list[0] 路径是否变化。
  • video.play_addr.uri 是否仍可用于 aweme/v1/play。
  • aweme/v1/play 是否新增签名、校验或风控参数。

合规声明

本项目仅用于学习、研究和处理你有权访问与保存的公开内容。视频、图片、音乐等内容版权归原作者或平台所有。请遵守抖音平台规则、版权要求和当地法律法规,不要将本项目用于侵权、批量搬运或商业化滥用。

开源协议

本项目基于 MIT License 开源。

About

Direct Douyin share parser and downloader without third-party parse APIs

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages