Skip to content

RESTful and experimental API for the doujinboards

License

Notifications You must be signed in to change notification settings

ScathachGrip/jandapress

 
 

Repository files navigation

jandapress

RESTful and experimental API for the doujinboards

Jandapress was named JCE (Janda Cheerio Express) and definitely depends on them.
The motivation of this project is to bring you an actionable data related doujin with gather in mind.

ContributingDocumentationReport Issues


The problem

You enjoy consume doujin sites to build web applications. There are a lot sites that have effort especially pururin, simply-hentai and etc, not official api available nor public resource that can be used for everyone. Instead making lot of abstraction and enumerating them manually, You can rely on jandapress to make less of pain. The current state is FREE to use, meant all anonymous usage is allowed no aunthentication required and CORS was enabled.

The solution

Luckily there are solutions. You can rely on Jandapress.

Features

  • Gather the most doujin sites
  • Objects taken that are consistent structure, almost
  • Objects taken is re-appended to make it more actionable
  • All in one: get, search, and random methods
  • In the future we may implement JWT authentication
  • Pure scraping

Jandapress vs. the whole doujin sites

Site Status Get Search Random
nhentai Nhentai
pururin Pururin
hentaifox Hentaifox
hentai2read Hentai2read
simply-hentai Simply-hentai
asmhentai Asmhentai

🚀Installation

  • Clone this repository
    • git clone https://github.com/sinkaroid/jandapress.git
  • Install dependencies
    • npm install / yarn install
  • Jandapress production
    • npm run build
    • npm run start:prod
  • Jandapress testings
    • npm run start:dev

Prerequisites

NOTE: NodeJS 14.x or higher

Running tests

Start the production server

npm run start:prod

Running development server

npm run start:dev

Check the whole sites, It's available for scraping or not

npm run test

Check nhentai It's under cloudflare protection or not

npm run test:cf

To running other method, you can see object scripts in file package.json, Default port is 3000

Routing

the parameter?: means is optional.

Limitations

Nhentai was cloudflare protection enabled, If IP and our thoughts against them? You should implement a proxy. Check cookie branch, take a look this workaround Zekfad/nhentai-api/issues/25#issuecomment-1141360074

Frequently asked questions

Q: The website response is slow

That's unfortunate, This repository was opensource already, You can host and deploy Jandapress with your own instance. Any fixes and improvements will updating to this repo.

Q: I dont want to host my own instance

That's unfortunate, Hit the "Sponsor this project" button, any kind of donations will helps me to funding the development.

Pronunciation

id_ID/jan·da/ — dewasa dan mengikat; (?)

Client libraries / Wrappers

Legal

This tool can be freely copied, modified, altered, distributed without any attribution whatsoever. However, if you feel like this tool deserves an attribution, mention it. It won't hurt anybody.

Licence: WTF.

About

RESTful and experimental API for the doujinboards

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 100.0%