Skip to content

Simple, lightweight, and easy to use SauceNAO API wrapper for Node.JS.

License

Notifications You must be signed in to change notification settings

ClarityCafe/Sagiri

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2e60769 · Jan 3, 2025
Oct 9, 2024
Jan 3, 2025
Aug 26, 2024
Aug 27, 2024
Oct 18, 2024
Oct 10, 2024
Jan 3, 2025
Oct 9, 2024
Jul 17, 2022
Aug 17, 2019
Oct 8, 2024
Jul 17, 2022
Aug 27, 2024
Jan 11, 2020
Oct 8, 2024
Jan 3, 2025
Aug 26, 2024
Jan 3, 2025
Jan 3, 2025
Aug 26, 2024

Repository files navigation

Sagiri

A simple and lightweight NodeJS wrapper for SauceNAO.

NPM Downloads Badge FOSSA Status

Installation

yarn add sagiri
# or with npm
npm install sagiri
# or with deno
deno add @clarity/sagiri

Usage

const sagiri = require("sagiri");

const client = sagiri("token");
const results = await client("http://i.imgur.com/5yFTeRV.png");

sagiri is a function that returns an async function, so you can call it and store it in a variable to use multiple times, or you can call it and use it immediately.

Sagiri also has the ability to provide options both when calling the main function, and the given async function.

const client = sagiri("client", { results: 10 });
const results = await client("http://i.imgur.com/5yFTeRV.png", { mask: [5] });

API

sagiri(token: string, defaultOptions?: Options)
Creates a function to be used for finding potential sources for a given image.
By default has options set to give 5 results from SauceNAO.

You can get a token for SauceNAO by registering an account and going to the API page.

Returns async function (file: File, optionOverrides?: Options) which is loaded with the given token and default options to use.

Options

Options takes the form of a simple object passed to either the constructor function or the request function, which covers the options available in the SauceNAO API.

A basic overview of this object looks like this:

{
  results?: number;
  mask?: number[];
  excludeMask?: number[];
  testMode?: boolean;
  db?: number;
}
  • results controls how many results are returned from SauceNAO.
  • mask is an array of the only database indices you want returned from SauceNAO. A mask of [5] would only return results from Pixiv.
  • excludeMask is like mask, but instead of only including the indices you give, it excludes them from the results - allowing everything but those indices. For example, a mask of [5] would disallow results from Pixiv.
  • testMode causes each index that has a match for the given image to output at most 1 result. Useful for testing some things.
  • db searches a specific database index without having to generate a mask.

Contributing

Any contributions to this project are welcome, but please be sure to read over our contributing guidelines.

License

The code contained within this repository is licensed under the MIT License. See LICENSE for more information.

FOSSA Status