Python API for JMComic | 提供Python API访问禁漫天堂,同时支持网页端和移动端 | 禁漫天堂GitHub Actions下载器🚀
Go to file
2023-10-31 02:55:33 +08:00
.github v2.3.16: 修复zip插件在album模式下的一些bug; 调整获取APP_COOKIES的位置; 一些代码优化。 (#160) 2023-10-31 02:55:33 +08:00
assets v2.3.15: 修复移动端未携带cookies导致跳转同本问题; 新增插件【debug日志主题过滤器】; 新增插件参数校验异常类及其相应的异常处理策略 (ignore, debug, raise)。 2023-10-30 21:54:34 +08:00
src/jmcomic v2.3.16: 修复zip插件在album模式下的一些bug; 调整获取APP_COOKIES的位置; 一些代码优化。 (#160) 2023-10-31 02:55:33 +08:00
tests/test_jmcomic v2.3.16: 修复zip插件在album模式下的一些bug; 调整获取APP_COOKIES的位置; 一些代码优化。 (#160) 2023-10-31 02:55:33 +08:00
usage v2.3.14: 插件支持调用环境变量,新增插件【发送QQ邮件】,优化移动端缓存scramble_id减少请求。 (#157) 2023-10-29 21:44:27 +08:00
.gitignore init commit 2023-04-02 22:19:44 +08:00
.readthedocs.yaml v2.3.10: 搭建readthedocs文档网站并迁移所有文档,新增插件—下载图片后缀过滤器,优化代码。(#152) 2023-10-23 23:57:31 +08:00
LICENSE init commit 2023-04-02 22:19:44 +08:00
README.md v2.3.15: 修复移动端未携带cookies导致跳转同本问题; 新增插件【debug日志主题过滤器】; 新增插件参数校验异常类及其相应的异常处理策略 (ignore, debug, raise)。 2023-10-30 21:54:34 +08:00
requirements-dev.txt v2.3.15: 修复移动端未携带cookies导致跳转同本问题; 新增插件【debug日志主题过滤器】; 新增插件参数校验异常类及其相应的异常处理策略 (ignore, debug, raise)。 2023-10-30 21:54:34 +08:00
setup.py v2.3.10: 搭建readthedocs文档网站并迁移所有文档,新增插件—下载图片后缀过滤器,优化代码。(#152) 2023-10-23 23:57:31 +08:00

Python API For JMComic (禁漫天堂)

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

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

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

安装教程

  • 通过pip官方源安装推荐并且更新也是这个命令

    pip install jmcomic -i https://pypi.org/project --upgrade
    
  • 通过源代码安装

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

快速上手

使用下面的两行代码即可实现功能把某个本子album里的所有章节photo下载到本地

import jmcomic  # 导入此模块,需要先安装.
jmcomic.download_album('422866')  # 传入要下载的album的id即可下载整个album到本地.
  • v2.2.9: 新增命令行调用方式,上述的代码可以转为一行命令
# 下载album_id为422866的本子
$ jmcomic 422866

项目特点

  • 绕过Cloudflare的反爬虫

  • 用法多样:

  • 支持网页端移动端两种客户端实现,可通过配置切换(移动端不限ip兼容性好网页端限制ip地区但效率高

  • 支持自动重试和域名切换机制

  • 多线程下载(可细化到一图一线程,效率极高)

  • 可配置性强

    • 不配置也能使用,十分方便
    • 配置可以从配置文件生成,支持多种文件格式
    • 配置点有:请求域名 客户端实现 是否使用磁盘缓存 同时下载的章节/图片数量 图片格式转换 下载路径规则 请求元信息headers,cookies,proxies
  • 可扩展性强

    • 支持Plugin插件可以方便地扩展功能以及使用别人的插件
      • 目前内置支持的插件有:登录插件 硬件占用监控插件 只下载新章插件 压缩文件插件 下载特定后缀图片插件 发送QQ邮件插件 日志主题过滤插件
    • 支持自定义本子/章节/图片下载前后的回调函数
    • 支持自定义debug/logging
    • 支持自定义类:Downloader负责调度 Option负责配置 Client负责请求 实体类

进阶使用

进阶使用请查阅文档:文档

下面列出一些常用的文档链接:

使用小说明

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

项目文件夹介绍

  • assets存放一些非代码的资源文件

    • config存放配置文件
    • docs项目文档
  • src存放源代码

    • jmcomicjmcomic模块
    • tests测试目录存放测试代码使用unittest
    • usage用法目录存放示例/使用代码

感谢以下项目

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

Readme Card