Metrius API

Документация API

Используйте API Метриуса, чтобы получать список каналов, метрики, посты, комментарии, аудиторию, трафик, мониторинг и добавлять Telegram/MAX-каналы из внешних систем. Тем же ключом Метриус подключается по MCP к Claude и Codex.

Получить API-ключ Подключить к Claude Открыть методы Скачать OpenAPI

Быстрый старт

Получите API-ключ в Метриусе и передавайте его в заголовке Authorization. Базовый адрес API:

https://metrius.pro/api/v1

Получить API-ключ

API-ключ привязан к пользователю и workspace. Клиент видит только каналы, доступные этому workspace.

Авторизация

Все методы API требуют Bearer-токен.

Accept: application/json
Authorization: Bearer <api_key>

Права API-ключа

Право	Что разрешает
`channels:read`	Читать список и карточки каналов.
`channels:write`	Добавлять Telegram-каналы.
`metrics:read`	Читать сводные метрики и временные ряды.
`posts:read`	Читать посты и детализацию поста.
`content:read`	Читать контентную аналитику, рубрики и экспресс-анализ.
`subscribers:read`	Читать детализацию подписок и отписок.
`comments:read`	Читать комментарии.
`traffic:read`	Читать трафик, ссылки и кампании.
`monitoring:read`	Читать мониторинг аномалий.
`limits:read`	Читать лимиты и историю API-запросов.

Примеры запросов

Получить список каналов

curl -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  "https://metrius.pro/api/v1/channels"

Добавить Telegram-канал

curl -X POST "https://metrius.pro/api/v1/channels" \
  -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"provider":"telegram","link":"https://t.me/channel_username","prepare_bot":true}'

Добавить MAX-канал

curl -X POST "https://metrius.pro/api/v1/channels" \
  -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"provider":"max","link":"https://max.ru/channel_name","prepare_bot":true}'

Получить посты за период

curl -H "Authorization: Bearer $METRIUS_API_TOKEN" \
  -H "Accept: application/json" \
  "https://metrius.pro/api/v1/channels/channel_username/content/posts?from=2026-07-01&to=2026-07-07&page=1&per_page=20"

Формат ответа

Большинство методов возвращает данные в едином формате:

{
  "data": {},
  "meta": {
    "from": "2026-07-01",
    "to": "2026-07-07",
    "timezone": "Europe/Moscow"
  }
}

Коды ошибок

Код	Значение
`200`	Запрос выполнен успешно.
`201`	Канал создан.
`401`	API-ключ не передан или неверный.
`403`	Недостаточно прав API-ключа или нет доступа к ресурсу.
`404`	Канал или объект не найден.
`409`	Канал уже подключен другим владельцем.
`422`	Некорректные параметры запроса.
`429`	Превышен лимит запросов.

MCP: Метриус в Claude и Codex

Метриус отдаёт те же данные по протоколу MCP, поэтому Claude, Codex и другие MCP-клиенты могут работать с подключёнными каналами напрямую: строить отчёты, разбирать посты и комментарии, искать причины роста и оттока. Подключение — по одному адресу, с подтверждением доступа в Метриусе.

Сначала подключите канал в Метриусе — MCP видит только каналы вашей рабочей группы. Права тоже действуют: если вы не выдали доступ к постам, модель их не получит.

Claude — по адресу, без ключа

Настройки → Коннекторы → Добавить свой коннектор. Вставьте адрес и подтвердите доступ на открывшейся странице Метриуса — ключ вводить не нужно.

https://metrius.pro/mcp

Claude Code

Авторизация пройдёт при первом обращении, в браузере:

claude mcp add --transport http metrius https://metrius.pro/mcp

Codex CLI

В ~/.codex/config.toml:

[mcp_servers.metrius]
command = "npx"
args = ["-y", "mcp-remote", "https://metrius.pro/mcp"]

Если удобнее API-ключ

Клиенты, умеющие свои заголовки, работают и с обычным ключом из профиля:

claude mcp add --transport http metrius https://metrius.pro/mcp \
  --header "Authorization: Bearer <api_key>"

Что умеет модель

Инструмент	Что даёт
`list_channels`, `get_channel`, `add_channel`	Список каналов рабочей группы, карточка канала, подключение нового.
`get_channel_overview`, `get_metrics_timeseries`	Сводные метрики за период и динамика по дням.
`list_posts`, `get_post`, `list_comments`	Посты с показателями, детализация публикации, комментарии аудитории.
`list_subscriber_events`	Кто подписался и отписался, когда и по какой ссылке.
`get_content_overview`, `get_express_analysis`, `list_rubrics`	Контент-аналитика, сохранённый экспресс-анализ, рубрики.
`get_traffic_overview`, `list_traffic_links`, `list_campaigns`	Источники трафика, ссылки и кампании с окупаемостью.
`get_monitoring`	Аномалии в аудитории, охвате и активности.
`get_api_limits`, `get_api_usage_history`	Остаток лимита ключа и история запросов.

Плюс готовые сценарии исследований: отчёт по каналу, разбор роста и оттока, анализ контента и разбор отдельного поста.

Инструкция и кейсы по MCP

Справочник методов

Интерактивная документация собрана из OpenAPI-спецификации. Ее можно использовать в Swagger UI, Postman и других API-клиентах.