DouyinSolver 1.0.0__tar.gz

douyinsolver-1.0.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: DouyinSolver
+Version: 1.0.0
+Summary: 抖音视频无水印下载库 - 无需 Cookie，支持视频和图集
+Author-email: ksduqiao <ksduqiao@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/moehans-official/DouyinSolver
+Project-URL: Repository, https://github.com/moehans-official/DouyinSolver
+Project-URL: Issues, https://github.com/moehans-official/DouyinSolver/issues
+Keywords: douyin,tiktok,download,video,无水印,抖音
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# DouyinSolver
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python" alt="Python 3.8+">
+  <img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="MIT License">
+  <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform">
+</p>
+
+<p align="center">
+  <b>抖音视频无水印下载工具</b><br>
+  无需 Cookie · 无需 X-Bogus · 支持视频和图集
+</p>
+
+---
+
+## 特性
+
+- **零配置使用** - 无需登录，无需 Cookie，开箱即用
+- **无水印下载** - 自动转换带水印地址为无水印地址
+- **视频 + 图集** - 支持视频和图集两种模式
+- **移动端策略** - 使用 iPhone User-Agent 绕过反爬虫
+- **Python 库** - 可作为库集成到你的项目中
+- **命令行工具** - 提供 `douyin-dl` 命令行工具
+
+---
+
+## 安装
+
+```bash
+# 从 PyPI 安装（发布后）
+pip install douyin-downloader
+
+# 从源码安装
+git clone https://github.com/moehans-official/DouyinSolver.git
+cd DouyinSolver
+pip install -e .
+```
+
+---
+
+## 快速开始
+
+### 命令行
+
+```bash
+# 解析视频信息
+douyin-dl "https://www.douyin.com/video/xxxxxxxxxx"
+
+# JSON 输出
+douyin-dl "xxxxxxxxxx" --json
+
+# 下载视频
+douyin-dl "xxxxxxxxxx" --download --output ./downloads
+```
+
+### Python API
+
+```python
+from douyin_downloader import DouyinDownloader
+
+# 创建下载器
+dl = DouyinDownloader()
+
+# 解析视频
+info = dl.parse("https://v.douyin.com/xxxxx")
+
+# 查看信息
+print(f"标题: {info.title}")
+print(f"作者: {info.author}")
+print(f"无水印地址: {info.play_url}")
+
+# 下载视频
+dl.download_video(info, "./downloads")
+```
+
+---
+
+## API 参考
+
+### DouyinDownloader
+
+```python
+class DouyinDownloader(
+    timeout: int = 15,
+    session: Optional[requests.Session] = None
+)
+```
+
+| 方法 | 说明 |
+|------|------|
+| `parse(url: str) -> VideoInfo` | 解析视频/图集信息 |
+| `download_video(info: VideoInfo, output_dir=".", filename=None) -> Path` | 下载视频 |
+| `download_gallery(info: VideoInfo, output_dir=".") -> list[Path]` | 下载图集 |
+| `download(url: str, output_path: Path, progress_callback=None) -> Path` | 下载任意 URL |
+
+### VideoInfo
+
+```python
+@dataclass
+class VideoInfo:
+    aweme_id: str                # 视频 ID
+    title: str                   # 标题/描述
+    author: str                  # 作者昵称
+    author_id: str               # 作者抖音号
+    avatar: str                  # 作者头像 URL
+    duration: int               # 时长（毫秒）
+    cover: str                   # 封面 URL
+    play_url: str                # 无水印视频地址
+    play_url_watermark: str     # 带水印视频地址
+    images: list[str]            # 图集图片列表
+    music: Optional[dict]        # 音乐信息
+    
+    @property
+    def is_gallery: bool         # 是否为图集
+    @property
+    def is_video: bool           # 是否为视频
+    
+    def to_dict() -> dict        # 转为字典
+```
+
+---
+
+## 高级用法
+
+### 自定义 Session
+
+```python
+import requests
+from douyin_downloader import DouyinDownloader
+
+session = requests.Session()
+session.headers.update({"User-Agent": "Custom/1.0"})
+
+dl = DouyinDownloader(session=session)
+```
+
+### 下载进度回调
+
+```python
+def on_progress(progress):
+    print(f"{progress.percentage:.1f}%")
+
+info = dl.parse("https://...")
+dl.download(info.play_url, "video.mp4", progress_callback=on_progress)
+```
+
+### 批量下载
+
+```python
+urls = ["url1", "url2", "url3"]
+
+for url in urls:
+    try:
+        info = dl.parse(url)
+        dl.download_video(info, "./downloads")
+        print(f"✓ {info.aweme_id}")
+    except Exception as e:
+        print(f"✗ {url}: {e}")
+```
+
+---
+
+## 技术原理
+
+1. **移动端 User-Agent**: 使用 iPhone Safari 的 UA，避免桌面端的反爬虫机制
+2. **SSR 数据提取**: 从分享页的 `window._ROUTER_DATA` 解析视频元数据
+3. **无水印转换**: 将 `playwm` 替换为 `play` 获取无水印地址
+
+详细实现过程请参阅 [IMPLEMENTATION.md](IMPLEMENTATION.md)
+
+---
+
+## 免责声明
+
+本工具仅供学习研究使用，请遵守相关法律法规和平台使用条款。使用者应确保已获得必要授权，产生的任何后果均由使用者自行承担。
+
+---
+
+## License
+
+MIT License - 详见 [LICENSE](LICENSE)

