Lucas WintherandClaude Opus 5.5
219a05c039
Revise the covers spec: both links given directly, static page served by a Cloudflare Worker plus a userscript on one pure core, Bun instead of Node, and R2 rehosting with a 30-day expiry. Move the spec to docs/specs/, merge HANDOVER.md into docs/DECISIONS.md, the spec and docs/TODO.md, and add AGENTS.md, pointer files, PERMISSIONS.md and agent permission configs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
mangabaka-seeder
A tool for seeding edits to the MangaBaka manga/comics database, in the spirit of yambs for MusicBrainz.
Status: designed, not built yet. This README describes the planned behaviour; see the spec.
Today's goal is one thing done well: given a MangaBaka series link and a Webtoons series link, find every cover the Webtoons series has used, current and historical, and request them added to the MangaBaka series. The current poster becomes the main (default) cover for the edition's language.
Two ways to use it
- Web page (primary). Open the page, paste the two links, review the covers. The page is hosted on Cloudflare; a small Worker behind it reads Webtoons and the Wayback Machine for you, because browsers can't.
- Userscript. Install
mbseed.user.jsin Tampermonkey or Violentmonkey. On a MangaBaka series page it adds a Seed covers panel; paste the Webtoons link. It reads Webtoons directly from your browser, no proxy needed.
A command-line version (Bun) may follow.
How it works
- Read both links. The MangaBaka link gives the series id; the Webtoons
link gives the title,
title_no, language, and official or canvas. If the MangaBaka series has no link to thattitle_no, you're warned. - Collect covers.
- Current: the portrait poster, the square thumbnail, and the banner and hero art.
- Historical: cover images in archived copies of the series page on the Wayback Machine, up to one snapshot per month.
- Check each image. It downloads each image to get its size and hash,
classifies it by shape (portrait →
volume, square →other, wide →banner), and drops duplicates and images MangaBaka already has. - Build the submission. Existing covers are kept and new ones added. The current poster is the default (the square for canvas series, which have no poster). Every new cover gets a note recording where and when it was seen.
- Rehost the images when you click Rehost selected. They go to our storage and expire after 30 days — long enough for a MangaBaka review. If a review takes longer, run the tool again.
- Hand it to you.
- Without API access (most users): copy the hosted URLs and paste them into MangaBaka's cover form for the series (the page links to it).
- With a personal access token: the tool shows MangaBaka's preview diff and, after you confirm, submits the request for review.
Nothing is uploaded or sent to MangaBaka without your action, and submissions
always go to review. You choose the content rating (default safe); titles
Webtoons marks as mature show a warning. Your token is sent only to
MangaBaka's API, never to our Worker.
MangaBaka's submissions API is only open to contributors, or to users with at least 25 approved submissions.
Supported sources
| Source | Links | Current covers | Historical covers |
|---|---|---|---|
| WEBTOON (official & canvas) | https://www.webtoons.com/<lang>/…/list?title_no=N, m.webtoons.com |
poster, square, banner, foreground | Wayback Machine |
Each Webtoons language edition has its own title_no. Run the tool once per
edition; the covers are tagged with that edition's language.
Notes and limitations
- Some covers may only exist in the archive. If an old cover is no longer on Webtoons' server, its archive.org copy is used instead.
- Not everything is a cover. Some historical images are promotional or landing-page art. Review the list before submitting.
- Requests are rate-limited to stay polite to Webtoons, the Wayback Machine and MangaBaka.
Development
Working on this repo, by hand or with an AI agent: start at
AGENTS.md. Design: docs/specs/; current
architecture: docs/ARCHITECTURE.md.