sunnymh-manga-dl/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Manga downloader for m.happymh.com. Reads manga URLs from manga.json and downloads chapter images into manga-content/.

Data Flow

1. Input: manga.json — JSON array of manga URLs (e.g., ["https://m.happymh.com/manga/butiange"])
2. Output: manga-content/<manga-name>/<chapter-number> <chapter-title>/*.jpg — downloaded page images
3. Metadata: manga-content/<manga-name>/detail.json — stores manga/chapter metadata

Directory Convention

manga-content/
  butiange/
    detail.json
    1 第一回/
      1.jpg
      2.jpg
      3.jpg
    2 第二回/
      ...

• Manga name is the URL slug (last path segment of the manga URL)
• Chapter folders are named <number> <title> (e.g., 1 第一回)
• Image filenames are sequential page numbers (1.jpg, 2.jpg, ...)

Metadata Format (detail.json)

Each manga folder contains a detail.json with fields:

• mg-url — source URL on m.happymh.com
• mg-title — manga title (Chinese)
• mg-author — author name
• mg-genres — array of genre tags
• mg-description — synopsis text

Target Site

• Base URL: https://m.happymh.com
• Manga page: /manga/<slug> — contains chapter listing
• Chapter page: /reads/<slug>/<chapter-id> — contains page images
• The site is mobile-oriented; requests should use appropriate mobile User-Agent headers