Kmoe Manga Downloader
Download manga from Kmoe (kxx.moe / mox.moe) as EPUB or MOBI files using the kmdr CLI.
Prerequisite: This skill requires the kmdr command-line tool. Install it with:
> pip install kmoe-manga-downloader
>
Requires Python >= 3.9.
When to Use This Skill
Activate when the user:
- - Wants to download manga from Kmoe / kxx.moe / mox.moe
- Asks to batch-download manga volumes
- Needs to manage Kmoe account credentials or credential pools
- Wants to automate post-download actions (e.g., move files, send notifications)
Quick Start
CODEBLOCK1
Commands
Authentication
CODEBLOCK2
Download
CODEBLOCK3
Required flags:
- -
-l, --book-url — Manga homepage URL on Kmoe - INLINECODE3 — Volume selection:
1,2,3 or 1-5,8 or INLINECODE6
Common options:
| Flag | Description | Default |
|---|
| INLINECODE7 | Download directory | config or current dir |
| INLINECODE8 |
Volume type:
vol,
extra,
seri,
all |
vol |
|
-f, --format | Output format:
epub or
mobi |
epub |
|
-r, --retry | Retry attempts on failure |
3 |
|
-m, --method | Download method:
1 or
2 |
1 |
|
--num-workers | Concurrent download workers |
8 |
|
-P, --use-pool | Use credential pool with failover | off |
|
-p, --proxy | Proxy server address | none |
|
-c, --callback | Post-download callback script | none |
Configuration
CODEBLOCK4
Credential Pool
Manage multiple accounts for failover when one account's quota is exhausted.
CODEBLOCK5
Examples
Download specific volumes
CODEBLOCK6
Download all extras as MOBI
CODEBLOCK7
Download with callback
Post-download callbacks support template variables:
- -
{v.name} — Volume name - INLINECODE30 — Page count
- INLINECODE31 — File size
- INLINECODE32 — Book/manga name
- INLINECODE33 — Author name
CODEBLOCK8
Use credential pool for large batch
CODEBLOCK9
Download via proxy
CODEBLOCK10
Error Handling
| Problem | Solution |
|---|
| Not logged in | Run kmdr login -u <username> first |
| Download quota exhausted |
Use
--use-pool with multiple accounts, or wait for quota reset |
| Network timeout | Increase
--retry count, or set a proxy with
-p |
| Volumes not found | Check
-t flag — the volume may be under
extra or
seri type |
| Mirror unavailable | Switch mirror with
kmdr config -b https://mox.moe |
Tips
- - Set defaults once: Use
kmdr config --set dest=~/manga proxy=http://localhost:7890 to avoid repeating flags - Credential pool: For large downloads, set up multiple accounts with
kmdr pool add to avoid hitting quota limits - Volume types: Manga on Kmoe may have
vol (main volumes), extra (bonus chapters), and seri (serialized chapters) — use -t all to get everything - Callback automation: Use callbacks to trigger file organization, notifications, or syncing after each volume downloads
Kmoe 漫画下载器
使用 kmdr 命令行工具从 Kmoe（kxx.moe / mox.moe）下载漫画为 EPUB 或 MOBI 文件。
前置条件：此技能需要 kmdr 命令行工具。通过以下命令安装：
bash
pip install kmoe-manga-downloader
需要 Python >= 3.9。
何时使用此技能
当用户出现以下情况时激活：
- - 想要从 Kmoe / kxx.moe / mox.moe 下载漫画
- 要求批量下载漫画卷册
- 需要管理 Kmoe 账户凭据或凭据池
- 想要自动化下载后操作（例如移动文件、发送通知）
快速开始
bash
1. 登录 Kmoe
kmdr login -u <用户名> -p <密码>
2. 下载漫画第 1-3 卷
kmdr download -l https://kxx.moe/c/50076.htm -v 1-3 -d ~/manga
命令
身份验证
bash
登录（省略密码时将提示输入）
kmdr login -u <用户名> [-p <密码>]
检查账户状态和下载配额
kmdr status
下载
bash
kmdr download -l <书籍链接> -v <卷册> [选项]
必需参数：
- - -l, --book-url — Kmoe 上的漫画主页 URL
- -v, --volume — 卷册选择：1,2,3 或 1-5,8 或 all
常用选项：
| 参数 | 描述 | 默认值 |
|---|
| -d, --dest | 下载目录 | 配置或当前目录 |
| -t, --vol-type |
卷册类型：vol、extra、seri、all | vol |
| -f, --format | 输出格式：epub 或 mobi | epub |
| -r, --retry | 失败重试次数 | 3 |
| -m, --method | 下载方式：1 或 2 | 1 |
| --num-workers | 并发下载线程数 | 8 |
| -P, --use-pool | 使用凭据池并启用故障转移 | 关闭 |
| -p, --proxy | 代理服务器地址 | 无 |
| -c, --callback | 下载后回调脚本 | 无 |
配置
bash
设置默认选项
kmdr config --set proxy=http://localhost:7890 dest=~/manga
列出当前配置
kmdr config -l
清除所有配置
kmdr config -c all
切换镜像源
kmdr config -b https://mox.moe
凭据池
管理多个账户，当某个账户配额耗尽时自动切换。
bash
添加账户到池中
kmdr pool add -u <用户名> [-o <优先级>] [-n 备注]
列出池中账户（可选刷新配额）
kmdr pool list [-r] [--num-workers 3]
切换活动账户
kmdr pool use <用户名>
更新账户信息
kmdr pool update <用户名> [-n 备注] [-o <优先级>]
从池中移除账户
kmdr pool remove <用户名>
示例
下载指定卷册
bash
kmdr download -d ~/manga -l https://kxx.moe/c/50076.htm -v 1-5
下载所有番外篇为 MOBI 格式
bash
kmdr download -l https://kxx.moe/c/50076.htm -t extra -v all -f mobi
使用回调下载
下载后回调支持模板变量：
- - {v.name} — 卷册名称
- {v.page} — 页数
- {v.size} — 文件大小
- {b.name} — 书籍/漫画名称
- {b.author} — 作者名称
bash
kmdr download -l https://kxx.moe/c/50076.htm -v 1-3 \
--callback echo {b.name} - {v.name} done! >> ~/kmdr.log
使用凭据池进行大批量下载
bash
kmdr pool add -u user1 -o 1 -n 主账户
kmdr pool add -u user2 -o 2 -n 备用账户
kmdr download -l https://kxx.moe/c/50076.htm -v all --use-pool
通过代理下载
bash
kmdr download -l https://kxx.moe/c/50076.htm -v 1-10 -p http://localhost:7890
错误处理
| 问题 | 解决方案 |
|---|
| 未登录 | 先运行 kmdr login -u <用户名> |
| 下载配额耗尽 |
使用 --use-pool 配合多个账户，或等待配额重置 |
| 网络超时 | 增加 --retry 次数，或使用 -p 设置代理 |
| 找不到卷册 | 检查 -t 参数——卷册可能属于 extra 或 seri 类型 |
| 镜像不可用 | 使用 kmdr config -b https://mox.moe 切换镜像 |
提示
- - 一次性设置默认值：使用 kmdr config --set dest=~/manga proxy=http://localhost:7890 避免重复输入参数
- 凭据池：对于大批量下载，使用 kmdr pool add 设置多个账户以避免触及配额限制
- 卷册类型：Kmoe 上的漫画可能有 vol（主卷）、extra（番外篇）和 seri（连载章节）——使用 -t all 获取全部内容
- 回调自动化：使用回调在每个卷册下载完成后触发文件整理、通知或同步操作
