download tools MCP

ComfyUI下载工具

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

🎉 特性

• 图库dl节点 -从100多个网站下载图片和视频

- Instagram、Reddit、Twitter/X、DeviantArt、Pixiv等 - 分辨率滤波 -跳过小图片（默认值：最小768px） - 支持通过配置文件或浏览器Cookie进行身份验证 - 自动文件组织 - 下载存档以避免重复 - 持久配置路径 -会话之间会记住路径 - 可配置超时 -大容量下载时长可达1小时

• Web图像抓取节点 -通过Playwright从任何网站提取图像

- 25个以上针对特定地点的处理程序，用于优化提取 - 自动全分辨率图像检测（跳过缩略图） - 多页分页和无限滚动支持 - 剧透/隐藏内容自动显示（IPS论坛） - 与yt-dlp一起使用的视频链接集合（YouTube/Vimeo） - 通过感知哈希进行重复检测 - 可配置的最小尺寸，并行下载

• Yt-dlp节点 -从1800多个平台下载视频和音频

- YouTube、TikTok、Vimeo、Twitch等 - 多种质量选项 - 音频提取支持 - 播放列表支持 - 通过Cookie或凭据进行身份验证

📺 Yt-dlp支持的站点（主要平台）

yt-dlp节点支持 1800多个网站。以下是最受欢迎的：

视频平台

流媒体服务（可能需要订阅）

音乐和音频

新闻与媒体

教育的

其他热门网站

完整列表

有关1800多个受支持站点的完整列表，请参阅 yt-dlp支持的官方网站.

站点特定身份验证

一些网站在身份验证方面工作得更好：

# Using .netrc file (recommended for security)
--netrc

# Using username/password directly
--username YOUR_EMAIL --password YOUR_PASSWORD

# Using browser cookies
--cookies-from-browser firefox

提示： 对于Vimeo、YouTube（年龄限制）或任何订阅服务等网站，身份验证可以解锁更多内容。

🌐 Web图像抓取器-网站处理程序

Web Image Scraper节点随附 25+现场特定处理人员 了解每个站点的DOM结构并自动提取全分辨率图像。通用处理程序涵盖了其他所有内容。

IPS/Invision社区论坛（Bellazon）

这 BellazonHandler 专为Invision社区（IPS）论坛构建：

• 仅限全分辨率 --IPS缩略图使用与全分辨率图像不同的哈希，因此处理程序读取权威 ` 和 data-full-image` 属性，而不是试图重写缩略图URL。
• 扰流板处理 --自动打开 `` 提取前使用剧透块（“剧透”、“剧透裸体”、“显示隐藏内容”等），以便包含隐藏图像。
• 多页分页 --检测“PAGE X OF Y”控件，并自动遍历主题的每一页。
• 视频链接收集 --嵌入在帖子中的YouTube和Vimeo URL被收集并作为视频项目返回，以便使用yt-dlp节点进行可选下载。
• 零缩略图下载 --包含以下内容的任何URL .thumb. 在三个级别（JS提取、Python过滤、后处理）上被硬拒绝。

要添加对另一个IPS论坛的支持，只需将其域名添加到 IPS_DOMAINS 列入 site_handlers/bellazon_handler.py.

📦 安装

使用ComfyUI管理器（推荐）

1. 打开ComfyUI管理器
2. 搜索“下载工具”
3. 单击安装

手动安装

1. 将此存储库克隆或下载到您的ComfyUI custom_nodes文件夹：

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

1. 安装依赖项：

   # Windows (using ComfyUI's Python)
   .\ComfyUI\python_embeded\python.exe -m pip install -r download-tools\requirements.txt

   # Or using system Python
   pip install -r download-tools/requirements.txt

1. （可选）安装FFmpeg进行音频提取：

- 窗户： choco install ffmpeg 或从以下网址下载https://ffmpeg.org/ - macOS： brew install ffmpeg - Linux： apt-get install ffmpeg

1. 重新启动ComfyUI

🚀 快速开始

图库dl下载器

1. 将“Gallery dl Downloader”节点添加到您的工作流程中
2. 输入URL（例如，Instagram个人资料、Reddit帖子）
3. 配置选项：

- 集 config_path 到 ./configs/gallery-dl.conf （自动保存以备下次使用） - 启用 filter_by_resolution 跳过小图片（默认值768px） - 启用 organize_files 按类型排序 - 启用 use_download_archive 避免重复 - 增加 download_timeout 对于大型画廊（默认值：600秒）

1. 执行！

支持的网站： Instagram、Reddit、Twitter、DeviantArt、Pixiv、Tumblr、Pinterest、Flickr等90多个平台。看 画廊dl支持的网站.

Yt-dlp下载器

1. 将“Yt-dlp Downloader”节点添加到您的工作流中
2. 输入URL（例如，YouTube视频、Vimeo、Twitch VOD、TikTok）
3. 选择格式：

- best -最佳质量视频 - best[height<=1080] -最高1080p的最佳质量 - audio-only -提取音频（需要FFmpeg） - 自定义格式字符串

1. 对于私人内容，启用浏览器Cookie或使用带有凭据的配置文件
2. 执行！

支持的网站： YouTube、Vimeo、TikTok、Twitch、Facebook、Instagram、Twitter、Dailymotion、SoundCloud以及1800多个平台。看 yt-dlp支持的网站 或者上表。

� Instagram下载

