# project-mirai/mirai-api-http

Mirai HTTP API (console) plugin

Repository: https://github.com/project-mirai/mirai-api-http
Canonical: https://ross.abutalabs.com/products/mirai-api-http
Language: Kotlin
License: AGPL-3.0
License Family: copyleft
Last push: 2024-04-24T05:31:09+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2379, "days_push": 861, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1665, forks 327 (observed 2026-08-28T04:05:19.543034+00:00)

## What it is
A Mirai Console plugin that exposes the Mirai QQ bot framework over HTTP, WebSocket, reverse-WebSocket, and webhook adapters so any programming language can control a QQ bot. It provides session-based authentication and configurable adapters for building chatbots on the QQ messaging platform.

## Use cases
- build a QQ chatbot in Python or JavaScript
- control a Mirai bot over HTTP API
- receive QQ messages via websocket
- integrate QQ bot events into my app via webhook
- run a QQ bot server and call it from any language

## When to choose
- you use the Mirai framework and need language-agnostic access to QQ bot APIs
- you want to drive a QQ bot from an external service via HTTP or WebSocket

## When to avoid
- you need a protocol other than QQ (e.g. Telegram or Discord)
- you want a standalone bot framework without the Mirai Console ecosystem

## Facets
- artifact type: plugin
- maturity: maintenance
- function: http-server, websocket, webhook, chatbot, middleware
- domain: chatbots, messaging-platforms, developer-tools
- platform: jvm, cross-platform, self-hosted
- tags: qq-bot, mirai-console, kotlin, bot-framework, http-api, adapter, automation

## Member repositories
- project-mirai/mirai-api-http (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:19.543034+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:44:26.910711+00:00, confidence not recorded.
  - readme: https://github.com/project-mirai/mirai-api-http (fetched 2026-08-28T04:05:19.543034+00:00, sha adb6a3eae7eb)
- Data as of 2026-08-30T08:39:29.467469+00:00.