douyinsolver-1.0.0/README.md

@@ -0,0 +1,181 @@
+# DouyinSolver
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python" alt="Python 3.8+">
+  <img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="MIT License">
+  <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform">
+</p>
+
+<p align="center">
+  <b>抖音视频无水印下载工具</b><br>
+  无需 Cookie · 无需 X-Bogus · 支持视频和图集
+</p>
+
+---
+
+## 特性
+
+- **零配置使用** - 无需登录，无需 Cookie，开箱即用
+- **无水印下载** - 自动转换带水印地址为无水印地址
+- **视频 + 图集** - 支持视频和图集两种模式
+- **移动端策略** - 使用 iPhone User-Agent 绕过反爬虫
+- **Python 库** - 可作为库集成到你的项目中
+- **命令行工具** - 提供 `douyin-dl` 命令行工具
+
+---
+
+## 安装
+
+```bash
+# 从 PyPI 安装（发布后）
+pip install douyin-downloader
+
+# 从源码安装
+git clone https://github.com/moehans-official/DouyinSolver.git
+cd DouyinSolver
+pip install -e .
+```
+
+---
+
+## 快速开始
+
+### 命令行
+
+```bash
+# 解析视频信息
+douyin-dl "https://www.douyin.com/video/xxxxxxxxxx"
+
+# JSON 输出
+douyin-dl "xxxxxxxxxx" --json
+
+# 下载视频
+douyin-dl "xxxxxxxxxx" --download --output ./downloads
+```
+
+### Python API
+
+```python
+from douyin_downloader import DouyinDownloader
+
+# 创建下载器
+dl = DouyinDownloader()
+
+# 解析视频
+info = dl.parse("https://v.douyin.com/xxxxx")
+
+# 查看信息
+print(f"标题: {info.title}")
+print(f"作者: {info.author}")
+print(f"无水印地址: {info.play_url}")
+
+# 下载视频
+dl.download_video(info, "./downloads")
+```
+
+---
+
+## API 参考
+
+### DouyinDownloader
+
+```python
+class DouyinDownloader(
+    timeout: int = 15,
+    session: Optional[requests.Session] = None
+)
+```
+
+| 方法 | 说明 |
+|------|------|
+| `parse(url: str) -> VideoInfo` | 解析视频/图集信息 |
+| `download_video(info: VideoInfo, output_dir=".", filename=None) -> Path` | 下载视频 |
+| `download_gallery(info: VideoInfo, output_dir=".") -> list[Path]` | 下载图集 |
+| `download(url: str, output_path: Path, progress_callback=None) -> Path` | 下载任意 URL |
+
+### VideoInfo
+
+```python
+@dataclass
+class VideoInfo:
+    aweme_id: str                # 视频 ID
+    title: str                   # 标题/描述
+    author: str                  # 作者昵称
+    author_id: str               # 作者抖音号
+    avatar: str                  # 作者头像 URL
+    duration: int               # 时长（毫秒）
+    cover: str                   # 封面 URL
+    play_url: str                # 无水印视频地址
+    play_url_watermark: str     # 带水印视频地址
+    images: list[str]            # 图集图片列表
+    music: Optional[dict]        # 音乐信息
+    
+    @property
+    def is_gallery: bool         # 是否为图集
+    @property
+    def is_video: bool           # 是否为视频
+    
+    def to_dict() -> dict        # 转为字典
+```
+
+---
+
+## 高级用法
+
+### 自定义 Session
+
+```python
+import requests
+from douyin_downloader import DouyinDownloader
+
+session = requests.Session()
+session.headers.update({"User-Agent": "Custom/1.0"})
+
+dl = DouyinDownloader(session=session)
+```
+
+### 下载进度回调
+
+```python
+def on_progress(progress):
+    print(f"{progress.percentage:.1f}%")
+
+info = dl.parse("https://...")
+dl.download(info.play_url, "video.mp4", progress_callback=on_progress)
+```
+
+### 批量下载
+
+```python
+urls = ["url1", "url2", "url3"]
+
+for url in urls:
+    try:
+        info = dl.parse(url)
+        dl.download_video(info, "./downloads")
+        print(f"✓ {info.aweme_id}")
+    except Exception as e:
+        print(f"✗ {url}: {e}")
+```
+
+---
+
+## 技术原理
+
+1. **移动端 User-Agent**: 使用 iPhone Safari 的 UA，避免桌面端的反爬虫机制
+2. **SSR 数据提取**: 从分享页的 `window._ROUTER_DATA` 解析视频元数据
+3. **无水印转换**: 将 `playwm` 替换为 `play` 获取无水印地址
+
+详细实现过程请参阅 [IMPLEMENTATION.md](IMPLEMENTATION.md)
+
+---
+
+## 免责声明
+
+本工具仅供学习研究使用，请遵守相关法律法规和平台使用条款。使用者应确保已获得必要授权，产生的任何后果均由使用者自行承担。
+
+---
+
+## License
+
+MIT License - 详见 [LICENSE](LICENSE)

