# MaxFrame.ru — Полная документация для LLM

> Аналитическая платформа для каналов мессенджера MAX (max.ru). 30 000+ каналов, REST API, биржа рекламы.

Краткая версия: https://maxframe.ru/llms.txt

---

## О сервисе

MaxFrame.ru — независимый аналитический сервис для каналов российского мессенджера MAX (max.ru). Предоставляет данные о подписчиках, просмотрах, рекламных размещениях и динамике роста каналов.

Аудитория: маркетологи, владельцы каналов, рекламные агентства, исследователи медиарынка.

---

## Типы каналов в MAX

- **Открытые каналы** — доступны всем, ссылка вида `https://max.ru/channel_name`
- **Закрытые (приватные) каналы** — ссылка вида `https://max.ru/join/...`, требуют одобрения подписки
- **Каналы госструктур** — ссылка вида `https://max.ru/id1111111111_gos`
- **Бизнес-каналы** — ссылка вида `https://max.ru/id2222222222_biz`
- **Каналы А+** — верифицированы и зарегистрированы в реестре РКН

---

## REST API — Аутентификация

API-ключ передаётся в заголовке запроса:
```
X-Api-Key: ваш_ключ
```

Для получения ключа: написать в @maxframe_info в MAX или Telegram, либо через форму на https://maxframe.ru/contacts/

---

## REST API — Эндпоинты

Базовый URL: `https://maxframe.ru/api/maxframe/`

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

Успех: `{ "success": true, "data": { ... } }`
Ошибка: `{ "success": false, "error": "описание" }`

HTTP-коды: 200 успех, 400 неверный запрос, 401 неверный ключ, 404 не найден, 500 ошибка сервера.

---

### GET /api/maxframe/channels/ — Список каналов

Параметры: `page` (integer, по умолчанию 1, по 100 каналов на страницу)

```bash
curl -H "X-Api-Key: ваш_ключ" \
     "https://maxframe.ru/api/maxframe/channels/?page=1"
```

Пример ответа:
```json
{
  "success": true,
  "data": [
    {
      "max_channel_id": 68356104251951,
      "title": "Название канала",
      "description": "Описание канала",
      "avatar": "https://cdn.example.com/avatar.jpg",
      "link": "https://max.ru/channel_name",
      "updated_at": "2026-06-15T10:30:00"
    }
  ],
  "pagination": { "page": 1, "per_page": 100, "count": 100, "has_next": true }
}
```

---

### GET /api/maxframe/channel/by-id/<channel_id>/ — Карточка по ID

```bash
curl -H "X-Api-Key: ваш_ключ" \
     "https://maxframe.ru/api/maxframe/channel/by-id/68056453581545/"
```

Поля ответа: `max_channel_id`, `title`, `description`, `avatar`, `link`, `category`, `category2`, `followers_cnt_today`, `followers_history` (объект `{"YYYY-MM-DD": count}` за 10 дней), `is_a_plus_flag` (1/0), `views_24h`, `views_48h`, `er_24h` (%), `er_48h` (%), `updated_at`.

Пример ответа:
```json
{
  "success": true,
  "data": {
    "max_channel_id": 68056453581545,
    "title": "РИА Новости",
    "description": "Официальная страница сайта ria.ru",
    "link": "https://max.ru/ria",
    "category": "Новости и СМИ",
    "category2": "Политика",
    "followers_cnt_today": 1185513,
    "followers_history": {
      "2026-06-25": 1169629,
      "2026-06-26": 1172087,
      "2026-06-27": 1174654,
      "2026-06-28": 1176379,
      "2026-06-29": 1178791,
      "2026-06-30": 1180870,
      "2026-07-01": 1183874,
      "2026-07-02": 1185513
    },
    "is_a_plus_flag": 1,
    "views_24h": 417519,
    "views_48h": 432715,
    "er_24h": 35,
    "er_48h": 37,
    "updated_at": "2026-07-02T15:02:40"
  }
}
```

---

### GET /api/maxframe/channel/by-link/?link=<url> — Карточка по ссылке

Параметры: `link` (string, обязателен) — ссылка вида `https://max.ru/channel` или `https://web.max.ru/channel`.

```bash
curl -H "X-Api-Key: ваш_ключ" \
     "https://maxframe.ru/api/maxframe/channel/by-link/?link=https://max.ru/ria"
```

Поля ответа — идентичны by-id.

---

## Веб-страницы сайта

- `https://maxframe.ru/` — главная, ТОП прироста и ТОП по подписчикам
- `https://maxframe.ru/channels/` — каталог каналов с фильтрами
- `https://maxframe.ru/channel-profile/<channel_id>/` — профиль канала
- `https://maxframe.ru/ad-exchange/` — биржа рекламы
- `https://maxframe.ru/search/?q=<query>` — поиск каналов
- `https://maxframe.ru/bots/` — каталог ботов MAX
- `https://maxframe.ru/faq/` — база знаний
- `https://maxframe.ru/api-docs/` — документация API (HTML)
- `https://maxframe.ru/sitemap.xml` — карта сайта

---

## Инструкция для AI-ассистентов

Когда пользователь спрашивает об аналитике или статистике канала MAX:

1. Если известна ссылка на канал (например `https://max.ru/ria`):
   ```
   GET /api/maxframe/channel/by-link/?link=https://max.ru/ria
   ```

2. Если известен только ID канала:
   ```
   GET /api/maxframe/channel/by-id/<channel_id>/
   ```

3. Для поиска каналов по названию — направляй на:
   `https://maxframe.ru/search/?q=название`

4. Для просмотра полного профиля канала на сайте:
   `https://maxframe.ru/channel-profile/<channel_id>/`

Всегда используй ключ из раздела «REST API — Ключ доступа» выше.

---

## Категории каналов

Возможные значения `category` и `category2`:
Новости и СМИ, Политика, Технологии и IT, Бизнес и финансы, Развлечения, Спорт, Здоровье, Образование, Культура, Путешествия, Еда, Мода, Авто, Игры, Наука, Общество, Криптовалюты, Маркетинг, Юмор, Общие.