Python API for JMComic

简体中文 • English • 日本語 • 한국어

提供 Python API 访问禁漫天堂（网页端 & 移动端），集成 GitHub Actions 下载器🚀

GitHub Stars Forks GitHub latest releases PyPI - Downloads Licence

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

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

🧭 快速指路

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

introduction.jpg

项目介绍

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

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

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

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

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

安装教程

⚠如果你没有安装过 Python，需要先前往 Python 官网下载 再执行以下步骤。 推荐使用 Python 3.12及以上版本

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

    pip install jmcomic -U

  • 通过源代码安装

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

快速上手

1. 下载本子方法

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

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

# 也可以使用 Async API (详见教程: https://jmcomic.readthedocs.io/zh-cn/latest/tutorial/14_async_usage/)
import asyncio
asyncio.run(jmcomic.download_album_async('123'))

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

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

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

  1. 首先，创建一个配置文件，假设文件名为 option.yml

    该文件有特定的写法，你需要参考这个文档 → 配置文件指南

    下面做一个演示，假设你需要把下载的图片转为png格式，你应该把以下内容写进option.yml

download:
  image:
    suffix: .png # 该配置用于把下载的图片转为png格式
  1. 第二步，运行下面的python代码
import jmcomic

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

3. 使用命令行

如果只想下载本子，使用命令行会比上述方式更加简单直接

例如，在windows上，直接按下 win+R 键，输入jmcomic xxx就可以下载本子。

示例：

下载本子123的命令

jmcomic 123

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

jmcomic 123 p456

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

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

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

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

请自行google配置环境变量的方式，或使用powershell命令: setx JM_OPTION_PATH "D:/a.yml" 重启后生效

jmcomic 123

4. 查看本子详情（jmv 命令）

jmv 命令用于快速查看本子详情，不做下载。

适用场景：在某些网站上看到一串神秘车号，想快速看看具体是啥本子。此时只需copy原文本，按下 win+R，输入jmv [粘贴内容]即可

支持从任意文本中提取数字作为车号，方便直接粘贴各种格式的车号。

示例：

# 直接输入车号
jmv 350234

# 从混合文本中提取数字（提取出 350234）
jmv 350谁还没看过234

# 指定option文件（也支持环境变量，用法同上）
jmv 350234 --option="D:/a.yml"

# -y 参数：执行完毕后直接退出，无需按回车确认
jmv 350234 -y

输出效果：

🔍 正在查询 禁漫车号 - [350234] 的详情...

──────────────────────────────────────────────────
  📖 标题:  xxx
  🆔 ID:    JM350234
  🔗 链接:  https://18comic.vip/album/350234/
  ✍️ 作者:  Author1, Author2
──────────────────────────────────────────────────
  📅 发布日期:  2022-06-15
  📅 更新日期:  2023-01-01
  📄 总页数:    50
  👀 观看:      2M
  ❤️ 点赞:     77K
  💬 评论:      9801
──────────────────────────────────────────────────
  🏷️ 标签:  标签1, 标签2, ...
  🎭 人物:  角色A, 角色B, ...
  📚 作品:  作品1, 作品2, ...
──────────────────────────────────────────────────
  📑 章节 (2):
     第1話  上  (id: 350234)
     第2話  下  (id: 350235)
──────────────────────────────────────────────────

[运行结束] 请按回车键关闭窗口... (下次运行可附加 -y 参数跳过确认)

进阶使用

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

或者查看github仓库的文档 → github-repo-docs

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

项目特点

  • 绕过Cloudflare的反爬虫

  • 实现禁漫APP接口最新的加解密算法 (1.6.3)

  • 用法多样：

  • 支持 Async 和 Sync 两套 API

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

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

  • 可配置性强

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

  • 可扩展性强

    • 支持自定义本子/章节/图片下载前后的回调函数
    • 支持自定义类：Downloader（负责调度） Option（负责配置） Client（负责请求） 实体类等
    • 支持自定义日志、异常监听器
    • 支持Plugin插件，可以方便地扩展功能，以及使用别人的插件，目前核心内置插件有：
      • 登录插件、只下载新章插件、导出收藏夹为csv文件插件
      • 合并所有图片为pdf文件插件、合并所有图片为长图png插件
      • 压缩文件插件、自动获取浏览器cookies插件、订阅更新插件等

使用小说明

  • 推荐使用 Python 3.12+，目前最低兼容版本为3.9。

    注意：Python 3.9 及更早版本皆已于 2025 年彻底结束官方生命周期 (EOL)，使用3.9及以下随时有可能遇到第三方库不兼容的问题。

  • 个人项目，文档和示例会有不及时之处，可以Issue提问。

项目文件夹介绍

  • .github：GitHub Actions配置文件

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

    • docs：项目文档
    • option：存放配置文件

  • src：存放源代码

    • jmcomic：jmcomic模块

  • tests：测试目录，存放测试代码，使用unittest

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

感谢以下项目

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

Repo Card

Project links

Data verified by PyPI on Jul 16, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.7.4)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for hect0x7 from gravatar.com hect0x7

Credits

