REST API + MCP Server

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

Автоматизируйте SMM программно. 8 групп эндпоинтов, 12 платформ, подключение к AI‑агентам через MCP.

8
Групп эндпоинтов
12
Платформ
19
MCP-инструментов
99.9%
Uptime

REST API

Base URL: https://publpost.ru/api/v1

Posts

Создание, редактирование, публикация, дублирование постов

GETPOSTPATCHDELETE

Accounts

Список подключённых соцсетей, отключение

GETDELETE

Media

Загрузка изображений/видео, импорт по URL, управление файлами

GETPOSTDELETE

Labels

Метки для организации постов по категориям и темам

GETPOSTPATCHDELETE

Campaigns

UTM-шаблоны для автоматической разметки ссылок

GETPOSTPATCHDELETE

Comments

Единый Inbox: чтение, ответы, модерация комментариев

GETPOSTDELETE

Analytics

Сводная статистика, метрики постов и аккаунтов

GETPOST

AI

Exclusive

Генерация текста, подписей и изображений через AI

POST

Примеры кода

Создайте запланированный пост на любом языке

curl -X POST "https://publpost.ru/api/v1/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 12,
    "content": [{
      "text": "Post Once. Publish everywhere. 🚀",
      "media": []
    }],
    "schedule_type": "schedule",
    "date": "2026-04-20",
    "time": "15:00",
    "timezone": "Europe/Moscow"
  }'

MCP Server

19 инструментов для AI-агентов — Claude, Cursor, Windsurf и других

Что умеет MCP

MCP-сервер PublPost реализует инструменты, повторяющие API v1. AI-ассистенты управляют контентом через структурированные действия.

  • Workspaces — контекст и подключённые аккаунты
  • Posts — создание, планирование, обновление, удаление
  • Comments — Inbox: чтение, ответы, модерация, скрытие
  • Analytics — сводка, метрики, синхронизация
  • Labels & Campaigns — организация контента

Параметры подключения

URLhttps://publpost.ru/mcp
ТранспортStreamable HTTP
АвторизацияBearer YOUR_TOKEN
claude mcp add --transport http postpilot https://publpost.ru/mcp \
  --header "Authorization: Bearer YOUR_TOKEN_HERE"

Аутентификация

Все запросы авторизуются через Bearer-токен

Как получить ключ

  1. Войдите в PublPost
  2. Откройте Настройки → API-интеграции
  3. Нажмите «Создать» и выберите области доступа
  4. Скопируйте ключ — он покажется только один раз
Authorization: Bearer YOUR_API_TOKEN

Области доступа (abilities)

При создании токена выберите нужные abilities — они ограничивают, какие эндпоинты доступны:

workspacesaccountslabelscampaignspostscommentsanalyticsai

Обращайтесь с токенами как с паролями от продакшена. Они могут публиковать посты, удалять контент и отключать аккаунты. Храните в переменных окружения.

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

JSON со стандартными HTTP-кодами статуса

Успешный ответ

{
  "data": {
    "id": "post_abc123",
    "text": "Post Once. Publish everywhere. 🚀",
    "status": "scheduled",
    "schedule_at": "2026-04-20T15:00:00+03:00",
    "accounts": [...]
  }
}

Ошибка

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Поле content обязательно",
    "details": [
      { "field": "content", "rule": "required" }
    ]
  }
}

Лимиты

60 запросов в минуту на один API-ключ

ЗаголовокОписание
X-RateLimit-LimitОбщее количество запросов в текущем окне
X-RateLimit-RemainingОставшиеся запросы в текущем окне
X-RateLimit-ResetUNIX-время сброса окна

При превышении лимита сервер вернёт 429 Too Many Requests. Дождитесь сброса окна или реализуйте exponential backoff.

12 платформ

Публикуйте через один API во все соцсети

TelegramVKInstagramTikTokYouTubeОдноклассникиДзенX (Twitter)FacebookLinkedInPinterestThreads

Полная документация

Подробные описания эндпоинтов, параметры, примеры ответов и Try It — в Developer Portal внутри дашборда.

Зарегистрироваться

Готовы автоматизировать?

Получите API-ключ за 30 секунд и начните публиковать программно.

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