Python API for JMComic | 提供Python API访问禁漫天堂,同时支持网页端和移动端 | 禁漫天堂GitHub Actions下载器🚀
Go to file
2023-09-02 14:17:23 +08:00
.github/workflows v2.2.2: 实现两个内置插件:find_update和zip,优化文档和代码示例 (#118) (#95) 2023-08-31 17:30:12 +08:00
assets v2.2.3: 实现DirRule文件夹规则支持调用env环境变量,优化文档和代码示例 (#119) 2023-09-01 17:00:05 +08:00
src/jmcomic v2.2.4: 优化搜本API,增加本子类的字段和对应的正则表达式(喜欢数、观看数、评论数、作品、登场人物) (#121) 2023-09-02 14:17:23 +08:00
tests/test_jmcomic v2.2.4: 优化搜本API,增加本子类的字段和对应的正则表达式(喜欢数、观看数、评论数、作品、登场人物) (#121) 2023-09-02 14:17:23 +08:00
usage v2.2.4: 优化搜本API,增加本子类的字段和对应的正则表达式(喜欢数、观看数、评论数、作品、登场人物) (#121) 2023-09-02 14:17:23 +08:00
.gitignore init commit 2023-04-02 22:19:44 +08:00
LICENSE init commit 2023-04-02 22:19:44 +08:00
README.md v2.2.2: 实现两个内置插件:find_update和zip,优化文档和代码示例 (#118) (#95) 2023-08-31 17:30:12 +08:00
requirements-dev.txt v2.2.1: 新增一个插件能够实时监控硬件占用率,优化插件配置语法,更新文档 (#117) 2023-08-31 10:38:21 +08:00
setup.py v2.1.14: 增加文档和代码示例,优化代码集中配置 (#99) 2023-08-22 16:54:45 +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 -e ./
    

快速上手

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

import jmcomic  # 导入此模块,需要先安装.
jmcomic.download_album('422866')  # 传入要下载的album的id即可下载整个album到本地.
# 上面的这行代码还有一个可选参数option: JmOption表示配置项
# 配置项的作用是告诉程序下载时候的一些选择,
# 比如,要下载到哪个文件夹,使用怎样的路径组织规则(比如[/作者/本子id/图片] 或者 [/作者/本子名称/图片].
# 如果没有配置,则会使用 JmOption.default(),下载的路径是[当前工作文件夹/本子名称/图片].
# 如果你想要配置,请参考文件 assets/config/常用配置介绍.yml

进阶使用

进阶使用可以参考本repo下usage文件夹内的示例代码文件下面是各个文件的作用你可以挑感兴趣的阅读

  • API上手介绍: getting_started.py
  • 使用API实现简单功能: usage_simple.py
  • 演示jmcomic模块的可自定义功能点: usage_custom.py
  • 使用API的Filter过滤功能: usage_feature_filter.py
  • 演示jmcomic模块的Plugin插件体系: usage_feature_plugin.py
  • 演示一个综合使用实例: usage_advanced.py
    • 包括6个功能需求的介绍、实现方案和完整运行日志
    • 实现方案非常简洁充分jmcomic的便利性以及强大的插件扩展机制

以及一些趣味用法:

  • 测试你的ip可以访问哪些禁漫域名: pick_domain.py
  • 基于GitHub Actions下载本子: workflow_download.py

项目特点

  • 绕过Cloudflare的反爬虫
  • 支持使用GitHub Actions下载本子网页上直接输入本子id就能下载教程使用GitHub Actions下载禁漫本子
  • 可配置性强
    • 不配置也能使用,十分方便
    • 配置可以从配置文件生成支持多种文件格式无需写Python代码
    • 配置点有:是否使用磁盘缓存 并发下载图片数 图片类型转换 下载路径 请求元信息headers,cookies,proxies
  • 可扩展性强
    • 支持Plugin插件可以方便地扩展功能以及使用别人的插件
      • 目前内置支持的插件有:登录插件 硬件占用监控插件 只下载新章插件 压缩文件插件
    • 支持自定义本子/章节/图片下载前后的回调函数
    • 支持自定义debug日志的开关/格式
    • 支持自定义Downloader/Option/Client/实体类
    • ......
  • 支持自动重试和域名切换机制
  • 多线程下载(可细化到一图一线程,效率极高)
  • 跟进了JM最新的图片分割算法2023-02-08

使用小说明

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

项目文件夹介绍

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

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

    • jmcomicjmcomic模块
  • tests测试目录存放测试代码使用unittest

  • usage用法目录存放示例/使用代码

感谢以下项目

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

Readme Card