douyinsolver-1.0.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "DouyinSolver"
+version = "1.0.0"
+description = "抖音视频无水印下载库 - 无需 Cookie，支持视频和图集"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "ksduqiao", email = "ksduqiao@gmail.com"}
+]
+keywords = ["douyin", "tiktok", "download", "video", "无水印", "抖音"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "mypy>=1.0.0",
+]
+
+[project.scripts]
+douyin-dl = "douyin_downloader.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/moehans-official/DouyinSolver"
+Repository = "https://github.com/moehans-official/DouyinSolver"
+Issues = "https://github.com/moehans-official/DouyinSolver/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.black]
+line-length = 100
+target-version = ['py38', 'py39', 'py310', 'py311', 'py312']
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true

douyinsolver-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

douyinsolver-1.0.0/src/DouyinSolver.egg-info/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: DouyinSolver
+Version: 1.0.0
+Summary: 抖音视频无水印下载库 - 无需 Cookie，支持视频和图集
+Author-email: ksduqiao <ksduqiao@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/moehans-official/DouyinSolver
+Project-URL: Repository, https://github.com/moehans-official/DouyinSolver
+Project-URL: Issues, https://github.com/moehans-official/DouyinSolver/issues
+Keywords: douyin,tiktok,download,video,无水印,抖音
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+
+# DouyinSolver
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python" alt="Python 3.8+">
+  <img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="MIT License">
+  <img src="https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform">
+</p>
+
+<p align="center">
+  <b>抖音视频无水印下载工具</b><br>
+  无需 Cookie · 无需 X-Bogus · 支持视频和图集
+</p>
+
+---
+
+## 特性
+
+- **零配置使用** - 无需登录，无需 Cookie，开箱即用
+- **无水印下载** - 自动转换带水印地址为无水印地址
+- **视频 + 图集** - 支持视频和图集两种模式
+- **移动端策略** - 使用 iPhone User-Agent 绕过反爬虫
+- **Python 库** - 可作为库集成到你的项目中
+- **命令行工具** - 提供 `douyin-dl` 命令行工具
+
+---
+
+## 安装
+
+```bash
+# 从 PyPI 安装（发布后）
+pip install douyin-downloader
+
+# 从源码安装
+git clone https://github.com/moehans-official/DouyinSolver.git
+cd DouyinSolver
+pip install -e .
+```
+
+---
+
+## 快速开始
+
+### 命令行
+
+```bash
+# 解析视频信息
+douyin-dl "https://www.douyin.com/video/xxxxxxxxxx"
+
+# JSON 输出
+douyin-dl "xxxxxxxxxx" --json
+
+# 下载视频
+douyin-dl "xxxxxxxxxx" --download --output ./downloads
+```
+
+### Python API
+
+```python
+from douyin_downloader import DouyinDownloader
+
+# 创建下载器
+dl = DouyinDownloader()
+
+# 解析视频
+info = dl.parse("https://v.douyin.com/xxxxx")
+
+# 查看信息
+print(f"标题: {info.title}")
+print(f"作者: {info.author}")
+print(f"无水印地址: {info.play_url}")
+
+# 下载视频
+dl.download_video(info, "./downloads")
+```
+
+---
+
+## API 参考
+
+### DouyinDownloader
+
+```python
+class DouyinDownloader(
+    timeout: int = 15,
+    session: Optional[requests.Session] = None
+)
+```
+
+| 方法 | 说明 |
+|------|------|
+| `parse(url: str) -> VideoInfo` | 解析视频/图集信息 |
+| `download_video(info: VideoInfo, output_dir=".", filename=None) -> Path` | 下载视频 |
+| `download_gallery(info: VideoInfo, output_dir=".") -> list[Path]` | 下载图集 |
+| `download(url: str, output_path: Path, progress_callback=None) -> Path` | 下载任意 URL |
+
+### VideoInfo
+
+```python
+@dataclass
+class VideoInfo:
+    aweme_id: str                # 视频 ID
+    title: str                   # 标题/描述
+    author: str                  # 作者昵称
+    author_id: str               # 作者抖音号
+    avatar: str                  # 作者头像 URL
+    duration: int               # 时长（毫秒）
+    cover: str                   # 封面 URL
+    play_url: str                # 无水印视频地址
+    play_url_watermark: str     # 带水印视频地址
+    images: list[str]            # 图集图片列表
+    music: Optional[dict]        # 音乐信息
+    
+    @property
+    def is_gallery: bool         # 是否为图集
+    @property
+    def is_video: bool           # 是否为视频
+    
+    def to_dict() -> dict        # 转为字典
+```
+
+---
+
+## 高级用法
+
+### 自定义 Session
+
+```python
+import requests
+from douyin_downloader import DouyinDownloader
+
+session = requests.Session()
+session.headers.update({"User-Agent": "Custom/1.0"})
+
+dl = DouyinDownloader(session=session)
+```
+
+### 下载进度回调
+
+```python
+def on_progress(progress):
+    print(f"{progress.percentage:.1f}%")
+
+info = dl.parse("https://...")
+dl.download(info.play_url, "video.mp4", progress_callback=on_progress)
+```
+
+### 批量下载
+
+```python
+urls = ["url1", "url2", "url3"]
+
+for url in urls:
+    try:
+        info = dl.parse(url)
+        dl.download_video(info, "./downloads")
+        print(f"✓ {info.aweme_id}")
+    except Exception as e:
+        print(f"✗ {url}: {e}")
+```
+
+---
+
+## 技术原理
+
+1. **移动端 User-Agent**: 使用 iPhone Safari 的 UA，避免桌面端的反爬虫机制
+2. **SSR 数据提取**: 从分享页的 `window._ROUTER_DATA` 解析视频元数据
+3. **无水印转换**: 将 `playwm` 替换为 `play` 获取无水印地址
+
+详细实现过程请参阅 [IMPLEMENTATION.md](IMPLEMENTATION.md)
+
+---
+
+## 免责声明
+
+本工具仅供学习研究使用，请遵守相关法律法规和平台使用条款。使用者应确保已获得必要授权，产生的任何后果均由使用者自行承担。
+
+---
+
+## License
+
+MIT License - 详见 [LICENSE](LICENSE)

