이 프로젝트는 JM을 크롤링하기 위한 Python API를 캡슐화한 것입니다.

몇 줄의 간단한 Python 코드만으로 JM의 앨범을 로컬로 원활하게 다운로드할 수 있으며, 이미지 또한 모두 처리된 상태입니다.

🧭 빠른 가이드

• 튜토리얼: GitHub Actions를 사용하여 다운로드하기
• 튜토리얼: 즐겨찾기 데이터를 내보내고 다운로드하기
• 튜토리얼: 다운로드 후 PDF / ZIP / 긴 이미지로 변환하기
• 타워 브로드캐스트: 기장 여러분의 소스 코드 기여와 동참을 환영합니다

안내: JM 서버의 부하를 줄이기 위해 한 번에 너무 많은 앨범을 다운로드하지 말아주세요 🙏🙏🙏

🗺️ 펼쳐 보기: JMComic 기능 아키텍처 한눈에 보기

프로젝트 소개

본 프로젝트의 핵심 기능은 앨범 다운로드입니다.

이를 기반으로 사용하기 쉽고 확장성이 뛰어나며 일부 특수한 다운로드 요구를 충족할 수 있는 프레임워크가 설계되었습니다.

현재 핵심 기능은 꽤 안정적으로 동작하며, 프로젝트는 유지보수 단계에 있습니다.

다운로드 기능 외에도, 필요한 경우에 한해 추가적인 JM 인터페이스가 구현되어 있습니다. 기존 기능들은 아래와 같습니다:

• 로그인
• 앨범 검색 (모든 검색 매개변수 지원)
• 앨범 댓글 가져오기 (답글 및 스포일러 표시 포함)
• 카테고리 / 랭킹
• 앨범 / 챕터(에피소드) 세부 정보 가져오기
• 이미지 다운로드 및 복호화
• 개인 즐겨찾기
• 인터페이스 암호화 및 복호화 (APP API)

설치 가이드

⚠ Python이 시스템에 설치되어 있지 않다면, 다음 단계를 진행하기 전에 먼저 Python 공식 사이트 에서 다운로드하여 설치해주시기 바랍니다. Python 3.14 사용을 권장합니다

• 공식 pip 저장소를 통한 설치 (추천. 업데이트 명령어도 동일합니다)

  pip install jmcomic -U
  

• 소스코드를 이용한 설치

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

빠른 시작

1. 앨범 다운로드하기

아래의 간단한 코드를 사용하면 JM123 앨범의 모든 챕터 이미지를 다운로드할 수 있습니다:

import jmcomic  # 이 모듈을 임포트합니다. 사전 설치 필요.
jmcomic.download_album('123')  # 다운로드하려는 앨범의 ID를 함수에 넘겨 로컬에 저장합니다.

위에 보이는 download_album 메서드는 구성 항목을 제어하는 부가적인 option 매개변수를 지원합니다. (예: JM 도메인, 네트워크 프록시, 이미지 포맷 변환, 플러그인 등)

사용자 환경에 맞게 이러한 구성 옵션이 필요할 수도 있습니다. 구성 파일로 옵션을 만들고 이를 사용하여 다운로드하는 것을 권장합니다. 아래의 챕터를 참고하세요:

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. 커맨드라인 (명령줄) 사용법

앨범만을 다운로드 하려면 위에서 말한 방법보다 이렇게 사용하는 것이 훨씬 편하고 직관적입니다.

예를 들어 윈도우에서는 단순하게 Win+r 단축키를 이용해 jmcomic xxx 를 타이핑하고 앨범을 즉시 내려받을 수 있습니다.

예시:

123번 앨범을 다운로드 하는 명령어

jmcomic 123

123번 앨범의 456번 챕터 이미지를 다운로드 하는 명령어

jmcomic 123 p456

커맨드라인 모드에서는 임의의 Option을 통한 커스텀 설정을 지원합니다. 환경변수나 명령어 인자를 설정할 수 있습니다:

a. 명령줄 매개변수 --option을 사용해 파일 경로를 지정

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

b. 환경 변수 JM_OPTION_PATH 를 옵션 파일명으로 설정 (권장)

환경 변수는 구글링을 통하거나 powershell 터미널에서 다음을 쳐서 만들 수 있습니다: setx JM_OPTION_PATH "D:/a.yml" 설정 후에는 다시 작동해야 적용이 됩니다.

jmcomic 123

4. 앨범 세부 정보 확인 (jmv 명령어)

jmv 명령어는 앨범을 다운로드하지 않고 세부 정보를 빠르게 확인할 때 사용합니다.

적용 시나리오: 특정 웹사이트에서 알 수 없는 작품 번호를 발견하고 어떤 앨범인지 빠르게 확인하고 싶을 때. 원본 텍스트를 복사한 후 Win+R을 누르고 jmv [붙여넣은 내용]을 입력하면 됩니다.

임의의 텍스트에서 숫자만 추출하여 번호로 인식할 수 있어 다양한 형태의 텍스트를 바로 붙여넣기에 편리합니다.

예시:

# 번호를 직접 입력
jmv 350234

# 텍스트가 섞인 내용에서 숫자만 추출 (350234 추출)
jmv 350이거안본사람234

# option 파일 지정 (환경 변수도 지원, 사용법은 위와 동일)
jmv 350234 --option="D:/a.yml"

# -y 매개변수: 실행 완료 후 Enter 키를 눌러 확인할 필요 없이 바로 종료
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)
──────────────────────────────────────────────────

