⚡ About

@manaobot/kick is a lightweight TypeScript SDK for building Kick.com bots, tools, and automation. This library focuses on OAuth, Webhooks, and REST APIs, everything required to build production-grade Kick bots.

📦 Installation

bun add @manaobot/kick

🚀 Quick Start

import { KickClient } from "@manaobot/kick";

const kick = new KickClient({
  clientId: process.env.KICK_CLIENT_ID!,
  clientSecret: process.env.KICK_CLIENT_SECRET!,
  redirectUri: "http://localhost:3000/callback",
  scopes: ["chat:write"],
});

if (!process.env.KICK_REFRESH_TOKEN) {
  console.log(kick.getAuthURL());
  kick.auth.createCallbackServer({ port: 3000 });
  await kick.auth.waitForAuthorization();
}

await kick.chat.send({
  content: "Hello from Kick SDK!"
});

✨ Features

🔐 Authentication

• OAuth2 Authorization Code Flow
• Automatic token refresh
• PKCE support
• Built-in callback server

🧩 Webhooks

kick.webhooks.on("chat.message.sent", (event) => {
  console.log(event.content);
});

• Signature verification
• ngrok integration
• Event subscription helpers

💬 Chat

await kick.chat.send({ content: "Hello chat!" });

🌐 REST APIs

Available via:

kick.api.*

Currently supported:

• Categories API
• Users API
• Channels API
• Channel Rewards API
• Moderation API
• Livestreams API
• KICKs Leaderboard API

📚 Examples

The repository includes numbered examples:

| Example | Description | | ------------------------ | ------------------------ | | 01-authorize-bot | OAuth authorization | | 02-webhook | Webhook handling | | 03-ngrok | Public webhook tunneling | | 04-categories-api | Categories API | | 05-users-api | Users API | | 06-channels-api | Channels API | | 07-channel-rewards-api | Channel rewards | | 08-basic-chat-bot | Full bot template |

Run examples with:

bun example/08-basic-chat-bot

🤝 Contributing

Pull requests are welcome.

If you want to help:

• improve typings
• add new API modules
• write examples

Join the Discord server:

https://discord.gg/vkW7YMyYaf

📜 License

GPL-3.0 License See LICENSE file for details.

❤️ Part of the Manao Ecosystem

This SDK powers the ManaoBot project:

https://github.com/tinarskii/manao