API и MCP Tapbox Стат
Tapbox Стат собирает публичную статистику мессенджера MAX: каналы, чаты, ботов, их подписчиков, охваты, публикации и граф упоминаний. К этим данным есть два способа подключиться.
| Способ | Для кого | Как работает |
|---|---|---|
| REST-API | Разработчики | Ваш код обращается к адресам https://stat.tapbox.ru/api/… с заголовком X-API-Key и получает JSON |
| MCP-сервер | Все, кто работает с ИИ-агентами | Claude, Cursor, Codex или Gemini подключаются к серверу и сами вызывают нужные инструменты по вашему запросу на обычном языке |
Оба способа работают на одном ключе и расходуют одну месячную квоту. Какие способы доступны ключу, задаётся при выдаче.
Продукты
Данные разделены на два продукта, они подключаются к ключу по отдельности:
- API Stat — аналитика: подбор каналов и ботов, карточки, подписчики по дням, охваты и ERR, лента канала, разбор поста, индекс цитирования, сводка по рынку.
- API Search — полнотекстовый поиск по всем публикациям MAX и упоминания каналов.
Какие методы входят в какой продукт — на странице Продукты, лимиты и ошибки.
Быстрый старт
- Получите ключ вида
tbx_…— его выдаёт команда Tapbox Стат. Выданные на ваш аккаунт ключи, их лимиты и расход видны в профиле. - Отправьте первый запрос — например, пять крупнейших каналов тематики «Новости и СМИ»:
curl -H "X-API-Key: tbx_ваш_ключ" \
"https://stat.tapbox.ru/api/channels?category=Новости%20и%20СМИ&sort=subs&limit=5"
- Ответ — JSON со списком каналов:
{
"items": [
{
"chat_id": -68545739033120,
"handle": "max_news",
"title": "MAX • Анонсы",
"link": "https://max.ru/max_news",
"category": "Новости и СМИ",
"participants_count": 3687728,
"avg_reach": 5168586,
"err_pct": 140.2,
"citation_idx": 2222
}
],
"total": 6447,
"page": 1,
"limit": 5
}
Тот же запрос на Python и JavaScript:
import requests
r = requests.get(
"https://stat.tapbox.ru/api/channels",
params={"category": "Новости и СМИ", "sort": "subs", "limit": 5},
headers={"X-API-Key": "tbx_ваш_ключ"},
timeout=30,
)
for ch in r.json()["items"]:
print(ch["title"], ch["participants_count"])
const r = await fetch(
"https://stat.tapbox.ru/api/channels?category=" +
encodeURIComponent("Новости и СМИ") + "&sort=subs&limit=5",
{ headers: { "X-API-Key": "tbx_ваш_ключ" } }
);
const data = await r.json();
console.log(data.items.map((c) => c.title));
Что дальше
- Ключи и авторизация — как передавать ключ и хранить его.
- Продукты, лимиты и ошибки — квоты, лимит в минуту, коды ответов.
- Методы API Stat и методы API Search — справочник с параметрами и примерами.
- MCP для ИИ-агентов — подключение Claude Code, Codex, Gemini и других клиентов.
- Спецификация OpenAPI — машиночитаемое описание API для генерации клиентов и импорта в Postman.
Основной адрес API
Используйте домен stat.tapbox.ru для REST API, MCP и ссылок на профиль.