FindMeABot SDK

FindMeABot SDK is the official SDK for FindMeABot, a bot listing platform created and maintained by ameencfw.

This package lets Discord bot developers automatically send bot statistics, including server and member counts, to the FindMeABot API.

What it does

• Posts stats automatically every 30 minutes
• Supports shard-aware server and member aggregation
• Uses real guild member counts
• Includes validation and error handling
• Supports posted and error events
• Includes start() and stop() controls

Installation

npm install findmeabot-sdk

Usage

const { AutoPoster } = require("findmeabot-sdk");
const { Client } = require("discord.js");

const client = new Client({
  intents: [...],
});

const poster = AutoPoster("YOUR_FINDMEABOT_TOKEN", client);

poster.on("posted", (stats) => {
  console.log(`Posted: ${stats.servers} servers, ${stats.users} users`);
});

poster.on("error", (err) => {
  console.error("Error:", err.message);
});

client.login("YOUR_DISCORD_TOKEN");

API Endpoint

POST https://findmeabot.amtixdev.xyz/api/bots/:id/stats
Authorization: Bearer <token>
Content-Type: application/json

{
  "servers": 1420,
  "users": 850300
}

Official Status

This SDK is part of the FindMeABot ecosystem and is maintained by the same team that runs the platform and its API.

License

MIT