teppyboy / saucerer

A SauceNAO web scrapper written in Python.

Saucerer

A SauceNAO web scrapper written in Python.

Usage

Asynchronous

from saucerer import Saucerer
import asyncio
# Either using async with
async with Saucerer() as saucerer:
    # search for sauce from an image file
    search_result = saucerer.search(image="./images/100980966_p0.jpg")
    # print the first sauce url
    print(search_result.sauces[0].url)
# or initialize & close it manually
async def main():
    saucerer = Saucerer()
    # search for sauce from an url
    search_result = await saucerer.search("https://ayayaxyz.tretrauit.repl.co/pixiv/raw?url=https:/i.pximg.net/img-original/img/2022/09/04/04/53/47/100980966_p0.jpg")
    await saucerer.close()
    # print the first sauce url
    print(search_result.sauces[0].url)
asyncio.run(main())

Synchronous

from saucerer import SaucererSync
saucerer = SaucererSync()
search_results = saucerer.search(image="./images/100980966_p0.jpg")
# print the first sauce url
print(search_result.sauces[0].url)

Documentation

https://tretrauit.gitlab.io/saucerer-docs

License

MIT license

saucerer's Issues

Add TOR/Proxy for IP block pass

To change IP and continue to work in the presence of blocking, for example, in the parameters to add a list of proxies

Empty results

A lot of empty stuff for Anime and Manga source etc

would be good if it can detect the type of sauce like AnimeSource, MangaSource, PixivSource, TwitterSource etc. and provide results according to that