220 行
10 KiB
Markdown
220 行
10 KiB
Markdown
<div align="center">
|
|
<a href="https://janda.mod.land"><img width="500" src="https://cdn.discordapp.com/attachments/952117487166705747/986185787894812672/tomoe-janda.png" alt="jandapress"></a>
|
|
|
|
<h4 align="center">RESTful and experimental API for the doujinboards</h4>
|
|
<p align="center">
|
|
<a href="https://github.com/sinkaroid/jandapress/actions/workflows/status.yml"><img src="https://github.com/sinkaroid/jandapress/actions/workflows/status.yml/badge.svg"></a>
|
|
<a href="https://codeclimate.com/github/sinkaroid/jandapress/maintainability"><img src="https://api.codeclimate.com/v1/badges/829b8fe63ab78a425f0b/maintainability" /></a>
|
|
</p>
|
|
|
|
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.
|
|
|
|
<a href="https://github.com/sinkaroid/jandapress/blob/master/CONTRIBUTING.md">Contributing</a> •
|
|
<a href="https://github.com/sinkaroid/jandapress/wiki/Routing">Documentation</a> •
|
|
<a href="https://github.com/sinkaroid/jandapress/issues/new/choose">Report Issues</a>
|
|
</div>
|
|
|
|
---
|
|
|
|
<a href="https://janda.mod.land"><img align="right" src="https://cdn.discordapp.com/attachments/952117487166705747/986315079802814524/tomoe.png" width="300"></a>
|
|
|
|
- [Jandapress](#)
|
|
- [The problem](#the-problem)
|
|
- [The solution](#the-solution)
|
|
- [Features](#features)
|
|
- [Jandapress vs. the doujinboards](#jandapress-vs-the-whole-doujin-sites)
|
|
- [Installation](#installation)
|
|
- [Prerequisites](#prerequisites)
|
|
- [Running tests](#running-tests)
|
|
- [Routing](#routing)
|
|
- [nhentai-api](#routing)
|
|
- [pururin-api](#routing)
|
|
- [hentaifox-api](#routing)
|
|
- [asmhentai-api](#routing)
|
|
- [hentai2read-api](#routing)
|
|
- [simply-hentai-api](#routing)
|
|
- [3hentai-api](#routing)
|
|
- [Limitations](#limitations)
|
|
- [Pronunciation](#Pronunciation)
|
|
- [Legal](#legal)
|
|
- [FAQ](#Frequently-asked-questions)
|
|
- [Client libraries / Wrappers](#client-libraries--wrappers)
|
|
|
|
|
|
## 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
|
|
<a href="https://github.com/sinkaroid/jandapress/wiki/Routing"><img src="https://cdn.discordapp.com/attachments/952117487166705747/1025602331456307230/jandaflow2.png" width="550"></a>
|
|
|
|
## 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
|
|
**Features availability** that Jandapress has
|
|
| Site | Status | Get | Search | Random |
|
|
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ------ |
|
|
| `nhentai` | [](https://github.com/sinkaroid/jandapress/actions/workflows/nhentai.yml) | ✅ | ✅ | ✅ |
|
|
| `pururin` | [](https://github.com/sinkaroid/jandapress/actions/workflows/pururin.yml) | ✅ | ✅ | ✅ |
|
|
| `hentaifox` | [](https://github.com/sinkaroid/jandapress/actions/workflows/hentaifox.yml) | ✅ | ✅ | ✅ |
|
|
| `hentai2read` | [](https://github.com/sinkaroid/jandapress/actions/workflows/hentai2read.yml) | ✅ | ✅ | ❌ |
|
|
| `simply-hentai` | [](https://github.com/sinkaroid/jandapress/actions/workflows/simply-hentai.yml) | ✅ | ❌ | ❌ |
|
|
| `asmhentai` | [](https://github.com/sinkaroid/jandapress/actions/workflows/asmhentai.yml) | ✅ | ✅ | ✅ |
|
|
| `3hentai` | [](https://github.com/sinkaroid/jandapress/actions/workflows/3hentai.yml) | ✅ | ✅ | ✅ |
|
|
|
|
## 🚀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
|
|
<table>
|
|
<td><b>NOTE:</b> NodeJS 14.x or higher</td>
|
|
</table>
|
|
|
|
## Running tests
|
|
Jandapress depends on
|
|
- [express](https://github.com/expressjs/express) web api framework
|
|
- [cheerio](https://cheerio.js.org/) for parsing html
|
|
- [cors](https://github.com/expressjs/cors) middleware for enabling CORS
|
|
- [rate-limit](https://github.com/nfriedly/express-rate-limit) rate-limiting middleware for express
|
|
|
|
Optional but already has
|
|
- [pino](https://getpino.io/) for logging
|
|
- [start-server-and-test](https://www.npmjs.com/package/start-server-and-test) for starting the server and 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
|
|
|
|
- `/` : index page
|
|
|
|
### Nhentai
|
|
The missing piece of nhentai.net
|
|
- `/nhentai` : nhentai api
|
|
- **get**, takes parameters : `book`
|
|
- **search**, takes parameters : `key`, `?page`, `?sort`
|
|
- **related**, takes parameters : `book`
|
|
- **random**
|
|
- <u>sort parameters on search</u>
|
|
- "popular-today", "popular-week", "popular"
|
|
- Example
|
|
- https://janda.mod.land/nhentai/get?book=177013
|
|
- https://janda.mod.land/nhentai/search?key=futanari&page=2&sort=popular-today
|
|
|
|
### Pururin
|
|
The missing piece of pururin.to
|
|
- `/pururin` : pururin api
|
|
- **get**, takes parameters : `book`
|
|
- **search**, takes parameters : `key`, `?page`, `?sort`
|
|
- **random**
|
|
- <u>sort parameters on search</u>
|
|
- "newest", "most-popular", "highest-rated", "most-viewed", "title", "random"
|
|
- Example
|
|
- https://janda.mod.land/pururin/get?book=63373
|
|
- https://janda.mod.land/pururin/search?key=futanari&page=2&sort=most-viewed
|
|
|
|
### Hentaifox
|
|
The missing piece of hentaifox.com
|
|
- `/hentaifox`: hentaifox api
|
|
- **get**, takes parameters : `book`
|
|
- **search**, takes parameters : `key`, `?page`, `?sort`
|
|
- **random**
|
|
- <u>sort parameters on search</u>
|
|
- "latest", "popular"
|
|
- Example
|
|
- https://janda.mod.land/hentaifox/get?book=97527
|
|
- https://janda.mod.land/hentaifox/search?key=milf&page=2&sort=latest
|
|
|
|
### Asmhentai
|
|
The missing piece of asmhentai.com
|
|
- `/asmhentai`: asmhentai api
|
|
- **get**, takes parameters : `book`
|
|
- **search**, takes parameters : `key`, `?page`
|
|
- **random**
|
|
- <u>sort parameters on search</u>
|
|
- None
|
|
- Example
|
|
- https://janda.mod.land/hentaifox/get?book=308830
|
|
- https://janda.mod.land/asmhentai/search?key=futanari&page=2
|
|
|
|
### Hentai2read
|
|
The missing piece of hentai2read.com
|
|
- `/hentai2read`: hentai2read api
|
|
- **get**, takes parameters : `book`
|
|
- **search**, takes parameters : `key`
|
|
- <u>sort parameters on search</u>
|
|
- TBA
|
|
- Example
|
|
- https://janda.mod.land/hentai2read/get?book=butabako_shotaone_matome_fgo_hen/1
|
|
|
|
### Simply-hentai
|
|
The missing piece of simply-hentai.com
|
|
- `/simply-hentai`: simply-hentai api
|
|
- **get**, takes parameters : `book`
|
|
- <u>sort parameters on search</u>
|
|
- TBA
|
|
- Example
|
|
- https://janda.mod.land/simply-hentai/get?book=fate-grand-order/fgo-sanbunkatsuhou/all-pages
|
|
|
|
### 3hentai
|
|
The missing piece of 3hentai.net
|
|
- `/3hentai`: 3hentai api
|
|
- **get**, takes parameters : `book`
|
|
- **search**, takes parameters : `key`, `?page`, `?sort`
|
|
- **random**
|
|
- <u>sort parameters on search</u>
|
|
- "recent", "popular-24h", "popular-7d", "popular"
|
|
- Example
|
|
- https://janda.mod.land/3hentai/get?book=608979
|
|
- https://janda.mod.land/3hentai/search?key=futanari&page=2&sort=popular-7d
|
|
|
|
## Limitations
|
|
Nhentai was cloudflare protection enabled, If IP and our thoughts against them? You should implement a proxy. Check [`cookie branch`](https://github.com/sinkaroid/jandapress/tree/cookie), take a look this workaround [Zekfad/nhentai-api/issues/25#issuecomment-1141360074](https://github.com/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`](https://www.localeplanet.com/java/id-ID/index.html) • **/jan·da/** — dewasa dan mengikat; _(?)_
|
|
|
|
|
|
## Client libraries / Wrappers
|
|
- [janda](https://github.com/sinkaroid/janda) Python wrapper by [sinkaroid](https://github.com/sinkaroid)
|
|
- Or [create your own](https://github.com/sinkaroid/jandapress/edit/master/README.md)
|
|
|
|
## 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. |