金大哥 - download_tools MCP 详情

article

README

🚀 ComfyUI下载工具

ComfyUI的自定义节点，可从包括Instagram、Reddit、Twitter、YouTube、TikTok等在内的1000多个网站下载媒体。

🚀 快速开始

Gallery-dl下载器

在你的工作流中添加“Gallery-dl Downloader”节点。
输入一个URL（例如，Instagram个人资料、Reddit帖子）。
配置选项：
- 对于私有内容，启用use_browser_cookies。
- 启用organize_files按类型排序。
- 启用use_download_archive避免重复下载。
执行！

支持的网站：Instagram、Reddit、Twitter、DeviantArt、Pixiv、Tumblr、Pinterest、Flickr等90多个网站。请参阅gallery-dl支持的网站。

Yt-dlp下载器

在你的工作流中添加“Yt-dlp Downloader”节点。
输入一个URL（例如，YouTube视频）。
选择格式：
- best - 最佳质量视频。
- audio-only - 提取音频（需要FFmpeg）。
- 自定义格式字符串。
执行！

支持的网站：YouTube、TikTok、Vimeo、Twitch、Facebook、Instagram、Twitter等1000多个网站。请参阅yt-dlp支持的网站。

✨ 主要特性

Gallery-dl节点 - 从100多个网站下载图像和视频
- Instagram、Reddit、Twitter/X、DeviantArt、Pixiv等。
- 支持通过浏览器cookie进行身份验证。
- 自动文件组织。
- 下载存档以避免重复。
Yt-dlp节点 - 从1000多个平台下载视频和音频
- YouTube、TikTok、Vimeo、Twitch等。
- 多种质量选项。
- 支持音频提取。
- 支持播放列表。

📦 安装指南

使用ComfyUI管理器（推荐）

打开ComfyUI管理器。
搜索“Download Tools”。
点击安装。

手动安装

将此仓库克隆或下载到你的ComfyUI custom_nodes文件夹：

cd ComfyUI/custom_nodes
git clone https://github.com/EricRollei/download-tools.git

安装依赖项：

# Windows（使用ComfyUI的Python）
.\ComfyUI\python_embeded\python.exe -m pip install -r download-tools\requirements.txt

# 或者使用系统Python
pip install -r download-tools/requirements.txt

（可选）安装FFmpeg用于音频提取：
- Windows：choco install ffmpeg或从https://ffmpeg.org/ 下载。
- macOS：brew install ffmpeg。
- Linux：apt-get install ffmpeg。
重启ComfyUI。

🔐 身份验证

许多网站需要身份验证才能访问私有内容：

方法1：浏览器cookie（自动）

在你的浏览器中登录该网站。
在节点中启用use_browser_cookies。
选择你的浏览器（Chrome、Firefox、Edge等）。
节点将自动使用你的登录会话。

方法2：导出cookie

安装浏览器扩展：“Get cookies.txt LOCALLY”。
登录该网站。
导出cookie。
保存到configs/instagram_cookies.json（或特定网站的文件）。
在节点中设置cookie_file参数。

📁 配置

配置文件存储在download-tools/configs/中：

gallery-dl.conf - Gallery-dl设置。
gallery-dl-browser-cookies.conf - 浏览器cookie配置。
yt-dlp.conf - Yt-dlp默认设置。
yt-dlp-audio.conf - 音频提取预设。
yt-dlp-hq.conf - 高质量预设。

你可以创建自定义配置文件并在节点中引用它们。

📚 详细文档

Docs/中提供了详细指南：

gallery_dl_node_complete_guide.md - Gallery-dl完整使用方法。
yt_dlp_node_complete_guide.md - Yt-dlp完整使用方法。
gallery_dl_authentication_guide.md - 身份验证设置。
gallery_dl_advanced_options_guide.md - 高级功能。

🐛 故障排除

“gallery-dl未找到”

已经安装了！它是一个Python包。节点将自动找到它。

“无法访问Chrome cookie”

尝试以下操作：

以管理员身份运行ComfyUI。
改用Firefox。
手动导出cookie（方法2）。

“Instagram/Reddit下载失败”

需要身份验证：

启用use_browser_cookies。
或者从已登录的浏览器导出cookie。

“CUDA内存不足” / “未找到FFmpeg”

对于音频提取：

单独安装FFmpeg。
或者使用视频格式。

🔧 技术细节

系统要求

| 属性 | 详情 | |------|------| | 所需Python版本 | Python 3.10+ | | 依赖平台 | ComfyUI | | 自动安装依赖 | gallery-dl、yt-dlp | | 可选依赖 | FFmpeg（用于音频提取） |

📄 许可证

双重许可：

非商业用途：根据[知识共享署名 - 非商业性使用 4.0 国际许可协议 (CC BY - NC 4.0)](http://creativecommons.org/licenses/by - nc/4.0/) 许可。
商业用途：需要单独的商业许可证。联系：eric@historic.camera 或 eric@rollei.us。

完整条款请参阅LICENSE.md。

第三方工具

gallery-dl（GNU GPL v2）由Mike Fährmann开发：https://github.com/mikf/gallery-dl
yt-dlp（Unlicense/公共领域）：https://github.com/yt-dlp/yt-dlp

完整依赖列表请参阅CREDITS.md。

👥 贡献

欢迎贡献！指南请参阅CONTRIBUTING.md。

📧 联系

作者：Eric Hiss
GitHub：EricRollei
邮箱：eric@historic.camera，eric@rollei.us

🙏 致谢

ComfyUI社区提供的平台。
Mike Fährmann开发的gallery-dl。
yt-dlp贡献者开发的优秀视频下载器。

download_tools