JMComic-Crawler-Python is an MIT-licensed Python package that turns the JMComic (禁漫天堂) web and mobile endpoints into a single importable API, so Python developers, script authors and GitHub Actions users can download albums, chapters and favourites locally without writing their own scraper.

What it is

The project is a Python library and command-line tool, published on PyPI as jmcomic, that wraps the JMComic site into a consistent interface covering both the web front end and the mobile app. Its core function is downloading albums and chapters, and around that core the author designed a configurable framework meant to be easy to adopt and easy to extend for special download needs. Beyond downloading, it implements a set of other JM interfaces as needed: login, search across all search fields, comments including replies and spoiler flags, category and ranking listings, album and chapter detail, image download and decoding, personal favourites, and encryption/decryption for the app API.

The concrete problem it solves is the hand-rolled scraper. Anyone who wanted a JM album locally previously had to reverse-engineer request signing, pagination, image packaging and decoding, then maintain that code as the site changed. This package replaces that ad-hoc scraping layer with a maintained API and a declarative configuration file. The README states the core functionality is stable and the project is in a maintenance phase, with documentation hosted on Read the Docs.

Key capabilities

• Download an entire album with one call: jmcomic.download_album('123'), or run it asynchronously with jmcomic.download_album_async('123').
• Configure behaviour through an option.yml file built with jmcomic.create_option_by_file(), controlling the JM domain, network proxy, image format conversion such as a .png suffix, and plugins.
• Drive downloads from the shell with the jmcomic command, for example jmcomic 123 for an album or jmcomic 123 p456 for a specific chapter, passing --option="D:/a.yml" or setting the JM_OPTION_PATH environment variable.
• Inspect metadata without downloading using the jmv command, which accepts a raw album number or extracts the first numeric ID from arbitrary pasted text.
• Export downloaded material to PDF, ZIP or long images, and export a personal favourites collection.
• Run the whole download in GitHub Actions, with a dedicated tutorial in the repository for that workflow.
• Show a download progress bar in the terminal after installing the optional rich dependency.

Who uses it and how

• GitHub Actions users who want scheduled or on-demand downloads without keeping a machine running, following the repository's Actions tutorial.
• Python developers embedding the library into their own scripts, using either the synchronous download_album call or the asyncio-based entry point for concurrent work.
• Windows desktop users who keep an option file path in JM_OPTION_PATH and launch jmcomic or jmv directly from the Run dialog.
• Users managing a collection, who export their JM favourites, then convert the results to PDF, ZIP or long images for offline reading.
• Terminal users who only need to identify an album from a number seen elsewhere, using jmv rather than a full download.

Getting started

Install from PyPI with pip install jmcomic -U, or from source with pip install git+https://github.com/hect0x7/JMComic-Crawler-Python; the README recommends Python 3.14.

How it compares

No comparable or paid alternatives are named in the facts supplied for this page, so the project stands alone in this registry. Its distinguishing properties are its MIT licence, its availability as a PyPI package rather than a hosted service, and the fact that everything runs on infrastructure the user controls.

When to use it — and when not to

A self-hoster operates nothing beyond a Python environment, but must supply their own option.yml, choose a working JM domain, and configure a proxy if their network needs one; no database or mail service is involved. Anyone who wants a hosted service, a graphical application or vendor support with a service-level agreement should not choose this, and non-Python stacks get less value from a library whose primary interface is a Python API and a pip install. The honest limitations are that the documentation and README are written mainly in Chinese, the project describes itself as being in a maintenance phase rather than active feature development, and the README explicitly asks users not to crawl too many albums at once in order to reduce load on JM's servers.

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:
  image:
    suffix: .png # 该配置用于把下载的图片转为png格式

import jmcomic

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

jmcomic 123

jmcomic 123 p456

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

# 直接输入车号
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 参数跳过确认)