peturgeorgievv-factory/postfast-mcp

Назначает разговор участнику рабочего пространства для последующей работы или опускает assigneeUserId, чтобы снять назначение. Назначаемый должен быть участником рабочего пространства (иначе inbox.assigneeNotMember). Внутреннее для PostFast — ничего не меняется на платформе.

Создаёт и планирует посты в социальных сетях (пакет до 15). Каждый пост нацелен на один социальный аккаунт (socialMediaId из list_accounts). SCHEDULED требует scheduledAt для каждого поста; DRAFT должен опускать scheduledAt. Планирование для отключённого аккаунта (connectionStatus DISABLED в list_accounts) отклоняется с HTTP 400 "socialMediaDisconnected". Предварительно проверьте connectionStatus перед вызовом. Сохранение как DRAFT для отключённого аккаунта разрешено. TikTok, Instagram, YouTube и Pinterest требуют хотя бы один медиаэлемент ДАЖЕ ДЛЯ ЧЕРНОВИКОВ. Сначала прикрепите медиа (спросите у пользователя изображение/видео или сгенерируйте и загрузите, если ничего не предоставлено). Google Business Profile принимает посты только с текстом, или одно изображение и без видео. Пост содержит не более 10 медиаэлементов. Прикрепите медиа с помощью ключа, возвращаемого upload_media / get_upload_urls. Пост в Threads может содержать одну тему, задаваемую с помощью controls.threadsTopicTag; как и каждый control, он применяется ко всем постам в вызове, поэтому размещайте посты в Threads с разными темами в отдельных вызовах.

Удаляет пост в социальной сети по идентификатору.

Удаляет несколько постов в социальных сетях по id за один вызов (до 100; для одного поста используйте delete_post). Удаляет каждый пост из PostFast: его запись, расписание и сохранённые медиафайлы. При этом НЕ удаляет ничего с социальной платформы: пост, который уже опубликован, остаётся там, и удалять его нужно на самой платформе. Удаление ЗАПЛАНИРОВАННОГО поста, который ещё не опубликован, как раз не даёт ему опубликоваться. Возвращает { deletedIds, notFoundIds }; notFoundIds - это id, которых нет в этом workspace, каждый из них указан один раз. Удаление нельзя отменить.

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

Ежедневные снимки количества подписчиков для одной подключенной учетной записи (передайте её socialMediaId из list_accounts). Возвращает currentFollowerCount, delta (текущее значение минус первый снимок в диапазоне), trackingStartedAt (когда PostFast начал запись этой учетной записи) и серию точек { capturedAt, followerCount }. Все значения - строки (bigint); currentFollowerCount, delta и trackingStartedAt могут отсутствовать, пока у учетной записи не появится первый снимок. Необязательные from/to ограничивают диапазон (ISO 8601; по умолчанию последние 90 дней, максимум 365). Снимки только прямые, данные до trackingStartedAt отсутствуют. Охват: страницы Facebook, Instagram, YouTube, Pinterest, Threads, Bluesky, Telegram, страницы компаний LinkedIn и TikTok. Недоступно: X, личный Facebook.

Получает один диалог из входящих по идентификатору, включая вычисленную сервером возможность ответа (canReply, maxReplyLength, windowState, disabledReason) - возможность ответа выводится из этих полей, а не из жёстко заданных правил платформы. Возвращает null, если диалог не существует в рабочей области.

Общее количество непрочитанных комментариев во всех беседах входящих рабочего пространства (сумма unreadCount для каждой беседы). Используйте mark_inbox_conversation_read после показа беседы пользователю.