douyinsolver-1.0.0/src/DouyinSolver.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+src/DouyinSolver.egg-info/PKG-INFO
+src/DouyinSolver.egg-info/SOURCES.txt
+src/DouyinSolver.egg-info/dependency_links.txt
+src/DouyinSolver.egg-info/entry_points.txt
+src/DouyinSolver.egg-info/requires.txt
+src/DouyinSolver.egg-info/top_level.txt
+src/douyin_downloader/__init__.py
+src/douyin_downloader/cli.py
+src/douyin_downloader/downloader.py
+src/douyin_downloader/models.py
+src/douyin_downloader/utils.py

douyinsolver-1.0.0/src/DouyinSolver.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

douyinsolver-1.0.0/src/DouyinSolver.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+douyin-dl = douyin_downloader.cli:main

douyinsolver-1.0.0/src/DouyinSolver.egg-info/requires.txt

@@ -0,0 +1,7 @@
+requests>=2.28.0
+
+[dev]
+pytest>=7.0.0
+pytest-asyncio>=0.21.0
+black>=23.0.0
+mypy>=1.0.0

douyinsolver-1.0.0/src/DouyinSolver.egg-info/top_level.txt

@@ -0,0 +1 @@
+douyin_downloader

douyinsolver-1.0.0/src/douyin_downloader/__init__.py

