Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

感谢以下项目

图片分割算法代码+禁漫移动端API

Python API For JMComic (禁漫天堂)

本项目封装了一套可用于爬取JM的Python API.

你可以通过简单的几行Python代码，实现下载JM上的本子到本地，并且是处理好的图片。

【指路】教程：使用GitHub Actions下载禁漫本子

【指路】教程：导出并下载你的禁漫收藏夹数据

友情提示：珍爱JM，为了减轻JM的服务器压力，请不要一次性爬取太多本子，西门🙏🙏🙏.

项目介绍

本项目的核心功能是下载本子。

基于此，设计了一套方便使用、便于扩展，能满足一些特殊下载需求的框架。

目前核心功能实现较为稳定，项目也处于维护阶段。

除了下载功能以外，也实现了其他的一些禁漫接口，按需实现。目前已有功能：

登录
搜索本子（支持所有搜索项）
图片下载解码
分类/排行榜
本子/章节详情
个人收藏夹
接口加解密（APP的接口）

安装教程

⚠如果你没有安装过Python，需要先安装Python再执行下面的步骤，且版本需要>=3.7（点我去python官网下载）

通过pip官方源安装（推荐，并且更新也是这个命令）
```
pip install jmcomic -i https://pypi.org/project -U
```

通过源代码安装

pip install git+https://github.com/hect0x7/JMComic-Crawler-Python

快速上手

1. 下载本子方法

只需要使用如下代码，就可以下载本子JM422866的所有章节的图片：

importjmcomic# 导入此模块，需要先安装.jmcomic.download_album('422866') # 传入要下载的album的id，即可下载整个album到本地.

上面的 download_album方法还有一个参数option，可用于控制下载配置，配置包括禁漫域名、网络代理、图片格式转换、插件等等。

你可能需要这些配置项。推荐使用配置文件创建option，用option下载本子，见下章：

2. 使用option配置来下载本子

首先，创建一个配置文件，假设文件名为 option.yml
该文件有特定的写法，你需要参考这个文档 → 配置文件指南
下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
image:
suffix: .png # 该配置用于把下载的图片转为png格式

第二步，运行下面的python代码

importjmcomic# 创建配置对象option=jmcomic.create_option_by_file('你的配置文件路径，例如 D:/option.yml')
# 使用option对象来下载本子jmcomic.download_album(422866, option)
# 等价写法: option.download_album(422866)

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接
例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。

示例：

下载本子422866的命令

jmcomic 422866

同时下载本子123, 章节456的命令

jmcomic 123 p456

命令行模式也支持自定义option，你可以使用环境变量或者命令行参数：

a. 通过命令行--option参数指定option文件路径

jmcomic 123 --option="D:/a.yml"

b. 配置环境变量 JM_OPTION_PATH 为option文件路径（推荐）

# set JM_OPTION_PATH="D:/a.yml"
jmcomic 123

进阶使用

请查阅文档首页→jmcomic.readthedocs.io

（提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）

项目特点

绕过Cloudflare的反爬虫
实现禁漫APP接口最新的加解密算法 (1.6.3)
用法多样：
- GitHub Actions：网页上直接输入本子id就能下载（教程：使用GitHub Actions下载禁漫本子）
- 命令行：无需写Python代码，简单易用（教程：使用命令行下载禁漫本子）
- Python代码：最本质、最强大的使用方式，需要你有一定的python编程基础
支持网页端和移动端两种客户端实现，可通过配置切换（移动端不限ip兼容性好，网页端限制ip地区但效率高）
支持自动重试和域名切换机制
多线程下载（可细化到一图一线程，效率极高）
可配置性强
- 不配置也能使用，十分方便
- 配置可以从配置文件生成，支持多种文件格式
- 配置点有：请求域名客户端实现是否使用磁盘缓存同时下载的章节/图片数量图片格式转换下载路径规则请求元信息（headers,cookies,proxies） 等
可扩展性强
- 支持自定义本子/章节/图片下载前后的回调函数
- 支持自定义类：Downloader（负责调度）Option（负责配置）Client（负责请求）实体类等
- 支持自定义日志、异常监听器
- 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前内置插件有：
  - 登录插件
  - 硬件占用监控插件
  - 只下载新章插件
  - 压缩文件插件
  - 下载特定后缀图片插件
  - 发送QQ邮件插件
  - 自动使用浏览器cookies插件
  - jpg图片合成为一个pdf插件
  - 导出收藏夹为csv文件插件
  - 合并所有图片为pdf文件插件
  - 合并所有图片为长图插件

使用小说明

Python >= 3.7
个人项目，文档和示例会有不及时之处，可以Issue提问

项目文件夹介绍

.github：GitHub Actions配置文件
assets：存放一些非代码的资源文件
- docs：项目文档
- option：存放配置文件
src：存放源代码
- jmcomic：jmcomic模块
tests：测试目录，存放测试代码，使用unittest
usage：用法目录，存放示例/使用代码

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
src/jmcomic		src/jmcomic
tests/test_jmcomic		tests/test_jmcomic
usage		usage
.gitignore		.gitignore
.readthedocs.yaml		.readthedocs.yaml
LICENSE		LICENSE
README.md		README.md
requirements-dev.txt		requirements-dev.txt
setup.py		setup.py

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
src/jmcomic		src/jmcomic
tests/test_jmcomic		tests/test_jmcomic
usage		usage
.gitignore		.gitignore
.readthedocs.yaml		.readthedocs.yaml
LICENSE		LICENSE
README.md		README.md
requirements-dev.txt		requirements-dev.txt
setup.py		setup.py

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
src/jmcomic		src/jmcomic
tests/test_jmcomic		tests/test_jmcomic
usage		usage
.gitignore		.gitignore
.readthedocs.yaml		.readthedocs.yaml
LICENSE		LICENSE
README.md		README.md
requirements-dev.txt		requirements-dev.txt
setup.py		setup.py

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
src/jmcomic		src/jmcomic
tests/test_jmcomic		tests/test_jmcomic
usage		usage
.gitignore		.gitignore
.readthedocs.yaml		.readthedocs.yaml
LICENSE		LICENSE
README.md		README.md
requirements-dev.txt		requirements-dev.txt
setup.py		setup.py

Name		Name	Last commit message	Last commit date
.github		.github
assets		assets
src/jmcomic		src/jmcomic
tests/test_jmcomic		tests/test_jmcomic
usage		usage
.gitignore		.gitignore
.readthedocs.yaml		.readthedocs.yaml
LICENSE		LICENSE
README.md		README.md
requirements-dev.txt		requirements-dev.txt
setup.py		setup.py

Latest commit

History

Folders and files

Repository files navigation

Python API For JMComic (禁漫天堂)

项目介绍

安装教程

快速上手

1. 下载本子方法

2. 使用option配置来下载本子

3. 使用命令行

进阶使用

项目特点

使用小说明

项目文件夹介绍

感谢以下项目

图片分割算法代码+禁漫移动端API

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Python API For JMComic (禁漫天堂)

项目介绍

安装教程

快速上手

1. 下载本子方法

2. 使用option配置来下载本子

3. 使用命令行

进阶使用

项目特点

使用小说明

项目文件夹介绍

感谢以下项目

图片分割算法代码+禁漫移动端API

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Python API For JMComic (禁漫天堂)

项目介绍

安装教程

快速上手

1. 下载本子方法

2. 使用option配置来下载本子

3. 使用命令行

进阶使用

项目特点

使用小说明

项目文件夹介绍

感谢以下项目

图片分割算法代码+禁漫移动端API

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History