mangalib-python-sdk

Async Python SDK for mangalib.me: title metadata, table of contents, translations, catalog search, and chapter pages as images.

Like ranobelib-python-sdk, it talks to the undocumented but open JSON API behind the site (api.cdnlibs.org, shared by the whole lib.social network) instead of scraping HTML. The shared part (API client, request pacing, cache, titles, chapters, catalog) comes from libsocial-core, installed with it, so a process using both SDKs paces its requests to the API together.

Status: early. Titles, chapters, translations, the catalog and page downloads work; export to CBZ/PDF is planned. There is no login, so paid and early-access chapters can't be read: fetching one raises AuthRequiredError.

Installation

uv add mangalib-python-sdk

or

pip install mangalib-python-sdk

Requires Python 3.11+.

Quickstart

from mangalib import Catalog, MangaLib

async with MangaLib("https://mangalib.me/ru/manga/7965--chainsaw-man") as lib:
    info = await lib.get_info()
    toc = await lib.get_table_of_contents()

    # Chapter 1 has two translations: pick one (see get_translations()).
    translations = await lib.get_translations(volume=1, number="1")
    chapter = await lib.get_chapter(volume=1, number="1", branch_id=translations[0].branch_id)

    for page in chapter.pages:
        print(page.number, page.width, page.height)
    images = await lib.download_pages(chapter)  # list[bytes], in reading order

async with Catalog() as catalog:
    page = await catalog.list_titles(query="chainsaw")

• get_chapter() / get_chapters() / get_volume() / get_volumes() / download_title() return chapters with pages (Page: position, size, path on an image server).
• ChapterBranch.is_open (from get_table_of_contents() / get_translations()) says whether a translation can be read without an account.
• download_page() / download_pages() fall back from one image server to the next; see list_image_servers() and the API notes for why compress is tried first.

Documentation

Full API reference: https://LLIJIYAPNIK.github.io/ranobelib-python-sdk/. What the API returns for MangaLib, and what was checked: the "MangaLib" section of docs/api-notes.md. CHANGELOG.md lists what changed in each release.

License

MIT — see LICENSE.