https://github.com/slavyandesu/nekobocc
A simple and lightweight Nekopoi scraper.
https://github.com/slavyandesu/nekobocc
anime-scraper hentai nekopoi nekopoi-scraper scraper scraper-api
Last synced: about 1 year ago
JSON representation
A simple and lightweight Nekopoi scraper.
- Host: GitHub
- URL: https://github.com/slavyandesu/nekobocc
- Owner: SlavyanDesu
- License: mit
- Created: 2021-01-09T21:32:57.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-03-18T23:05:17.000Z (about 1 year ago)
- Last Synced: 2025-03-18T23:11:12.514Z (about 1 year ago)
- Topics: anime-scraper, hentai, nekopoi, nekopoi-scraper, scraper, scraper-api
- Language: TypeScript
- Homepage:
- Size: 548 KB
- Stars: 17
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
A simple and lightweight NekoPoi scraper.
---
## Installation
```bash
npm install nekobocc
```
## Loading and Configuring the Module
As of v1.3.x, this module supports both ESM and CommonJS.
### ES Modules (ESM)
```js
import NekoBocc from "nekobocc";
const nekobocc = new NekoBocc();
```
### CommonJS
```js
const NekoBocc = require("nekobocc").default;
const nekobocc = new NekoBocc();
```
## Example
```js
import NekoBocc from "nekobocc";
const nekobocc = new NekoBocc();
// Get a list of released hentai.
nekobocc.release()
.then((res) => console.log(res));
```
## Results
### HentaiRelease
```js
[
{
img: 'https://nekopoi.care/wp-content/uploads/2022/02/vlcsnap-2022-02-06-03h46m23s608-300x169.png',
title: '[4K] Akane wa Tsumare Somerareru Episode 2 Subtitle Indonesia',
url: 'https://nekopoi.care/akane-wa-tsumare-somerareru-episode-2-subtitle-indonesia/',
genre: [
'Ahegao',
'Armpit',
...
],
duration: '16 menit'
}
]
```
### EpisodeMetadata
```js
{
img: 'https://nekopoi.care/wp-content/uploads/2022/02/vlcsnap-2022-02-06-03h46m23s608-300x169.png',
title: '[4K] Akane wa Tsumare Somerareru Episode 2 Subtitle Indonesia – NekoPoi',
synopsis: 'Akane yang merasa tersanjung dengan...',
genre: [
'Ahegao',
'Armpit',
...
],
producer: [ 'Antechinus' ],
duration: '16 menit',
size: {
'360P': '29MB',
'480P': '44MB',
'720P': '98MB',
'1080P': '195MB'
},
download: {
'1080p': [
'https://linkpoi.me/imQD',
...
],
'720p': [
'https://linkpoi.me/EsYB',
...
],
'480p': [
'https://linkpoi.me/vLjPqWvJ',
...
],
'360p': [
'https://linkpoi.me/SvDBaJ',
...
]
}
}
```
### HentaiMetadata
```js
{
img: 'https://nekopoi.care/wp-content/uploads/2022/01/Akane-wa-Tsumare-Somerareru2-212x300.jpg',
title: 'Akane wa Tsumare Somerareru – NekoPoi',
synopsis: 'Akane yang merasa tersanjung dengan...',
views: 47457,
japanese: '茜ハ摘マレ染メラレル',
category: 'Hentai',
episode: 2,
status: 'Completed',
aired: 'Feb 04, 2022',
producer: [ 'Antechinus' ],
genre: [
'Ahegao',
'Armpit',
...
],
duration: '16 min',
score: 6.89,
url: [
'https://nekopoi.care/akane-wa-tsumare-somerareru-episode-1-subtitle-indonesia/',
'https://nekopoi.care/akane-wa-tsumare-somerareru-episode-2-subtitle-indonesia/'
]
}
```
## Methods
### `nekobocc.release([page])`
- `page` (optional) - Page number to be shown. Default is `1`.
- Returns a [`HentaiRelease`](#hentairelease).
### `nekobocc.search(query)`
- `query` (string, required) - Search query.
- Returns a [`HentaiRelease`](#hentairelease).
### `nekobocc.get(url)`
- `url` (string, required) - NekoPoi hentai episode or page URL.
- Returns [`HentaiMetadata`](#hentaimetadata) or [`EpisodeMetadata`](#episodemetadata).
### `nekobocc.random()`
- Retrieves a random hentai.
- Returns [`HentaiMetadata`](#hentaimetadata) or [`EpisodeMetadata`](#episodemetadata).
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
