About discord-botlists

discord-botlists is a zero-dependency SDK that connects a Discord bot to every botlist at once. It posts server and shard counts in each list's exact wire format, receives votes, comments, reviews and ratings in realtime through one hardened webhook server, parses any list API into a single UniversalBot shape, and tracks the health of every list it supports. The registry currently ships 33 verified live lists and is re-audited hourly.

The package is installable from npm as @potenfyrstudios/discord-botlists, runs on Node 18+ and Bun, works with discord.js, Eris, Oceanic, any framework (or none at all) and is fully typed with strict TypeScript.

PotenFYR Studios

discord-botlists is built and maintained by PotenFYR Studios, an independent studio shipping developer tools and open-source projects. Explore the rest of the ecosystem on the GitHub organization or at potenfyr.in.

Links

• Source: github.com/PotenFYR-Studios/discord-botlists
• Package: npmjs.com/package/@potenfyrstudios/discord-botlists
• Issues and list requests: GitHub Issues
• Support Discord: discord.com/invite/zUaN2FPBec
• Registry health: the live status board

License & notices

Released under Apache-2.0 with the Commons Clause: fork, modify, use and build around it freely: just don't sell the package itself as a product. The LICENSE file is authoritative.

Botlist metadata is collected from public botlist API documentation and the BotBlock open directory. All botlist names, logos and trademarks belong to their respective owners; this project is not affiliated with, endorsed by, or sponsored by any botlist.