@@ -0,0 +1,28 @@
+"""
+抖音视频无水印下载库
+
+使用移动端 User-Agent 解析抖音分享页 SSR 数据，
+无需 Cookie 和 X-Bogus 签名即可获取无水印视频地址。
+
+示例:
+    >>> from douyin_downloader import DouyinDownloader
+    >>> dl = DouyinDownloader()
+    >>> info = dl.parse("https://www.douyin.com/video/xxxxxx")
+    >>> print(info.play_url)
+
+作者: OpenCode
+许可证: MIT
+"""
+
+from .downloader import DouyinDownloader
+from .models import VideoInfo, ParseError
+from .utils import normalize_url, extract_video_id
+
+__version__ = "1.0.0"
+__all__ = [
+    "DouyinDownloader",
+    "VideoInfo",
+    "ParseError",
+    "normalize_url",
+    "extract_video_id",
+]

douyinsolver-1.0.0/src/douyin_downloader/cli.py

@@ -0,0 +1,75 @@
+"""命令行接口"""
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from .downloader import DouyinDownloader
+from .models import ParseError, VideoInfo
+
+
+def format_output(info: VideoInfo, output_json: bool = False) -> str:
+    """格式化输出"""
+    if output_json:
+        return json.dumps(info.to_dict(), ensure_ascii=False, indent=2)
+    
+    lines = [
+        f"视频 ID: {info.aweme_id}",
+        f"标题: {info.title[:60]}{'...' if len(info.title) > 60 else ''}",
+        f"作者: {info.author} (@{info.author_id})",
+    ]
+    
+    if info.is_gallery:
+        lines.append(f"类型: 图集 ({len(info.images)} 张)")
+        for i, img in enumerate(info.images[:5], 1):
+            lines.append(f"  [{i}] {img}")
+        if len(info.images) > 5:
+            lines.append(f"  ... 还有 {len(info.images) - 5} 张")
+    else:
+        lines.extend([
+            f"类型: 视频",
+            f"无水印地址: {info.play_url}",
+        ])
+    
+    if info.music:
+        lines.append(f"背景音乐: {info.music['title']}")
+    
+    return "\n".join(lines)
+
+
+def main():
+    """主入口"""
+    parser = argparse.ArgumentParser(
+        prog="douyin-dl",
+        description="抖音视频无水印下载工具",
+    )
+    parser.add_argument("input", help="视频链接或ID")
+    parser.add_argument("-j", "--json", action="store_true", help="JSON 输出")
+    parser.add_argument("-d", "--download", action="store_true", help="下载视频/图集")
+    parser.add_argument("-o", "--output", default=".", help="输出目录")
+    
+    args = parser.parse_args()
+    
+    dl = DouyinDownloader()
+    
+    try:
+        info = dl.parse(args.input)
+        print(format_output(info, args.json))
+        
+        if args.download and not args.json:
+            print(f"\n开始下载...")
+            if info.is_gallery:
+                paths = dl.download_gallery(info, args.output)
+                print(f"图集已下载到: {paths[0].parent}")
+            else:
+                path = dl.download_video(info, args.output)
+                print(f"视频已下载到: {path}")
+                
+    except ParseError as e:
+        print(f"错误: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

douyinsolver-1.0.0/src/douyin_downloader/downloader.py

@@ -0,0 +1,203 @@
+"""抖音下载器核心类"""
+
+import json
+import re
+from pathlib import Path
+from typing import Callable, Optional, Union
+
+import requests
+
+from .models import DownloadProgress, ParseError, VideoInfo
+from .utils import get_mobile_headers, normalize_url
+
+
+class DouyinDownloader:
+    """
+    抖音视频/图集下载器
+    
+    使用移动端 User-Agent 访问分享页，无需 Cookie 即可获取无水印视频。
+    
+    Examples:
+        >>> dl = DouyinDownloader()
+        >>> info = dl.parse("https://www.douyin.com/video/xxxx")
+        >>> print(info.play_url)
+        >>> dl.download(info.play_url, "video.mp4")
+    """
+    
+    BASE_URL = "https://www.iesdouyin.com/share/video/{aweme_id}/"
+    
+    def __init__(
+        self,
+        timeout: int = 15,
+        session: Optional[requests.Session] = None,
+    ):
+        self.timeout = timeout
+        self.session = session or requests.Session()
+        self.session.headers.update(get_mobile_headers())
+    
+    def parse(self, url: str) -> VideoInfo:
+        """解析抖音视频/图集信息"""
+        aweme_id = normalize_url(url)
+        data = self._fetch_share_page(aweme_id)
+        return self._parse_video_info(data, aweme_id)
+    
+    def _fetch_share_page(self, aweme_id: str) -> dict:
+        """获取分享页 SSR 数据"""
+        url = self.BASE_URL.format(aweme_id=aweme_id)
+        
+        try:
+            resp = self.session.get(url, timeout=self.timeout)
+            resp.raise_for_status()
+        except requests.RequestException as e:
+            raise ParseError(f"分享页请求失败: {e}", code=500)
+        
+        pattern = r'window\._ROUTER_DATA\s*=\s*(.*?)</script>'
+        matches = re.search(pattern, resp.text, re.DOTALL)
+        
+        if not matches:
+            raise ParseError("未找到 SSR 数据", code=404)
+        
+        try:
+            data = json.loads(matches.group(1).strip())
+        except json.JSONDecodeError as e:
+            raise ParseError(f"JSON 解析失败: {e}", code=500)
+        
+        return data
+    
+    def _parse_video_info(self, data: dict, aweme_id: str) -> VideoInfo:
+        """从 SSR 数据解析视频信息"""
+        loader_data = data.get("loaderData", {})
+        video_page = loader_data.get("video_(id)/page", {})
+        
+        if not video_page:
+            raise ParseError("未找到视频页面数据", code=404)
+        
+        video_info_res = video_page.get("videoInfoRes", {})
+        item_list = video_info_res.get("item_list", [])
+        
+        if not item_list:
+            raise ParseError("视频不存在或已删除", code=404)
+        
+        item = item_list[0]
+        
+        # 作者信息
+        author_info = item.get("author", {})
+        author = author_info.get("nickname", "")
+        author_id = author_info.get("unique_id", "")
+        avatar = author_info.get("avatar_medium", {}).get("url_list", [""])[0]
+        
+        # 视频信息
+        video_data = item.get("video", {})
+        play_addr = video_data.get("play_addr", {})
+        url_list = play_addr.get("url_list", [])
+        
+        play_url_wm = url_list[0] if url_list else ""
+        play_url = play_url_wm.replace("playwm", "play") if play_url_wm else ""
+        cover = video_data.get("cover", {}).get("url_list", [""])[0]
+        
+        # 图集模式
+        images = []
+        img_list = item.get("images", [])
+        for img in img_list:
+            urls = img.get("url_list", [])
+            if urls:
+                images.append(urls[0])
+        
+        # 音乐信息
+        music_info = item.get("music")
+        music = None
+        if music_info:
+            music = {
+                "title": music_info.get("title", ""),
+                "author": music_info.get("author", ""),
+                "url": music_info.get("play_url", {}).get("url_list", [""])[0],
+                "cover": music_info.get("cover_large", {}).get("url_list", [""])[0],
+            }
+        
+        return VideoInfo(
+            aweme_id=aweme_id,
+            title=item.get("desc", ""),
+            author=author,
+            author_id=author_id,
+            avatar=avatar,
+            duration=video_data.get("duration", 0),
+            cover=cover,
+            play_url=play_url,
+            play_url_watermark=play_url_wm,
+            images=images,
+            music=music,
+        )
+    
+    def download(
+        self,
+        url: str,
+        output_path: Union[str, Path],
+        progress_callback: Optional[Callable[[DownloadProgress], None]] = None,
+    ) -> Path:
+        """下载视频/图片"""
+        output_path = Path(output_path)
+        
+        resp = self.session.get(url, stream=True, timeout=self.timeout)
+        resp.raise_for_status()
+        
+        total_size = int(resp.headers.get("content-length", 0))
+        downloaded = 0
+        
+        with open(output_path, "wb") as f:
+            for chunk in resp.iter_content(chunk_size=8192):
+                if chunk:
+                    f.write(chunk)
+                    downloaded += len(chunk)
+                    
+                    if progress_callback and total_size > 0:
+                        progress = DownloadProgress(
+                            downloaded=downloaded,
+                            total=total_size,
+                            percentage=(downloaded / total_size) * 100,
+                        )
+                        progress_callback(progress)
+        
+        return output_path
+    
+    def download_video(
+        self,
+        info: VideoInfo,
+        output_dir: Union[str, Path] = ".",
+        filename: Optional[str] = None,
+    ) -> Path:
+        """下载视频"""
+        if info.is_gallery:
+            raise ParseError("该链接为图集")
+        
+        if not info.play_url:
+            raise ParseError("无水印视频地址为空")
+        
+        output_dir = Path(output_dir)
+        output_dir.mkdir(parents=True, exist_ok=True)
+        
+        if not filename:
+            filename = f"{info.aweme_id}_{info.author}"
+        
+        output_path = output_dir / f"{filename}.mp4"
+        return self.download(info.play_url, output_path)
+    
+    def download_gallery(
+        self,
+        info: VideoInfo,
+        output_dir: Union[str, Path] = ".",
+    ) -> list[Path]:
+        """下载图集"""
+        if not info.is_gallery:
+            raise ParseError("该链接不是图集")
+        
+        output_dir = Path(output_dir) / info.aweme_id
+        output_dir.mkdir(parents=True, exist_ok=True)
+        
+        paths = []
+        for i, url in enumerate(info.images, 1):
+            ext = url.split("?")[0].split(".")[-1] or "jpg"
+            output_path = output_dir / f"{i:02d}.{ext}"
+            self.download(url, output_path)
+            paths.append(output_path)
+        
+        return paths

douyinsolver-1.0.0/src/douyin_downloader/models.py

@@ -0,0 +1,90 @@
+"""数据模型定义"""
+
+from dataclasses import dataclass, field
+from typing import Optional
+
+
+@dataclass
+class VideoInfo:
+    """
+    抖音视频/图集信息
+    
+    Attributes:
+        aweme_id: 视频唯一ID
+        title: 视频标题/描述
+        author: 作者昵称
+        author_id: 作者抖音号
+        avatar: 作者头像URL
+        duration: 视频时长(毫秒)
+        cover: 封面图URL
+        play_url: 无水印视频地址
+        play_url_watermark: 带水印视频地址
+        music: 背景音乐信息
+        images: 图集图片URL列表(仅图集模式)
+    """
+    
+    aweme_id: str
+    title: str = ""
+    author: str = ""
+    author_id: str = ""
+    avatar: str = ""
+    duration: int = 0
+    cover: str = ""
+    play_url: str = ""  # 无水印视频地址
+    play_url_watermark: str = ""  # 带水印地址
+    music: Optional[dict] = None
+    images: list[str] = field(default_factory=list)
+    
+    @property
+    def is_gallery(self) -> bool:
+        """是否为图集模式"""
+        return len(self.images) > 0
+    
+    @property
+    def is_video(self) -> bool:
+        """是否为视频模式"""
+        return not self.is_gallery and bool(self.play_url)
+    
+    def to_dict(self) -> dict:
+        """转换为字典格式"""
+        return {
+            "aweme_id": self.aweme_id,
+            "title": self.title,
+            "author": self.author,
+            "author_id": self.author_id,
+            "avatar": self.avatar,
+            "duration": self.duration,
+            "cover": self.cover,
+            "play_url": self.play_url,
+            "play_url_watermark": self.play_url_watermark,
+            "music": self.music,
+            "images": self.images,
+            "is_gallery": self.is_gallery,
+            "is_video": self.is_video,
+        }
+
+
+class ParseError(Exception):
+    """解析错误"""
+    
+    def __init__(self, message: str, code: int = 0):
+        self.message = message
+        self.code = code
+        super().__init__(self.message)
+    
+    def __str__(self) -> str:
+        return f"[{self.code}] {self.message}" if self.code else self.message
+
+
+@dataclass
+class DownloadProgress:
+    """下载进度信息"""
+    
+    downloaded: int = 0
+    total: int = 0
+    percentage: float = 0.0
+    speed: str = "0 B/s"
+    
+    @property
+    def completed(self) -> bool:
+        return self.total > 0 and self.downloaded >= self.total

douyinsolver-1.0.0/src/douyin_downloader/utils.py

@@ -0,0 +1,123 @@
+"""工具函数"""
+
+import re
+from typing import Optional
+from urllib.parse import urlparse
+
+import requests
+
+from .models import ParseError
+
+# 正则表达式模式
+PURE_ID_PATTERN = re.compile(r"^\d{15,20}$")
+LONG_LINK_PATTERN = re.compile(r"/video/(\d+)")
+SHORT_LINK_PATTERN = re.compile(r"v\.douyin\.com/([\w-]+)")
+
+# 移动端 User-Agent (关键)
+MOBILE_USER_AGENT = (
+    "Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) "
+    "AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 "
+    "Mobile/15E148 Safari/604.1"
+)
+
+
+def extract_video_id(url: str) -> Optional[str]:
+    """
+    从各种格式的链接中提取视频ID
+    
+    Args:
+        url: 抖音链接 (短链/长链/分享页)
+        
+    Returns:
+        视频ID或None
+        
+    Examples:
+        >>> extract_video_id("https://www.douyin.com/video/123456")
+        '123456'
+        >>> extract_video_id("https://v.douyin.com/xxxxx")
+        '123456'  # 会跟随重定向
+    """
+    url = url.strip()
+    
+    # 纯ID
+    if PURE_ID_PATTERN.match(url):
+        return url
+    
+    # 补全协议
+    if "://" not in url:
+        url = "https://" + url
+    
+    parsed = urlparse(url)
+    path = parsed.path or ""
+    
+    # 长链: /video/xxxx
+    m = LONG_LINK_PATTERN.search(path)
+    if m:
+        return m.group(1)
+    
+    # 分享页: /share/video/xxxx
+    m = re.search(r"/share/video/(\d+)", path)
+    if m:
+        return m.group(1)
+    
+    return None
+
+
+def normalize_url(raw: str) -> str:
+    """
+    将各种输入格式统一转换为 aweme_id
+    
+    Args:
+        raw: 短链/长链/纯ID
+        
+    Returns:
+        aweme_id
+        
+    Raises:
+        ParseError: 无法识别的格式
+    """
+    # 纯ID
+    if PURE_ID_PATTERN.match(raw.strip()):
+        return raw.strip()
+    
+    # 从链接提取
+    video_id = extract_video_id(raw)
+    if video_id:
+        return video_id
+    
+    # 短链重定向
+    if "v.douyin.com" in raw or "iesdouyin.com" in raw:
+        return _resolve_short_link(raw)
+    
+    raise ParseError(f"无法识别的输入格式: {raw}")
+
+
+def _resolve_short_link(url: str) -> str:
+    """跟随短链重定向获取视频ID"""
+    url = url.strip()
+    if "://" not in url:
+        url = "https://" + url
+    
+    try:
+        resp = requests.get(
+            url,
+            headers={"User-Agent": MOBILE_USER_AGENT},
+            allow_redirects=True,
+            timeout=15,
+        )
+        video_id = extract_video_id(resp.url)
+        if video_id:
+            return video_id
+    except requests.RequestException as e:
+        raise ParseError(f"短链解析失败: {e}")
+    
+    raise ParseError(f"无法从短链提取视频ID")
+
+
+def get_mobile_headers() -> dict:
+    """获取移动端请求头"""
+    return {
+        "User-Agent": MOBILE_USER_AGENT,
+        "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "Accept-Language": "zh-CN,zh;q=0.9",
+    }