Gitler
Dark
登録
サインイン

bagood / jandapress

Other (93.83%)
Markdown (6.17%)

.dockerignore

ci: dockerize jandapress

2022-12-11T00:12:14+07:00

.env.schema

feat: simulating nhentai request on cloudflare enabled (#17) * fix apidocs definitions * add nhentaiStrategy method * add MaybeError types * add simulateCookie to janda class * test case * env example * push release

 2023-02-11T00:17:45+07:00

.eslintignore

style: add eslintignore for compiled files

2022-06-07T19:25:44+07:00

.eslintrc.json

style: add eslint rule

2022-06-03T09:32:39+07:00

.github

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release

 2023-08-04T19:29:21+07:00

.gitignore

ci: generate docs from apidoc definitions (#10) * add some complier files to gitignore * feat: add apidoc definitions in each controller * ci: generate docs from apidoc definitions * docs: update readme * ci: update playground workflows * bump marine template

 2022-12-23T10:04:22+07:00

.vscode

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release

 2023-08-04T19:29:21+07:00

CLOSING_REMARKS.md

docs(CLOSING_REMARKS): add nhentai.to credits (#27) * Update CLOSING_REMARKS.md * Update package.json * Update package.json Co-authored-by: Indrawan I. <bibsindra@gmail.com> --------- Co-authored-by: Indrawan I. <bibsindra@gmail.com>

 2023-05-16T16:16:41+07:00

CODE_OF_CONDUCT.md

docs: add code of conduct

2022-06-03T09:36:22+07:00

CONTRIBUTING.md

docs: minor improvements

2022-06-04T05:00:18+07:00

Dockerfile

chore: update docker build

2022-12-14T02:50:31+07:00

LICENSE

deps: major dependencies update

2022-12-11T03:32:01+07:00

README.md

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release

 2023-08-04T19:29:21+07:00

SECURITY.md

docs: add security policy

2022-06-03T09:36:46+07:00

package.json

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release

 2023-08-04T19:29:21+07:00

src

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release

 2023-08-04T19:29:21+07:00

test

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release

 2023-08-04T19:29:21+07:00

tsconfig.json

feat: add nhentai.to support & improve tests (#24) * tdd * remove charset * adjust client * remake options * add reverse proxy * apply endpoint * update docs * add each controllers * add each scraper * pre release

 2023-05-16T15:04:12+07:00

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.

Playground •
Contributing •
Report 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

Features

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

Jandapress vs. the whole doujin sites

Features availability that Jandapress has

Site Status Get Search Random
nhentai Nhentai ✅ ✅ ✅
pururin Pururin ✅ ✅ ✅
hentaifox Hentaifox ✅ ✅ ✅
hentai2read Hentai2read ✅ ✅ ❌
simply-hentai Simply-hentai ✅ ❌ ❌
asmhentai Asmhentai ✅ ✅ ✅
3hentai Asmhentai ✅ ✅ ✅
nhentai.to Nhentaito ✅ ✅ ✅

Prerequisites

To handle several requests from each web, You will also need Redis for persistent caching, free tier is available on Redis Labs, You can also choose another provider as we using keyv Key-value storage with support for multiple backends. All data must be stored in <Buffer> here.

Installation

Rename .env.schema to .env and fill the value with your own

# railway, fly.dev, heroku, vercel or any free service, NHENTAI_IP_ORIGIN should be true
RAILWAY = sinkaroid

# default port
PORT = 3000

# backend storage, default is redis, if not set it will consume memory storage
REDIS_URL = redis://default:somenicepassword@redis-666.c10.us-east-6-6.ec666.cloud.redislabs.com:1337

# ttl expire cache (in X hour)
EXPIRE_CACHE = 1

# nhentai strategy
# default is true which is assign to request on IP instead of nhentai.net with cloudflare
# if you have instance like vps you need chromium or firefox installed and set it to false
NHENTAI_IP_ORIGIN = true

# you must set COOKIE if NHENTAI_IP_ORIGIN is false, read the jandapress docs 
COOKIE = "cf_clearance=l7RsUjiZ3LHAZZKcM7BcCylwD2agwPDU7l9zkg8MzPo-1676044652-0-250"

# you must set USER_AGENT if NHENTAI_IP_ORIGIN is false, read the jandapress docs
USER_AGENT = "jandapress/1.0.5 Node.js/16.9.1"

Docker

docker pull ghcr.io/sinkaroid/jandapress:latest
docker run -p 3000:3000 -d ghcr.io/sinkaroid/jandapress:latest

Docker (your own)

docker run -d \
  --name=jandapress \
  -p 3000:3000 \
  -e REDIS_URL='redis://default:somenicepassword@redis-666.c10.us-east-6-6.ec666.cloud.redislabs.com:1337' \
  -e EXPIRE_CACHE='1' \
  -e NHENTAI_IP_ORIGIN='false' \
  -e COOKIE='cf_clearance=AbcDefGhijY7RYSKv3YeJUjrI5xQ2Uc-666-0-250' \
  -e USER_AGENT='jandapress/1.0.5 Node.js/16.9.1' \
  ghcr.io/sinkaroid/jandapress:latest

Manual

git clone https://github.com/sinkaroid/jandapress.git
  • Install dependencies
    • npm install / yarn install
  • Jandapress production
    • npm run start:prod
  • Jandapress testing and hot reload
    • npm run start:dev

Nhentai Guide

The problem

https://nhentai.net was Clouflare protection enabled, for default jandapress use real IP address to bypass the protection, but sometimes even it's from IP address the /api path return error that means admins or their maintainer don't allow us to request from the IP address.
image

The solution

You will need instance such as VPS and install Chrome or Chromium or Firefox, You have to set NHENTAI_IP_ORIGIN to false, set COOKIE and USER_AGENT. We'll simulate the request with tough-cookie and http-cookie-agent

image

  • set NHENTAI_IP_ORIGIN to false in .env file
  • open browser and go to https://nhentai.net
  • verify you are human
  • open devtools and set custom user agent
  • reload the page and wait cloudflare again
  • open devtools and go to network tab and request
  • get the cf_clearance value and set it to COOKIE in .env file
  • set the user agent to USER_AGENT in .env file
  • test that your cookie is working npm run test:cf
    • it should return 200 status code otherwise watch your step

The documentation said and correct me if I'm wrong:

This cookie expires after 30 minutes of continuous inactivity by the end user. The cookie contains information related to the calculation of Cloudflare’s proprietary bot score and, when Anomaly Detection is enabled on Bot Management, a session identifier.

└── https://developers.cloudflare.com/fundamentals

You will need to make your cookie is not expired otherwise manual update is required, it can be with set interval or cron job to automate your request.

Running tests

Jandapress testing

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

Generating playground like swagger from apidoc definition

npm run build:apidoc

To running other tests, you can see object scripts in file package.json

Playground

https://sinkaroid.github.io/jandapress

  • These parameter?: means is optional

  • / : index page

Nhentai

The missing piece of nhentai.net - https://sinkaroid.github.io/jandapress/#api-nhentai

Pururin

The missing piece of pururin.to - https://sinkaroid.github.io/jandapress/#api-pururin

Hentaifox

The missing piece of hentaifox.com - https://sinkaroid.github.io/jandapress/#api-hentaifox

Asmhentai

The missing piece of asmhentai.com - https://sinkaroid.github.io/jandapress/#api-asmhentai

Hentai2read

The missing piece of hentai2read.com - https://sinkaroid.github.io/jandapress/#api-hentai2read

Simply-hentai

The missing piece of simply-hentai.com - https://sinkaroid.github.io/jandapress/#api-simply-hentai

3hentai

The missing piece of 3hentai.net - https://sinkaroid.github.io/jandapress/#api-3hentai

Nhentai.to

The missing piece of nhentai.to - https://sinkaroid.github.io/jandapress/#api-nhentaito

Status response

"success": true, or "success": false,

HTTP/1.1 200 OK
HTTP/1.1 400 Bad Request
HTTP/1.1 500 Fail to get data

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

Seamlessly integrate with the languages you love, simplified the usage, and intelisense definitions on your IDEs

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.

MIT License

Copyright (c) 2022 sinkaroid.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

クローン

このレポジトリについて

RESTful and experimental API for nhentai and other doujinshi

1

1

0

最終コミット

fix(pururin, modifier): remove sort consume & update elements (#30) * enable deepscan * doesn't accept sorting anymore tho * update element * outdated apidoc definitions * pururin update * pre release
2023-08-04T19:29:21+07:00

リリース

作成中・・・

寄付

作成中・・・