[실행 종료] 창을 닫으려면 Enter 키를 누르세요... (다음 번에는 -y 매개변수를 추가하여 확인을 건너뛸 수 있습니다)

활용법

자세한 활용 문서를 원하시면 문서 사이트로 접속하세요 → jmcomic.readthedocs.io

(힌트: jmcomic은 다양한 다운로드 설정 항목을 제공합니다. 대부분의 다운로드 요구 사항과 관련된 구성 항목 및 플러그인을 쉽게 찾을 수 있을 것입니다.)

프로젝트의 특징

• Cloudflare 크롤러 방지 수칙 우회

• 금만(1.6.3) APP 인터페이스 최근의 암호화/복호화 알고리즘 완벽 지원

• Async 및 Sync 두 가지 API 지원

• 다양한 사용 방법:

  • GitHub Actions: 웹페이지 내 바로 앨범 ID를 통하여 받을 수 있습니다. (튜토리얼：GitHub Actions를 이용해 다운로드)
  • 커맨드라인: 파이썬 코드를 짤 필요 없이 단순합니다. (튜토리얼：명령줄을 이용해 다운로드)
  • Python 코드 구현: 가장 직관적이고 강력하며 최소한의 파이썬 기반 지식이 필요합니다.

• 웹 인터페이스 및 모바일 인터페이스 지원. 간단한 구성을 통한 전환 지원. (모바일 구동환경에서의 IP제한을 돌파하고 뛰어난 호환이 됩니다, 웹은 특정 지역에서 제약받지만 성능은 최고입니다.)

• 자동 재접속(Retry) 및 도메인 전환 구조 기본지원

• 다운로드 작업 단위의 구조화된 로그 수집 지원

• 멀티스레드 다운로드 (1이미지 당 1스레드를 통한 극단적인 빠른 스피드)

• 강력한 구성 옵션

  • 환경 구성 없이도 매우 편하게 즐길 수 있습니다.
  • 각종 파일 포맷 종류 지원
  • 구성 가능 요소: 요청된 도메인 네임 클라이언트 구현체 디스크 캐시 사용 여부 동시에 다운로드 할 파일의 개수 포맷 바꾸기 규칙적으로 이미지 저장하기 요청용 메타데이터정보들(headers, cookies, proxies) 중국어 간체/번체 변환 등등

• 자율성 확보 (Extensible)

  • 챕터/이미지의 다운로드 전, 다운로드 후의 콜백 기능 및 커스텀 함수 동작.
  • 여러 사용자 정의 클래스를 구성하도록 개방: Downloader (스케줄 관리) Option (구성 관리) Client (요청 관리) Entity 생성 및 등등.
  • 사용자 맞춤형 로거, 에러 감지기 시스템
  • 플러그인 확장을 지원하며, 현재 21개의 실용적인 플러그인을 내장하고 있습니다. 다운로드 진행률 표시, 이미지 PDF 병합, 긴 이미지 이어 붙이기, ZIP/7z 압축, 브라우저 쿠키 가져오기, 앨범 업데이트 구독, 즐겨찾기 내보내기, 표지 다운로드 등을 제공합니다.

사용 팁

• Python 3.14를 권장하며, 현재 CI는 Python 3.10 이상만 대상으로 합니다.

  [!NOTE] Python 3.9 및 이전 버전은 모두 공식 지원이 종료(EOL)되었으므로 3.9 이하 버전을 사용할 경우 언제든 서드파티 라이브러리 호환성 문제에 부딪힐 수 있습니다. Python 3.9는 설치 호환성을 유지하지만 더 이상 CI 대상에는 포함되지 않습니다.

• 여유 시간에 만들어 지는 프로젝트이기에 정보나 활용 코드의 늦은 갱신이 다분합니다. 이슈(Issue)페이지로 연락주시기 바랍니다!

프로젝트 폴더 안내

• .github: GitHub Actions 구성 파일
• assets: 코드가 아닌 관련 리소스
  • docs: 상세 가이드 및 관련 프로젝트 설명 문서
  • option: 설정 샘플 예제
• src: 실용 소스코드 폴더
  • jmcomic: jmcomic 핵심 모듈
• tests: 유닛 테스트 패키지 구조, 자동화 테스트
• usage: 실사용 시 참조하면 좋은 활용 구조

이하 프로젝트들에 감사드립니다.

이미지 복구/분할 알고리즘 & JM 모바일 API 호환

jmcomic을 사용하는 프로젝트

관련 프로젝트

jmcomic을 기반으로 제가 만든 3개의 관련 프로젝트: 로컬 감상, AI 연동, Android APK 아카이브

프로젝트	소개
	📖 로컬 만화 뷰어 다운로드한 만화를 브라우저로 감상합니다. 세로 스크롤 / 단면 / 연속 양면 보기와 LAN을 통한 스마트폰 감상을 지원합니다. 🚀 pip install jm-view-server && jms
	🤖 Skills & MCP 연동 Skills + CLI 및 MCP 두 가지 경로로 Claude Code / Codex 등에 연결합니다. 번호나 설정을 외울 필요 없이 자연어로 검색, 댓글 확인, PDF 변환 다운로드까지 처리합니다. 🚀 pip install jmcomic-ai · 연동 가이드 보기
	📱 공식 모바일 APK 자동 트래커 jmcomic 기반으로 GitHub Actions가 공식 Android 클라이언트를 주기적으로 확인하고, 최신 공식 APK를 Releases에 자동 보관합니다 (iOS 설치 안내 포함). 🚀 Releases에서 최신 APK 다운로드

Star History