Получает опубликованные посты с их последними показателями эффективности (показы, охват, лайки, комментарии, репосты). Возвращает только опубликованные посты, у которых есть идентификатор поста на платформе. Личные аккаунты LinkedIn исключены. Поддерживаются: Instagram, Facebook, TikTok, Threads, YouTube, LinkedIn (страницы компаний), Pinterest (бизнес-аккаунты). Значения метрик возвращаются в виде строк. Дополнительные метрики Pinterest включают pin_clicks, outbound_clicks, saves_90d, save_rate_90d (сохранения за 90 дней скользящие, так как API Pinterest не предоставляет общие данные за всё время); видео-пины дополнительно показывают mrc_views, views_10s, avg_watch_time, v50_watch_time, video_starts, quartile_95_views. Видеопосты также включают нормированное время просмотра в latestMetric: avgWatchTimeSeconds, totalWatchTimeSeconds, videoViews (Facebook, Instagram Reels, YouTube, Pinterest, страницы компаний LinkedIn, TikTok). Посты Instagram также включают в latestMetric: saveRate (сохранения / охват в процентах, округлённый до 2 знаков — для ленты IG, Reels и каруселей с метриками) и reelsSkipRate (только для Instagram Reels — процент зрителей, которые пропустили Reels в первые 3 секунды, согласно данным Instagram, округлённый до 2 знаков; может отсутствовать для Reels с малым числом просмотров или до обновления метрик). TikTok также предоставляет total_time_watched, average_time_watched и full_video_watched_rate в metric.extras.

Получает подписанные URL для загрузки медиа, файлов субтитров и документов LinkedIn. Загрузите свой файл по возвращённому URL через PUT, затем используйте ключ в mediaItems create_posts; ключ файла субтитров (.srt или .vtt) идёт в controls.youtubeCaptionKey вместо этого, никогда в mediaItems; ключ документа (.pdf, .doc, .docx, .ppt или .pptx) идёт в controls.linkedinAttachmentKey вместо этого, никогда в mediaItems.

Перечисляет все аккаунты в социальных сетях, подключённые к рабочому пространству. Каждый аккаунт включает connectionStatus (CONNECTED или DISABLED) и disabledReason (null, если не DISABLED), а также followerCount (последний сохранённый снимок, строка; отсутствует для платформ без данных о подписчиках), followerCountUpdatedAt и inboxCapable (может ли аккаунт отображаться в папке входящих социальной сети, т.е. поддерживается ли приём комментариев). Аккаунт со статусом DISABLED не будет публиковать посты, пока пользователь не переподключит его — проверяйте перед планированием. Для отслеживания динамики подписчиков с течением времени используйте get_follower_history.

Выводит список мест Google Business Profile для подключенной учётной записи GBP (передайте её socialMediaId). Используйте поле locationId возвращённого места как controls.gbpLocationId в create_posts.

Перечисляет обсуждения комментариев из социального входящего — комментарии к постам ваших подключённых аккаунтов, сгруппированные по постам, сначала самые новые. Охватывает TikTok (Business connections), Instagram, Facebook Pages и Threads; комментарии приходят в течение нескольких секунд после публикации и только начиная с момента подключения/запуска (без обратного заполнения истории). Каждое обсуждение содержит вычисляемую сервером возможность ответа — canReply, maxReplyLength, windowState, disabledReason — плюс unreadCount, status (OPEN | SNOOZED | CLOSED) и assignedToUserId. ВСЕГДА определяйте, можете ли вы ответить и как долго, по этим полям; никогда не угадывайте.

Перечисляет элементы одного разговора в папке входящих — комментарии и ответы на них — сначала самые старые по умолчанию (order=DESC для самых новых). Элементы содержат направление (INBOUND | OUTBOUND), состояние (VISIBLE | HIDDEN | DELETED), информацию об авторе, а для комментариев Instagram — canPrivateReply (возможность отправки send_inbox_private_reply). Ответы, отправленные из PostFast, отображаются ровно один раз — без дубликатов, когда платформа сообщает о них.

Перечисляет доски Pinterest для подключённой учётной записи Pinterest (передайте её socialMediaId). Используйте поле boardId возвращённой доски как controls.pinterestBoardId в create_posts.

Выводит список публикаций в социальных сетях с необязательными фильтрами по конкретным ID, аккаунтам, платформе, статусу и диапазону дат. Неудачные или пропущенные публикации содержат lastError { message, code }; коды включают MISSED_DISCONNECTED (аккаунт был отключён, когда публикация должна была выйти: переподключитесь и повторите попытку) и MISSED_NOT_PUBLISHED (прошло запланированное время плюс 2-часовое окно отсрочки, а публикация так и не вышла). Каждая публикация также содержит controls { threadsTopicTag, instagramPublishType, facebookContentType, tiktokIsDraft, youtubePrivacy }, каждое поле равно null, если не задано. Имеет значение только поле для собственной платформы публикации (платформа её аккаунта в list_accounts): публикации, созданные через API, хранят значения по умолчанию для всех платформ, поэтому остальные поля могут быть не null.

