Comick Source API

Next.js API for scraping manga metadata from multiple sources.

Live API | Userscript

Source	ID	Base URL	Status
MangaPark	mangapark	https://mangapark.io	Active
AsuraScan	asurascan	https://asuracomic.net	Active
AtsuMoe	atsumoe	https://atsumoe.com	Active
WeebCentral	weebcentral	https://weebcentral.com	Unstable
LikeManga	likemanga	https://likemanga.io	Active
ManhuaUS	manhuaus	https://manhuaus.com	Unstable
MangaRead	mangaread	https://mangaread.org	Active
Mgeko	mgeko	https://mgeko.cc	Active
NovelCool	novelcool	https://www.novelcool.com	Active
FlameComics	flamecomics	https://flamecomics.xyz	Active
Bato	bato	https://bato.to	Unstable
Mangaloom	mangaloom	https://mangaloom.com	Active
MangaYY	mangayy	https://mangayy.org	Active
TopManhua	topmanhua	https://manhuatop.org	Active
LagoonScans	lagoonscans	https://lagoonscans.com	Active
Stonescape	stonescape	https://stonescape.xyz	Active
Rizz Fables	rizz-fables	https://rizzfables.com	Active
Falcon Scans	falcon-scans	https://falconscans.com	Unstable
Raven Scans	raven-scans	https://ravenscans.org	Active
Comix	comix	https://comix.to	Active
Mangataro	mangataro	https://mangataro.org	Active
KaliScan	kaliscan	https://kaliscan.com	Active
Mangago	mangago	https://www.mangago.zone	Active
Project Suki	project-suki	https://projectsuki.com	Active
Weebdex	weebdex	https://weebdex.org	Active

Setup

git clone https://github.com/GooglyBlox/comick-source-api.git
cd comick-source-api
npm install
npm run dev

Runs on http://localhost:3000

Production:

npm run build
npm start

API

GET /api/sources

List all supported sources.

{
  "sources": [
    {
      "id": "mangapark",
      "name": "MangaPark",
      "baseUrl": "https://mangapark.io",
      "description": "MangaPark - https://mangapark.io",
      "clientOnly": false,
      "type": "aggregator"
    }
  ]
}

POST /api/search

Search manga across sources.

{
  "query": "solo leveling",
  "source": "mangapark"  // or "all"
}

POST /api/chapters

Get chapter list for a manga.

{
  "url": "https://mangapark.io/title/75577-en-solo-leveling",
  "source": "mangapark"  // optional, auto-detected
}

GET /api/health

Check source status. Cached for 5 minutes. Returns cached and cacheAge fields.

POST /api/health

Force refresh health check cache.

GET /api/proxy/html

Proxy requests to AsuraScans and WeebCentral (CORS workaround).

GET /api/proxy/html?url=https://asuracomic.net/...

Usage

curl -X POST https://comick-source-api.notaspider.dev/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "one piece", "source": "all"}'

const res = await fetch("https://comick-source-api.notaspider.dev/api/search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ query: "chainsaw man", source: "all" })
});

Development

npm run dev          # dev server
npm run build        # production build
npm test             # run tests
npm run test:sources # test scrapers
npm run lint         # eslint

See CONTRIBUTING.md for guidelines on adding sources.

Deployment

docker build -t comick-source-api .
docker run -p 3000:3000 comick-source-api

No environment variables required.

License

For educational purposes. Respect source website ToS.