Nekos.life

Installation

npm i -s nekos.life

This wrapper has no external dependencies ;).

Updates

I just added a typings file and will be working to improve it. This allows editors like VSC to use intellisense/autocomplete to suggest functions and help out with parameters and to see what you'll be receiving as a result of function calls.

The wrapper functions all return promises, so you can use traditional promises or await/async.

Function	Description
getSFWSmug	Gets a URL of a smug image/gif
getSFWBaka	Gets a URL of a baka image/gif
getSFWTickle	Gets a URL of a tickle image/gif
getSFWSlap	Gets a URL of a slap image/gif
getSFWPoke	Gets a URL of a poke image/gif
getSFWPat	Get a URL of a pat image/gif
getSFWNeko	Get a URL of a neko image
getSFWNekoGif	Get a URL of a neko gif
getSFWMeow	Get a URL of a cat image/gif
getSFWLizard	Get a URL of a lizard image/gif
getSFWKiss	Get a URL of a kiss image/gif
getSFWHug	Get a URL of a hug image/gif
getSFWFoxGirl	Get a URL of a fox girl image/gif
getSFWFeed	Get a URL of a feeding image/gif
getSFWCuddle	Get a URL of a cuddle image/gif
getSFWWhy	Get text of a question
getSFWCatText	Get text of a cat emoji
getSFWOwOify	Get OwOified text of a string
getSFWChat	Sends the text and replies with a text as a response
getSFW8Ball	Sends the text and replies with a text as a response to the magic 8Ball and an image as well.
getSFWFact	Gets the text and replies with a text that is a random fact
getSFWKemonomimi	Get a URL of a kemonomimi image/gif
getSFWHolo	Get a URL of a Holo image/gif
getSFWWoof	Get a URL of a dog image/gif
getNSFWRandomHentaiGif	Get a URL of hentai gif
getNSFWPussy	Get a NSFW URL of a pussy image/gif
getNSFWNekoGif	Get a NSFW URL of a neko gif
getNSFWNeko	Get a NSFW URL of a neko image
getNSFWLesbian	Get a NSFW URL of a lesbian image/gif
getNSFWKuni	Get a NSFW URL of a kuni image/gif
getNSFWCumsluts	Get a NSFW URL of a cumslut image/gif
getNSFWClassic	Gets a NSFW URL of the classic endpoint image/gif
getNSFWBoobs	Gets a NSFW URL of boobs image/gif
getNSFWBJ	Gets a NSFW URL of bj image/gif
getNSFWAnal	Gets a NSFW URL of anal image/gif
getNSFWAvatar	Gets a NSFW URL of an avatar image/gif
getNSFWYuri	Gets a NSFW URL of yuri image/gif
getNSFWTrap	Gets a NSFW URL of trap image/gif
getNSFWTits	Gets a NSFW URL of an/a image/gif containing tits
getNSFWGirlSoloGif	Gets a NSFW URL of a solo girl gif
getNSFWGirlSolo	Gets a NSFW URL of a solo girl image
getNSFWSmallBoobs	Gets a NSFW URL of an/a image/gif small boobs
getNSFWPussyWankGif	Gets a NSFW URL of a gif of pussy masterbation
getNSFWPussyArt	Gets a NSFW URL of an/a image/gif of pussy art
getNSFWKemonomimi	Gets a NSFW URL of an/a image/gif containing kemonomimi
getNSFWKitsune	Gets a NSFW URL of an/a image/gif of kitsune
getNSFWKeta	Gets a NSFW URL of an/a image/gif of keta
getNSFWHolo	Gets a NSFW URL of an/a image/gif of Holo
getNSFWHoloEro	Gets a NSFW URL of an/a image/gif Holo ero
getNSFWHentai	Gets a NSFW URL of an/a image/gif of hentai
getNSFWFutanari	Gets a NSFW URL of an/a image/gif of futa
getNSFWFemdom	Gets a NSFW URL of an/a image/gif of femdom
getNSFWFeetGif	Gets a NSFW URL of a gif of feet
getNSFWEroFeet	Gets a NSFW URL of an/a image/gif of ero feet
getNSFWFeet	Gets a NSFW URL of an image of feet
getNSFWEro	Gets a NSFW URL of an/a image/gif ero
getNSFWEroKitsune	Gets a NSFW URL of an/a image/gif ero kitsune
getNSFWEroKemonomimi	Gets a NSFW URL of an/a image/gif ero kemonomimi
getNSFWEroNeko	Gets a NSFW URL of an/a image/gif ero neko
getNSFWEroYuri	Gets a NSFW URL of an/a image/gif ero yuri
getNSFWCumArts	Gets a NSFW URL of an/a image/gif of cum arts
getNSFWBlowJob	Gets a NSFW URL of an/a image/gif blowjob
getNSFWPussyGif	Gets a NSFW URL of a gif of pussy

All of the endpoints but the ones marked with text, except Chat/8Ball/Fact in the description will return JSON: { url: <theURL>}.

getSFWCatText will return JSON: {cat: <catemoji>}
getSFWWhy will return JSON {why: <whytext>}
getSFWOwOify will return JSON {owo: <owoified string>}

getSFWFact will return JSON {response: <fact string>}
getSF8WBall will return JSON {response: <8Ball response string>, url: <URL to a matching 8Ball image>}
getSFWChat will return JSON {response: <reply string>}, this one is special and will have an example :)

As of now, getSFWOwOify, getSFW8Ball, and getSFWChat are the only ones with query parameters. It requires an object containing the parameter, and the key should be the value. In this case, the key is text and the value is whatever you want OwOified. There is an example in this README. {text: 'Some text you want weebified.}

Examples

Await/Async example

const client = require('nekos.life');
const neko = new client();

async function test() {
  console.log(await neko.getSFWHug());
}

test();

returns:

{ url: 'https://cdn.nekos.life/hug/hug10050.gif' }

Promise example

const client = require('nekos.life');
const neko = new client();

neko.getSFWCatText().then((catText) => console.log(catText));

returns

{ cat: '((≡^⚲͜^≡))' }

getSFWOwOify example

async function work() {
  let owo = await neko.getSFWOwOify({text: 'This lib is really awesome!'});
  console.log(owo);
}

work();

returns

{ owo: 'This wib is weawwy awesome >w< ' }

getSFWChat example

async function work() {
  let owo = await neko.getSFWChat({text: "What's up?"});
  console.log(owo);
}

work();

returns

{ response: 'Not much.' }

Try adding owo: "true" after the text prop ;). It would look like this {text: "What's up?", owo: "true"}
getSFW8Ball is prety much the exact same thing, except you can't use owo with it!