Возвращает список трендовых предварительно одобренных треков Commercial Music Library для подключенного аккаунта TikTok. Возвращает до 100 трендовых звуков с musicSoundId, name, artist, duration и URL-адресами предпросмотра/миниатюры. Передайте musicSoundId в create_posts как tiktokMusicSoundId, чтобы прикрепить этот звук к посту TikTok с фото, каруселью или видео. genre принимает исходные значения TikTok, такие как 'POP', 'HIP_HOP/RAP', 'R&B/SOUL', 'K-POP' (неверные значения возвращают полный список допустимых значений в ошибке). Список обновляется ежедневно. Получайте свежие данные, а не используйте старые id для отображения. Неизвестный countryCode возвращает пустой список. Если API возвращает tiktokMusic.requiresBusinessApi, аккаунту TikTok требуется однократное переподключение.

Выводит список плейлистов YouTube для подключенной учетной записи YouTube (передайте её socialMediaId). Используйте поле playlistId возвращенного плейлиста как controls.youtubePlaylistId в create_posts.

Помечает один разговор как прочитанный (обнуляет его unreadCount). Делает это после показа комментариев к разговору пользователю. Внутренняя функция PostFast — на платформе ничего не меняется.

Отвечай публично ПОД конкретным комментарием — передавай идентификатор элемента комментария (из list_inbox_items), а не идентификатор беседы. ПЕРЕД ответом проверяй canReply и maxReplyLength беседы и соблюдай их; ограничения зависят от платформы (TikTok 150, Instagram 2 200, Facebook 8 000, Threads 500 символов), но авторитетны поля, вычисленные сервером — никогда не предполагай. Ошибки возвращают коды inbox.* (например, replyTooLong, replyNotSupported).

Ищет место для геотега поста. Принимает произвольный текст (минимум 2 символа, например, название заведения или адрес); возвращает соответствующие места, каждое с идентификатором, который работает КАК controls.facebookPlaceId (посты в ленте Facebook), ТАК И controls.instagramLocationId (одиночные медиа-посты Instagram). Возвращает только страницы Facebook, содержащие данные о местоположении.

Instagram: отправляет один частный ответ на комментарий, он приходит как личное сообщение автору комментария и может попасть в папку Message Requests. Разрешён один раз на комментарий, в течение 7 дней после комментария, до 1000 байт (эмодзи и нелатинский текст занимают несколько байт, примерно 1000 символов, меньше с эмодзи). Сначала проверьте canPrivateReply элемента (из list_inbox_items). Повторная попытка на том же комментарии завершается ошибкой inbox.privateReplyAlreadySent; другие ошибки: privateReplyWindowExpired и privateReplyNotSupported.

Триаджирует разговор: устанавливает его статус OPEN, SNOOZED или CLOSED. Внутреннее для PostFast — на платформе ничего не меняется.

Модерирует комментарий на платформе: HIDE скрывает его от публики, UNHIDE восстанавливает, DELETE удаляет комментарий на платформе - отмена невозможна. Hide/unhide работают на TikTok, Instagram, Facebook и Threads; DELETE не поддерживается на Threads (inbox.deleteNotSupported). Изменения состояния, сделанные на самой платформе, автоматически синхронизируются обратно с папкой входящих.

Загружает локальный файл в PostFast и возвращает медиа-ключ для использования в create_posts. Выполняет весь цикл: определяет тип контента, получает подписанный URL, загружает файл и возвращает ключ и тип. Изображения и видео возвращаются как IMAGE или VIDEO для mediaItems; файл субтитров .srt или .vtt возвращается как CAPTION, а его ключ идёт в controls.youtubeCaptionKey, никогда в mediaItems; документ .pdf, .doc, .docx, .ppt или .pptx возвращается как DOCUMENT, а его ключ идёт в controls.linkedinAttachmentKey, никогда в mediaItems.