2b5d6badd4 | ||
---|---|---|
.github | ||
src | ||
test | ||
.env.schema | ||
.eslintignore | ||
.eslintrc.json | ||
.gitignore | ||
CHANGELOG.md | ||
CLOSING_REMARKS.md | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
Procfile | ||
README.md | ||
SECURITY.md | ||
package.json | ||
tsconfig.json |
README.md
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.
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 |
✅ | ✅ | ✅ | |
pururin |
✅ | ✅ | ✅ | |
hentaifox |
✅ | ✅ | ✅ | |
hentai2read |
✅ | ✅ | ❌ | |
simply-hentai |
✅ | ❌ | ❌ | |
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 is3000
Routing
the parameter?
: means is optional.
-
/
: index page -
/nhentai
: nhentai api- get, takes parameters :
book
- search, takes parameters :
key
,?page
,?sort
- related, takes parameters :
book
- random
- Example
- get, takes parameters :
-
/pururin
: pururin api- get, takes parameters :
book
- search, takes parameters :
key
,?page
,?sort
- random
- Example
- get, takes parameters :
-
/hentaifox
: hentaifox api- get, takes parameters :
book
- search, takes parameters :
key
,?page
,?sort
- random
- Example
- get, takes parameters :
-
/asmhentai
: asmhentai api- get, takes parameters :
book
- search, takes parameters :
key
,?page
- random
- Example
- get, takes parameters :
-
/hentai2read
: hentai2read api- get, takes parameters :
book
- search, takes parameters :
key
- Example
- get, takes parameters :
-
/simply-hentai
: simply-hentai api- get, takes parameters :
book
- Example
- get, takes parameters :
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
- janda Python wrapper by sinkaroid
- Or create your own
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.