对于Instagram，请使用Gallery dl，因为它更好。 Gallery-dl支持本地Instagram API，处理分页、费率限制，并可以下载帖子、故事、卷轴和精彩片段。

推荐设置

所有站点的一个配置

这 gallery-dl.conf 文件包含的凭据 所有支持的网站 （Instagram、Reddit、500px、DeviantArt、Pinterest、Flickr、Bluesky）。Gallery dl会根据您下载的URL自动使用正确的凭据。

为什么不使用浏览器Cookie？

• 铬/边缘： 需要管理员权限，并且必须关闭浏览器
• 火狐浏览器： 无需管理员即可工作，但不如配置文件可靠
• 配置文件： 最可靠的方法-始终有效

设置Instagram身份验证

1. 导出您的Instagram Cookie 从Chrome/Firefox使用“本地获取cookies.txt”扩展程序
2. 复制关键Cookie 到 configs/gallery-dl.conf 在 instagram 章节：

   "instagram": {
       "cookies": {
           "sessionid": "YOUR_SESSION_ID",
           "ds_user_id": "YOUR_USER_ID", 
           "csrftoken": "YOUR_CSRF_TOKEN",
           "mid": "YOUR_MID_VALUE"
       }
   }

1. 在节点中使用：

- 集 config_path 到 ./configs/gallery-dl.conf - 离开 cookie_file 空 - 集 use_browser_cookies 转为假

Cookie过期

Instagram会话Cookie将在约1年后过期。如果下载开始失败，出现401个错误，请从浏览器导出新的Cookie。

�🔐 认证

许多网站要求对私人内容进行身份验证：

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

1. 在浏览器中登录网站
2. 启用 use_browser_cookies 在节点中
3. 选择您的浏览器（Chrome、Firefox、Edge等）
4. 节点将自动使用您的登录会话

方法2：导出Cookie

1. 安装浏览器扩展程序：“本地获取cookies.txt”
2. 登录网站
3. 导出Cookie
4. 保存到 configs/instagram_cookies.json （或特定于站点的文件）
5. 集 cookie_file 节点中的参数

📁 配置

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

• gallery-dl.conf - 主要配置 拥有所有网站的证书（Instagram、Reddit、500px、DeviantArt、Pinterest、Flickr、Bluesky）
• gallery-dl.conf.example -用于创建自己的配置的模板
• yt-dlp.conf.example -Yt dlp模板（复制到 yt-dlp.conf 并添加您的凭据）
• yt-dlp-audio.conf -音频提取预设
• yt-dlp-hq.conf -高品质预设

持久路径

配置文件路径为 自动保存 在ComfyUI会话之间。一旦你设置 config_path 或 cookie_file，他们下次会被记住的。

📚 文档

详细指南可在 Docs/:

• gallery_dl_node_complete_guide.md -完成图库dl使用
• yt_dlp_node_complete_guide.md -完全使用yt-dlp
• gallery_dl_authentication_guide.md -身份验证设置
• gallery_dl_advanced_options_guide.md -高级功能

🐛 故障排除

“未找到库dl”

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

“无法访问Chrome Cookie”

Chrome在运行时锁定其cookie数据库。解决：

• 运行前完全关闭Chrome
• 以管理员身份运行ComfyUI
• 改用Firefox（不需要管理员）
• 最佳： 使用带有Cookie的配置文件（见上文Instagram部分）

“Instagram/Reddit下载失败”

需要身份验证：

• 使用 config_path: ./configs/gallery-dl.conf 使用Cookie
• 或启用 use_browser_cookies 使用Firefox
• 401未经授权=过期Cookie，导出新鲜Cookie

“下载超时”

对于大型画廊：

• 增加 download_timeout （默认值：1800秒/30分钟，最大值：10小时）
• 大型Instagram个人资料可能需要几个小时
• 如果下载超时，只需再次运行——gallery dl会自动恢复使用下载存档

“小图像太多”

启用分辨率筛选：

• 集 filter_by_resolution 为真
• 调整 min_image_width 和 min_image_height （默认值：768像素）
• 视频永远不会被过滤，只有图像

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

对于音频提取：

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

⚙️ 需求

• Python 3.10+
• Comfy用户界面
• 图库dl（自动安装）
• yt-dlp（自动安装）
• FFmpeg（可选，用于音频提取）

📄 许可证

版权所有（c）2025埃里克·希斯。保留所有权利。

双重许可证：

• 非商业用途： 根据以下许可 知识共享署名-非商业4.0国际许可（CC BY-NC 4.0）
• 商业用途： 需要单独的商业许可证。联系人：eric@historic.camera或eric@rollei.us

看 许可证.md 完整条款。

第三方工具

• 画廊dl （GNU GPL v2）作者：Mike Fährmann：https://github.com/mikf/gallery-dl
• yt-dlp （无许可/公共领域）：https://github.com/yt-dlp/yt-dlp

看 CREDITS.md 获取完整的依赖关系列表。

👥 贡献

欢迎投稿！看 贡献.md 作为指导方针。

📧 联系

• 作者 埃里克·希斯
• github： EricRollei
• 电子邮件： eric@historic.camera, eric@rollei.us

🙏 致谢

• Comfy用户界面 平台社区
• 迈克 费尔曼 画廊dl
• yt-dlp 优秀视频下载器的贡献者

______________________________________________________________________

准备下载！ 🚀 将节点添加到您的工作流程中，并开始从网络上下载媒体。