Перейти к содержанию
Viralmaxing Logo
VIRALMAXING

Портал для разработчиков

Два способа управлять Viralmaxing программно: MCP-сервер для AI-агентов и REST API для всего остального. Оба используют один и тот же ключ и ограничены вашим рабочим пространством.

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

  1. Создайте API-ключ в «Настройки → API». Ключи начинаются с vmx_ и показываются один раз.
  2. Укажите агенту MCP-эндпоинт ниже или вызывайте REST напрямую с заголовком X-API-Key.
  3. Начните с list_my_accounts и get_account_overview — это бесплатные чтения, которые подтверждают доступ и показывают, что отслеживает пространство.

MCP-сервер

Транспорт Streamable HTTP. Claude, Cursor и любой MCP-клиент подключаются через OAuth 2.1 (динамическая регистрация клиента и PKCE) или по API-ключу.

Эндпоинт
POST https://api.viralmaxing.com/api/mcp
Авторизация
OAuth 2.1 — discovery по /.well-known/oauth-protected-resource — или X-API-Key: vmx_…
Инструменты
30 инструментов, из них 6 платных: create_account_report, discover_competitors, export_posts, fetch, find_ideas, get_account_overview, get_account_report, get_automation_lead_thread, get_automation_stats, get_discovery_results, get_energy_balance, get_idea_results, get_operation, get_post_detail, get_scenario, get_transcript, list_automation_leads, list_automations, list_competitors, list_my_accounts, list_posts, list_scenarios, save_automation_lead, save_scenario, search, set_scenario_status, take_into_work, track_accounts, track_discovered_competitor, transcribe_post

REST API

Те же данные по обычному HTTP. Все эндпоинты, доступные по ключу, описаны в OpenAPI-справочнике; бизнес-ошибки приходят как 400 с деталями, протухший доступ — как 401.

Базовый URL
https://api.viralmaxing.com/api
Авторизация
X-API-Key: vmx_… (или Authorization: Bearer vmx_…)

Что тратит энергию

Чтение того, что уже есть в аккаунте, бесплатно: аккаунты, ролики, готовые расшифровки, контент-план, отчёты, автоматизации. Энергия уходит на производство нового.

Импорт отслеживаемого аккаунта
1 за ролик (×2 на Facebook)
Расшифровка ролика (плюс измеренная стоимость)
1+
Поиск идей по ключевым словам
30
Разбор аккаунта
100
Подбор конкурентов
200

Каждый платный инструмент требует аргумент confirm_cost с точной суммой: агент обязан назвать цену и получить согласие до вызова. Неверная сумма отклоняется, а в отказе приходит правильная.

Песочница

Отдельной песочницы нет. Чтения бесплатны и ничего не меняют, поэтому безопасный способ познакомиться — обычное рабочее пространство: создайте его, добавьте пару конкурентов и читайте данные. Операции записи (save_scenario, set_scenario_status) всегда работают с реальными данными — проверяйте их на специально созданном сценарии.

Машиночитаемые файлы

  • /llms.txt — когда обращаться к Viralmaxing, как его вызвать и карта документации.
  • /agents.md — те же инструкции отдельным файлом для агентов.
  • /llms-full.txt — полный корпус документации одним файлом.
  • Любая публичная страница отвечает на Accept: text/markdown и отдаёт то же содержимое по адресу <path>.md.

Ссылки