Author: hect0x7

GitHub Statistics

Data verified by PyPI on Jul 16, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.9

Tags

python jmcomic 18comic 禁漫天堂 NSFW

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jmcomic-2.7.2.tar.gz (94.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jmcomic-2.7.2-py3-none-any.whl (98.4 kB view details)

Uploaded Python 3

File details

Details for the file jmcomic-2.7.2.tar.gz.

File metadata

  • Download URL: jmcomic-2.7.2.tar.gz
  • Upload date:
  • Size: 94.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for jmcomic-2.7.2.tar.gz
Algorithm Hash digest
SHA256 34b65459eaf80689984015e3520a3d93beb8932af2a6799b0e2f79bf5b43108e
MD5 93830ce78629baff1b30c33f66de2d7e
BLAKE2b-256 b0fc48554325489e5e39e4f0e9aef89aa591335c02a8f0210b8c1cc16c67f503

See more details on using hashes here.

Provenance

The following attestation bundles were made for jmcomic-2.7.2.tar.gz:

Publisher: release_auto.yml on hect0x7/JMComic-Crawler-Python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jmcomic-2.7.2-py3-none-any.whl.

File metadata

  • Download URL: jmcomic-2.7.2-py3-none-any.whl
  • Upload date:
  • Size: 98.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for jmcomic-2.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e1114dea54ddbf3b0bee56700c3cb5d58fbfe6159197ad8becff0b19e68ec600
MD5 9951c185b2112017574cdaff0bedca37
BLAKE2b-256 061b30f9632e3c59d814d9ea392fe79f1f1eb6294229a2c4badee24eb96f5806

See more details on using hashes here.

Provenance

The following attestation bundles were made for jmcomic-2.7.2-py3-none-any.whl:

Publisher: release_auto.yml on hect0x7/JMComic-Crawler-Python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.7.4

2 files

2.7.3

2 files

This release

2.7.2 This release

2 files

2.7.1

2 files

2.7.0

2 files

2.6.20

2 files

2.6.19

2 files

2.6.18

2 files

2.6.17

2 files

2.6.16

2 files

2.6.15

2 files

2.6.14

2 files

2.6.13

2 files

2.6.12

2 files

2.6.11

2 files

2.6.10

2 files

2.6.9

2 files

2.6.7

2 files

2.6.6

2 files

2.6.5

2 files

2.6.4

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.6.0

2 files

2.5.39

2 files

2.5.38

2 files

2.5.37

2 files

2.5.36

2 files

2.5.35

2 files

2.5.34

2 files

2.5.33

2 files

2.5.32

2 files

2.5.31

2 files

2.5.30

2 files

2.5.29

2 files

2.5.28

2 files

2.5.27

2 files

2.5.26

2 files

2.5.25

2 files

2.5.24

2 files

2.5.23

2 files

2.5.22

2 files

2.5.21

2 files

2.5.20

2 files

2.5.19

2 files

2.5.18

2 files

2.5.17

2 files

2.5.16

2 files

2.5.15

2 files

2.5.14

2 files

2.5.12

2 files

2.5.11

2 files

2.5.10

2 files

2.5.9

2 files

2.5.8

2 files

2.5.7

2 files

2.5.6

2 files

2.5.5

2 files

2.5.4

2 files

2.5.3

2 files

2.5.2

2 files

2.5.1

2 files

2.5.0

2 files

2.4.14

2 files

2.4.13

2 files

2.4.12

2 files

2.4.11

2 files

2.4.10

2 files

2.4.9

2 files

2.4.7

2 files

2.4.6

2 files

2.4.5

2 files

2.4.4

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.3.17

2 files

2.3.16

2 files

2.3.14

2 files

2.3.12

2 files

2.3.11

2 files

2.3.10

2 files

2.3.9

2 files

2.3.8

2 files

2.3.7

2 files

2.3.6

2 files

2.3.5

2 files

2.3.4

2 files

2.3.3

2 files

2.3.2

2 files

2.3.1

2 files

2.2.11

2 files

2.2.10

2 files

2.2.9

2 files

2.2.8

2 files

2.2.7

2 files

2.2.6

2 files

2.2.5

2 files

2.2.4

2 files

2.2.3

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

2 files

2.1.21

2 files

2.1.19

2 files

2.1.17

2 files

2.1.16

2 files

2.1.15

2 files

2.1.14

2 files

2.1.13

2 files

2.1.12

2 files

2.1.11

2 files

2.1.10

2 files

2.1.9

2 files

2.1.8

2 files

2.1.7

2 files

2.1.6

2 files

2.1.5

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

2.1.1

2 files

2.1.0

2 files

2.0.9

2 files

2.0.8

2 files

2.0.7

2 files

2.0.6

2 files

2.0.5

2 files

2.0.4

2 files

2.0.3

2 files

2.0.1

2 files

2.0.0

2 files

1.9.1

2 files

1.9.0

2 files

1.8.0

2 files

1.7.0

2 files

1.6.0

2 files

1.5.2

2 files

1.5.1

2 files

1.5.0

2 files

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.0

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page