Для разработчиков
Сервер Welder MCP
Welder — удалённый MCP-сервер по адресу https://weldergtm.com/mcp. Сначала вызовите get_context. Для публикации используйте create_post, а файлы передавайте через create_upload (из терминала) или create_upload_link (из чата). Эта страница предназначена для разработчиков; в остальных разделах технические термины не нужны.
Адрес сервера#
POST https://weldergtm.com/mcp- Streamable HTTP без сохранения состояния: идентификатор сеанса не требуется. Версии протокола 2025-11-25, 2025-06-18, 2025-03-26 и 2024-11-05.
- Ответы возвращаются в JSON. С заголовком Accept: text/event-stream возможен поток, содержащий ровно один ответ.
- Запросы до 1 MiB, пакеты до 20 запросов. GET и DELETE для /mcp возвращают 405.
- Каждый инструмент возвращает структурированные данные и краткую текстовую версию для озвучивания моделью. Также он объявляет название и четыре аннотации MCP: read-only, destructive, open-world и idempotent.
Вход и права доступа#
OAuth 2.1 (предпочтительно). Клиенты обнаруживают параметры подключения автоматически: запрос без входа получает 401 со ссылкой на метаданные защищённого ресурса. Клиенты регистрируются динамически; вход проходит в браузере с PKCE. Токены доступа действуют час, обновление доступно в течение 90 дней.
https://weldergtm.com/.well-known/oauth-protected-resource
https://weldergtm.com/.well-known/oauth-authorization-serverПрава доступа. Каждый инструмент требует входа и объявляет необходимые права в securitySchemes. read разрешает чтение данных рабочего пространства, проверку и доступ к сохранённой статистике (9 инструментов); get_post также может запросить у TikTok ожидаемую ссылку и сохранить её, поэтому не помечен как read-only. publish разрешает загрузку файлов, получение ссылок для подключения аккаунтов, публикацию, отмену, удаление, закрытие предупреждений и все вызовы, которые могут менять состояние или расходовать кредиты (12 инструментов): в их числе ожидание загрузки по ссылке, обновление показателей и чтение ответов. Если нужного права нет, возвращается forbidden.
API-ключи. Для клиентов без OAuth, скриптов и CI. Создайте ключ в разделе Дополнительно → Ключи и передавайте его как Bearer-токен. Ключи начинаются с wk_live_, показываются только один раз и предоставляют оба права.
curl -X POST https://weldergtm.com/mcp \
-H "Authorization: Bearer {key}" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Данные для доступа относятся ровно к одному рабочему пространству. Отдельный заголовок с его ID не нужен.
Подключение в приложении для работы с кодом#
Для каждого приложения есть пошаговая инструкция с точной командой или конфигурацией. Краткий вариант:
Claude CodeИнструкция
claude mcp add --transport http welder https://weldergtm.com/mcpCodex CLIИнструкция
codex mcp add welder --url https://weldergtm.com/mcpCursorИнструкция
{
"mcpServers": {
"welder": { "url": "https://weldergtm.com/mcp" }
}
}WindsurfИнструкция
{
"mcpServers": {
"welder": { "serverUrl": "https://weldergtm.com/mcp" }
}
}Gemini CLIИнструкция
gemini mcp add --transport http welder https://weldergtm.com/mcpVS Code (Copilot)Инструкция
code --add-mcp '{"name":"welder","type":"http","url":"https://weldergtm.com/mcp"}'ClineИнструкция
Откройте Cline → MCP Servers → Remote Servers и добавьте сервер с именем welder и URL https://weldergtm.com/mcp.
Google AntigravityИнструкция
{
"mcpServers": {
"welder": { "serverUrl": "https://weldergtm.com/mcp" }
}
}KiroИнструкция
{
"mcpServers": {
"welder": {
"url": "https://weldergtm.com/mcp"
}
}
}Kimi CodeИнструкция
{
"mcpServers": {
"welder": { "url": "https://weldergtm.com/mcp" }
}
}Any client or scriptИнструкция
https://weldergtm.com/mcpИли попросите помощника подключить Welder самостоятельно:
Подключите MCP-сервер Welder штатным способом для этого приложения (HTTP, URL https://weldergtm.com/mcp). Затем вызовите инструмент `get_context` и сообщите, какие аккаунты подключены. Не выводите ключи и другие данные для доступа в ответе.Плагин Welder#
Welder: автопостинг в TikTok, Instagram и YouTube содержит пять готовых сценариев с подключением к этому серверу: начать и подключить, опубликовать контент, запланировать публикации, посмотреть результаты и работать с комментариями. Пакет содержит инструкции, настройки подключения и изображения Welder. Он не устанавливает программы, фоновые процессы или хуки и не содержит ключей или паролей. Для подключения вы входите в Welder через браузер, используя вход из вашего приложения.
Claude Code. Добавьте каталог плагинов и установите плагин. Вводите команды по одной в Claude Code. Затем выполните /mcp, выберите сервер Welder и нажмите Authenticate. Откроется браузер для входа.
/plugin marketplace add Endless-River-Labs/welder-plugins
/plugin install welder-social-manager@welder-pluginsCodex. Codex CLI устанавливает тот же пакет из открытого репозитория. Войдите в Welder через встроенную процедуру входа Codex. Откроется браузер для подтверждения доступа.
codex plugin marketplace add Endless-River-Labs/welder-plugins
codex plugin add welder-social-manager@welder-pluginsНужен только сервер, без готовых сценариев? Добавьте его и один раз войдите в аккаунт:
codex mcp add welder --url https://weldergtm.com/mcp
codex mcp login welderChatGPT. Установите официальный плагин из каталога плагинов ChatGPT в одно нажатие и войдите в аккаунт: Welder: Social Autoposting. Инструкции для ChatGPT показывают каждый экран настройки.
Приложение Claude. Добавьте https://weldergtm.com/mcp как пользовательский коннектор в настройках и войдите в аккаунт. Инструкции для Claude показывают каждый экран настройки.
Каталоги плагинов. Welder есть в каталоге плагинов ChatGPT. Каталог Claude проверяет и одобряет плагин перед размещением; пока этого не произошло, установите плагин из публичного репозитория или подключите Welder напрямую.
Инструменты#
Рабочее пространство и аккаунты
Файлы
Публикации
Результаты и справка
Требует права publish. Остальным инструментам достаточно read.
Рабочее пространство и аккаунты
Кто подключен, что можно публиковать и как подключить другую сеть.
get_connected_profile
readПолучить профиль Welder. Аннотации: Только чтение, Идемпотентный
Определяет рабочее пространство Welder, которому принадлежат данные для доступа. Это позволяет клиенту с несколькими аккаунтами различать их.
Параметры не требуются.
Возвращает
{ id }
- id — постоянный непрозрачный идентификатор рабочего пространства, определяемый только по проверенным данным для доступа. Он не содержит email, название рабочего пространства или данные для доступа.
- Помечен как инструмент аутентифицированного профиля (_meta["openai/profile"]: true). Текстовое содержимое содержит тот же JSON, что и структурированный результат.
get_connected_profile({}){ "id": "7c1e2a9d-…" }get_context
readПолучить контекст публикации Welder. Аннотации: Только чтение, Идемпотентный
Начните с этого инструмента. Он возвращает рабочее пространство, доступность публикации, месячные лимиты и расход, подключённые аккаунты, поддерживаемые форматы и способы передачи файлов.
Параметры не требуются.
Возвращает
{ setup: { stage, accounts, access, notice, next_step }, workspace: { id, name, locale, plan_status, limits: { posts, x_credits }, usage: { posts, x_credits }, can_publish, access }, accounts: Account[], capabilities: { tiktok, instagram, facebook, youtube, threads, bluesky, x }, media_hint, links: { app, connect_accounts, plans, guide }, server: { version }, next_step? }
- setup.next_step is an assistant intent: “Ask one question: what to post (an attached photo or video, or a topic) и where. Say you'll show the post before it goes live. Do not list formats, limits or setup steps. Connect a network only when the post is ready. If the person already asked for a post, do it instead of introducing Welder. When you do introduce Welder, add links.guide once: everything it can do, per network.” Access notices are shown while posting; plans links open the Welder website.
- Пока нет активных соцсетей, setup.next_step предлагает короткое приветствие: доступные сети, повторное подключение неактивных аккаунтов, текущая доступность публикации, ограничения X, ссылки links.connect_accounts и links.guide.
- links.guide — публичная страница со всеми возможностями Welder и соцсетями для каждого сценария, на языке рабочего пространства (locale).
- capabilities is keyed by network with formats и key limits; get_capabilities returns the full matrix.
- В демонстрационном рабочем пространстве для проверки результат также содержит review_demo: true и строку data_source. Поле media_hint поясняет, какие примеры медиа доступны. См. раздел о проверочном рабочем пространстве ниже.
get_context({}){
"setup": { "stage": "active", "accounts": [{ "provider": "x", "username": "nightshiftHQ" }], "access": { "state": "plan", "can_publish": true, "included": null, "x_included": false, "saved_posts": 0, "saved_until": null }, "notice": null, "next_step": "Ask one question: what to post (an attached photo or video, or a topic) and where. Say you'll show the post before it goes live. Do not list formats, limits or setup steps. Connect a network only when the post is ready. If the person already asked for a post, do it instead of introducing Welder. When you do introduce Welder, add links.guide once: everything it can do, per network." },
"workspace": {
"id": "7c1e2a9d-…",
"name": "Nightshift Studio",
"locale": "en",
"plan_status": "active",
"limits": { "posts": 1500, "x_credits": 100 },
"usage": { "posts": 3, "x_credits": 8 },
"can_publish": true,
"access": { "state": "plan", "can_publish": true, "included": null, "x_included": false, "saved_posts": 0, "saved_until": null }
},
"accounts": [{ "id": "b2d4…", "provider": "x", "username": "nightshiftHQ", "status": "active", … }],
"capabilities": { "tiktok": { … }, "instagram": { … }, … },
"media_hint": "In chat apps without a shell, use create_upload_link and show its URL to the person; then get_upload_link for media ids. With a shell, use create_upload and finalize_upload.",
"links": {
"app": "https://weldergtm.com/app",
"connect_accounts": "https://weldergtm.com/app/accounts",
"plans": "https://weldergtm.com/pricing",
"guide": "https://weldergtm.com/features"
},
"server": { "version": "0.1.0" }
}list_accounts
readСписок подключенных социальных аккаунтов. Аннотации: Только чтение, Идемпотентный
Подключенные аккаунты с указанием их статуса и того, что каждый может публиковать. Используйте идентификаторы в качестве целей create_post.
Параметры не требуются.
Возвращает
{ accounts: [{ id, provider, username, display_name, avatar_url, profile_url, status: 'active' | 'reauth_required' | 'disconnected', capabilities, features?, connected_at, expires_at, defaults, last_error }] }
- defaults содержит сведения, которые могут понадобиться агенту: например доступные аккаунту уровни видимости TikTok или тип аккаунта Instagram.
- features перечисляет возможности подключения при выданных пользователем разрешениях: publish, insights, comments, replies, delete и revenue (расчётный доход YouTube, только для монетизированных каналов). Если соцсеть одобрила больше, чем запрашивалось у старого подключения, повторное подключение включает недостающие функции; публикация работает и без него.
- Аккаунт Facebook — это одна страница Facebook. Его username — имя пользователя страницы, а если его нет — название страницы.
connect_account
publishПодключить аккаунт соцсети. Аннотации: Изменяет данные
Ссылка на подключение соцсети в браузере пользователя, действующая 10 минут. Покажите её пользователю и вызовите list_accounts после завершения подключения.
| Параметр | Тип | Описание |
|---|---|---|
providerобязателен'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'threads' | 'bluesky' | 'x' | 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'threads' | 'bluesky' | 'x' | Сеть для подключения. |
Возвращает
{ provider, url, expires_in }
- Пользователь входит на странице самой соцсети; помощник не получает пароль. Для Bluesky ссылка открывает форму ввода пароля приложения. В Facebook пользователь выбирает страницы на экране Facebook: каждая страница, где он может публиковать, становится отдельным аккаунтом в пределах лимита аккаунтов тарифа.
- Повторное подключение того же аккаунта обновляет его: ID аккаунта, запланированные публикации и история сохраняются, а функции, которые соцсеть одобрила с тех пор, включаются.
- В демонстрационном рабочем пространстве для проверки возвращает forbidden: тестовые аккаунты в нём добавлены Welder.
Файлы
Передача фото или видео в Welder: ссылка для загрузки из чата, подписанная загрузка из терминала или публичный URL.
create_upload_link
publishСоздайте ссылку для загрузки в браузере. Аннотации: Изменяет данные
Для приложений без терминала: ссылка для загрузки файлов в браузере. Покажите её пользователю, затем вызовите get_upload_link.
| Параметр | Тип | Описание |
|---|---|---|
notestring (≤140) | string (≤140) | Текст на странице загрузки, например «Загрузите сюда видео с латте». |
max_files1–10 | 1–10 | Сколько файлов можно загрузить по ссылке. По умолчанию 1. |
kind'video' | 'image' | 'any' | 'video' | 'image' | 'any' | Допустимые типы файлов. По умолчанию any. |
Возвращает
{ upload_link_id, url, expires_in, max_files, kind, next }
- Ссылка действует 2 часа. Её URL даёт доступ к загрузке: покажите его пользователю, но не записывайте в логи.
get_upload_link
publishПолучить результаты загрузки через браузер. Аннотации: Изменяет данные
ID файлов, загруженных пользователем по ссылке, для create_post. Ожидание задаётся через wait_seconds.
| Параметр | Тип | Описание |
|---|---|---|
upload_link_idобязателенstring (uuid) | string (uuid) | Из create_upload_link. |
wait_seconds0–50 | 0–50 | Дождаться завершения загрузки и вернуть ответ. Пока status равен open, можно повторять вызов. По умолчанию 0. |
Возвращает
{ status: 'open' | 'completed' | 'expired', max_files, media: Media[] }
- Возвращаются только готовые медиафайлы в порядке загрузки.
- Если ссылка ещё открыта и файлов меньше max_files, загрузка может продолжаться. Подождите, пока пользователь добавляет файлы; используйте ID, когда он закончит. Готовые файлы с заполненной или закрытой ссылки можно отправить в пост. Если ссылка завершена, но доступных файлов нет, создайте новую через create_upload_link.
- Требует права publish: вызов может перевести просроченную ссылку в статус expired.
list_media
readСписок загруженных медиафайлов. Аннотации: Только чтение, Идемпотентный
Последние загрузки, сначала самые новые, для таких запросов, как «опубликовать мою последнюю загрузку». Файлы с истекшим сроком хранения не учитываются.
| Параметр | Тип | Описание |
|---|---|---|
limit1–50 | 1–50 | По умолчанию 10. |
status'ready' | 'pending' | 'ready' | 'pending' | Фильтровать по статусу. |
Возвращает
{ media: [{ id, kind, mime, bytes, width, height, duration_ms, filename, status, error, preview_url: null, expires_at, created_at }] }
create_upload
publishСоздать загрузку медиафайла. Аннотации: Изменяет данные
Для агентов с терминалом: резервирует место под медиафайл, возвращает подписанный URL и точную команду curl для загрузки локального файла методом PUT.
| Параметр | Тип | Описание |
|---|---|---|
filenameобязателенstring | string | Исходное имя файла, например launch.mp4. |
mimeобязателен'image/jpeg' | 'image/png' | 'image/webp' | 'video/mp4' | 'video/quicktime' | 'image/jpeg' | 'image/png' | 'image/webp' | 'video/mp4' | 'video/quicktime' | Тип файла. |
bytesобязателенinteger | integer | Размер файла в байтах. Изображения до 30 МБ, видео до 500 МБ. |
Возвращает
{ media_id, upload: { method: 'PUT', url, headers }, expires_in, curl, next? }
- URL загрузки действует 2 часа и даёт доступ к загрузке. Оригиналы хранятся 7 дней; у каждой публикации с медиа в истории остаётся одно небольшое изображение. Файлы сохранённых постов хранятся до окончания срока хранения поста — 14 дней после сохранения.
- Отправьте файл методом PUT, затем вызовите finalize_upload. Для ChatGPT также возвращаются инструкции next: если PUT недоступен, попросите человека прикрепить файл в чате и передайте его в create_post через files.
curl -sS -X PUT -H "Content-Type: video/mp4" --upload-file "launch.mp4" "<upload url>"finalize_upload
publishЗавершить загрузку медиафайла. Аннотации: Изменяет данные, Идемпотентный
Проверяет загруженный файл: размер, тип, а по возможности — разрешение и длительность. Помечает его как готовый. Повторный вызов для готового файла вернёт тот же медиафайл.
| Параметр | Тип | Описание |
|---|---|---|
media_idобязателенstring (uuid) | string (uuid) | Из create_upload. |
Возвращает
{ media: Media }
- Если файл ещё не загружен, возвращает media_not_ready. Можно безопасно повторить вызов чуть позже.
import_media
publishИмпортировать медиафайлы с общедоступного URL-адреса. Аннотации: Изменяет данные, Внешние обращения (open-world)
Загружает публичный файл по HTTPS в хранилище Welder вместо загрузки с диска.
| Параметр | Тип | Описание |
|---|---|---|
urlобязателенstring (https) | string (https) | URL-адрес общедоступного файла. Частные сети и более трех редиректов отклонены. |
filenamestring | string | Необязательное имя файла. |
Возвращает
{ media: Media }
- В демонстрационном рабочем пространстве для проверки разрешён импорт только публичных примеров Welder. Любой файл можно загрузить обычным способом.
Публикации
Проверка, публикация, планирование, отслеживание, отмена, удаление и закрытие предупреждений.
validate_post
readПроверить публикацию для соцсетей. Аннотации: Только чтение, Идемпотентный
Проверка перед create_post: доступ к публикации, лимиты, аккаунты, медиа для каждой соцсети, длина подписей, количество изображений и известные ограничения. Ничего не публикует и не расходует.
| Параметр | Тип | Описание |
|---|---|---|
…то же, что create_post | то же, что create_post | Передайте именно то, что вы бы передали в create_post. |
Возвращает
{ ok, issues, targets: [{ account_id, provider, username, ok, issues, resolved }], cost: { posts, x_credits } }
- Результаты с кодом warning — рекомендации, например о том, что Instagram не показывает подписи в историях. Они не блокируют публикацию.
create_post
publishОпубликовать или запланировать публикацию в социальной сети. Аннотации: Изменяет данные, Необратимое действие, Внешние обращения (open-world), Идемпотентный
Публикует одну подпись и набор медиа в одном или нескольких аккаунтах — сразу или во время schedule_at. Сразу возвращает публикацию либо ждёт результат до wait_seconds.
| Параметр | Тип | Описание |
|---|---|---|
captionобязателенstring | string | Подпись, описание, текст публикации или ответа — в зависимости от соцсети. |
targetsобязателен[{ account_id } | { provider }] | [{ account_id } | { provider }] | Если указан provider, публикация направляется во все активные аккаунты этой соцсети. |
mediastring[] | string[] | ID медиафайлов. Оставьте список пустым для текстовой публикации в Facebook, Threads, Bluesky или X и для ответа на комментарий в YouTube или Facebook. |
titlestring | string | Название видео YouTube или фотопубликации TikTok. Если не задано, берётся из подписи. |
idempotency_keystring | string | Рекомендуется задавать один постоянный ключ для каждой публикации и использовать его при всех повторных попытках. Без ключа одинаковые запросы всё равно автоматически защищены от дублирования. |
schedule_atISO 8601 | ISO 8601 | Опубликовать позже, до 30 дней вперед. |
optionsobject | object | Параметры для каждой сети: tiktok, instagram, facebook, youtube, threads, bluesky, x (истории, Reels, черновики, ответы, цитаты, опросы, альтернативный текст и многое другое). См. раздел «Параметры для каждой сети» ниже. |
wait_seconds0–50 | 0–50 | Ожидает результата для всех аккаунтов или истечения заданного времени, затем возвращает текущее состояние. |
Возвращает
{ post: { id, status, source, client, caption, title, media, media_count, targets: [{ id, account_id, provider, username, status, attempt, url, platform_post_id, error_code, error_message, ambiguous, published_at, updated_at, kind }], scheduled_at, created_at, updated_at, completed_at } }
- Запрос с точной подписью, аккаунтами и временем уже разрешает публикацию. Повторное подтверждение не нужно. Уточняйте только недостающие или противоречивые детали: отсутствующую подпись, имя аккаунта, подходящее двум профилям, или два разных времени. Опубликованную запись не всегда можно удалить.
- Видимость публикаций TikTok и YouTube берётся из настроек рабочего пространства: по умолчанию они публичные, пока пользователь не изменит настройки. Метка ИИ-контента по умолчанию включена для TikTok и YouTube.
- options.instagram.kind = "story" публикует историю в Instagram, а options.facebook.kind = "reel" — Reels в Facebook. Параметр ответа (x.reply_to_post_id, bluesky.reply_to, youtube.reply_to_comment_id, facebook.reply_to_comment_id) отвечает на комментарий из list_comments; ответы в YouTube и Facebook бывают только текстовыми и требуют у аккаунта функции replies. Ответы в Threads пока недоступны в Welder.
- При неоднозначном результате соцсеть могла уже опубликовать запись. Проверьте аккаунт вместо повторной публикации с новым ключом.
create_post({
idempotency_key: "cold-brew-launch",
caption: "Cold brew season is open. Twelve hours, zero heat.",
media: ["3ed1…"],
targets: [{ provider: "tiktok" }, { provider: "youtube" }],
wait_seconds: 30
})get_post
readПолучить статус публикации в социальных сетях. Аннотации: Изменяет данные, Внешние обращения (open-world), Идемпотентный
Текущее состояние публикации в каждом целевом аккаунте. После подтверждения соцсети возвращается ссылка на опубликованную запись.
| Параметр | Тип | Описание |
|---|---|---|
post_idобязателенstring (uuid) | string (uuid) | Из create_post. |
wait_seconds0–50 | 0–50 | Дождаться результатов публикации и ожидаемой ссылки TikTok, затем вернуть ответ. По умолчанию 0. |
Возвращает
{ post: Post }
- needs_attention равен true, пока у неудачной или частично опубликованной записи есть незакрытое предупреждение. attention_dismissed_at содержит время его закрытия.
- Запись TikTok со статусом url_pending уже опубликована, но соцсеть ещё не предоставила публичную ссылку: возможно, идёт модерация. Повторите вызов позже. Для приватной публикации ссылка может не появиться; Welder не создаёт её самостоятельно.
- Если ссылка TikTok ожидается, get_post может запросить статус и сохранить полученную ссылку. Это единственное возможное изменение: инструмент не публикует, не повторяет публикации и не меняет расход, поэтому ему достаточно права read. Обращение к API означает open-world, а сохранение ссылки — что инструмент не является read-only. Демонстрационное рабочее пространство не обращается к TikTok.
list_posts
readСписок публикаций в социальных сетях. Аннотации: Только чтение, Идемпотентный
Последние и запланированные публикации, сначала самые новые.
| Параметр | Тип | Описание |
|---|---|---|
limit1–50 | 1–50 | По умолчанию 20. |
cursorstring | string | Из next_cursor с предыдущей страницы. |
status'queued' | 'publishing' | 'published' | 'partial' | 'failed' | 'canceled' | 'needs_attention' | 'queued' | 'publishing' | 'published' | 'partial' | 'failed' | 'canceled' | 'needs_attention' | Только публикации в указанном состоянии. needs_attention возвращает неудачные и частично опубликованные записи с незакрытым предупреждением. |
Возвращает
{ posts: Post[], next_cursor }
dismiss_post_attention
publishЗакрыть предупреждение о публикации. Аннотации: Изменяет данные, Идемпотентный
Закрывает предупреждение о неудачной или частично опубликованной записи. Результаты остаются в истории, а запись исчезает из списка needs_attention.
| Параметр | Тип | Описание |
|---|---|---|
post_idобязателенstring (uuid) | string (uuid) | Публикация, у которой нужно закрыть предупреждение. |
Возвращает
{ post: Post }
- Не повторяет публикацию, ничего не публикует, не удаляет и не отменяет. Не обращается к соцсетям. Исходные ошибки, медиа и расход остаются прежними.
- Безопасно вызывать повторно. Если незакрытого предупреждения нет, возвращает conflict. Явный повтор публикации снимает отметку о закрытии, поэтому новые ошибки будут видны.
dismiss_post_attention({ post_id: "8c1f…" })cancel_post
publishОтменить запланированную публикацию в соцсети. Аннотации: Изменяет данные, Необратимое действие, Идемпотентный
Останавливает публикации в очереди и по расписанию до отправки. Публикации, отправка которых уже началась, будут завершены.
| Параметр | Тип | Описание |
|---|---|---|
post_idобязателенstring (uuid) | string (uuid) | Публикация, которую нужно отменить. |
Возвращает
{ post: Post }
- Отмену нельзя отменить. Чтобы вернуть публикацию, запланируйте её снова.
delete_post
publishУдалить опубликованную запись. Аннотации: Изменяет данные, Необратимое действие, Внешние обращения (open-world), Идемпотентный
Удаляет опубликованную запись из X, Bluesky, YouTube и Facebook. Для TikTok, Instagram и Threads результат предлагает удалить её в приложении самой соцсети. Действие необратимо: точный запрос на удаление этой записи уже даёт разрешение. Если запись или аккаунт указаны неоднозначно, сначала уточните.
| Параметр | Тип | Описание |
|---|---|---|
post_idобязателенstring (uuid) | string (uuid) | Публикация, которую нужно удалить. |
account_idsstring[] | string[] | Только копии в указанных аккаунтах. По умолчанию все опубликованные копии. |
Возвращает
{ post: Post, results: [{ target_id, account_id, provider, result: 'deleted' | 'already_deleted' | 'unsupported' | 'not_published' | 'failed', message }] }
- Для копий в YouTube и Facebook у аккаунта должна быть функция delete (см. list_accounts); без неё результат — unsupported, а сообщение предлагает подключить аккаунт заново.
- Удалённая копия сохраняет статус deleted, её показатели больше не обновляются. Удаление не возвращает израсходованный лимит публикаций или кредиты X.
- В демонстрационном рабочем пространстве для проверки возвращает forbidden: его записи никогда не публиковались в соцсетях.
delete_post({ post_id: "8c1f…", account_ids: ["e7a9…"] })Результаты и справка
Статистика, ответы и поддерживаемые форматы каждой соцсети.
get_analytics
readПолучить статистику соцсетей. Аннотации: Только чтение, Идемпотентный
Сохранённые показатели публикаций: просмотры, лайки, комментарии, отправки и подписчики по соцсетям и аккаунтам, а также лучшие публикации. Если показателя нет, соцсеть его не передаёт; причина указана в пояснении.
| Параметр | Тип | Описание |
|---|---|---|
days1–365 | 1–365 | Публикации за последние N дней. Игнорируется, если задан since. |
since, untilISO 8601 | ISO 8601 | Пользовательский период по времени публикации. |
provider'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'threads' | 'bluesky' | 'x' | 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'threads' | 'bluesky' | 'x' | Только одна сеть. |
account_idstring (uuid) | string (uuid) | Только один аккаунт. |
sort'published_at' | 'views' | 'likes' | 'comments' | 'shares' | 'interactions' | 'engagement_rate' | 'published_at' | 'views' | 'likes' | 'comments' | 'shares' | 'interactions' | 'engagement_rate' | Порядок сортировки top_posts. По умолчанию published_at. |
limit1–50 | 1–50 | Количество лучших публикаций. По умолчанию 20. |
Возвращает
{ period: { since, until }, as_of, posts, measured, totals, interactions, engagement_rate, by_provider: [{ provider, posts, measured, totals, note }], accounts: [{ account_id, provider, username, status, note, metrics, change, captured_at, history }], top_posts: TargetAnalytics[] }
- Период определяет выборку по времени публикации. Каждый показатель — последнее общее значение для этой записи, а не прирост за период.
- Показатели: views, reach, likes, comments, shares, reposts, quotes, saves, link_clicks, profile_visits, follows, engagements, video_views, watch_time_s, avg_watch_time_s. Если соцсеть не передаёт показатель, он отсутствует в результате, а не равен 0.
- status для каждой публикации и аккаунта: available, pending, permission_required, unsupported, unavailable или error.
get_analytics({ days: 28, sort: "views", limit: 5 })get_post_analytics
publishПолучить или обновить аналитику публикаций. Аннотации: Изменяет данные, Внешние обращения (open-world)
Показатели одной публикации по соцсетям с объяснением недоступных данных. refresh запрашивает свежие данные; history показывает, как менялись показатели.
| Параметр | Тип | Описание |
|---|---|---|
post_idобязателенstring (uuid) | string (uuid) | Пост. |
refreshboolean | boolean | Получить свежие показатели сразу, не дожидаясь планового сбора: не чаще одного раза в 10 минут для каждой публикации. По умолчанию false. |
historyboolean | boolean | Добавить все сохранённые точки истории, начиная с самой ранней. По умолчанию false. |
Возвращает
{ post_id, caption, created_at, targets: [{ target_id, account_id, provider, username, url, status, note, metrics, extra, interactions, engagement_rate, captured_at, next_refresh_at, history? }], totals, as_of }
- Требует права publish: refresh: true обращается к соцсетям и сохраняет новые показатели. Такие внешние обращения означают open-world.
- Показатели собираются примерно через 1 и 6 часов, затем через 1, 3, 7, 30 и 90 дней после публикации. Для историй Instagram — через 1, 6 и 20 часов; для X — через 1 час, затем через 1, 7, 29 и 90 дней.
- При слишком частом обновлении возвращает rate_limited с details.retry_after_seconds. В демонстрационном рабочем пространстве refresh игнорируется и возвращаются фиксированные примеры показателей.
get_post_analytics({ post_id: "8c1f…", refresh: true, history: true })list_comments
publishЧитать комментарии к посту. Аннотации: Изменяет данные, Внешние обращения (open-world)
Ответы под опубликованной записью по соцсетям. Чтобы ответить, вызовите create_post с этим аккаунтом в качестве цели и ID комментария в параметре, указанном в reply_option.
| Параметр | Тип | Описание |
|---|---|---|
post_idобязателенstring (uuid) | string (uuid) | Пост. |
account_idstring (uuid) | string (uuid) | Только копия этого аккаунта. По умолчанию каждая опубликованная копия. |
limit1–50 | 1–50 | По умолчанию 20. |
Возвращает
{ post_id, targets: [{ target_id, account_id, provider, username, status, note, reply_option, comments: [{ id, author: { username, display_name, avatar_url }, text, created_at, likes, replies, url, parent_id, is_own, hidden }] }] }
- Требует права publish: каждое чтение ответов в X расходует 1 кредит X; обращение к соцсети также может обновить сессию аккаунта. Чтение комментариев через API означает open-world.
- Чтение доступно в Bluesky, YouTube, на страницах Facebook и в X при наличии доступа к X в аккаунте (за последние 7 дней). Instagram возвращает permission_required, TikTok и Threads — unsupported.
- reply_option содержит x.reply_to_post_id, bluesky.reply_to, youtube.reply_to_comment_id или facebook.reply_to_comment_id; null — если Welder не может отвечать от имени этого аккаунта. Отправляйте ответ, когда пользователь явно просит об этом и указывает текст. Если он просит черновик, напишите его в чате и ничего не отправляйте.
list_comments({ post_id: "8c1f…", account_id: "b2d4…" })
create_post({
caption: "Not yet, but it’s on the list!",
targets: [{ account_id: "b2d4…" }],
options: { x: { reply_to_post_id: "1849…" } }
})get_capabilities
readПолучить возможности соцсетей. Аннотации: Только чтение, Идемпотентный
Поддерживаемые типы медиа, размеры, длительность, количество изображений и длина подписей для каждой соцсети. Статические данные, одинаковые для всех рабочих пространств.
Параметры не требуются.
Возвращает
{ providers: { tiktok: { text_only, video: { max_bytes, min_duration_s, max_duration_s, mimes }, images: { max_bytes, min_count, max_count, mimes }, mixed_carousel, caption_max, title_max, story?, notes }, … } }
Параметры соцсетей#
Передавайте их в options.<network> в create_post и validate_post. Неподдерживаемые сочетания (опрос с файлами, подпись к Story) возвращаются инструментом validate_post как ошибки проверки; рекомендации возвращаются с кодом warning и не блокируют публикацию.
TikTokoptions.tiktok
| Параметр | Назначение |
|---|---|
privacypublic · friends · followers · private | Кто сможет увидеть публикацию. По умолчанию используются настройки вашего рабочего пространства. |
ai_generatedtrue · false | Добавляет метку TikTok «Создано с помощью ИИ». По умолчанию — как в настройках (выключено, пока вы не включите). |
disable_comment, disable_duet, disable_stitchtrue · false | Отключает взаимодействия для этой публикации. |
brand_content, brand_organictrue · false | Отмечает платное партнёрство или продвижение собственного бренда. |
modedirect · draft | draft отправляет видео или фото во входящие TikTok, чтобы автор завершил публикацию в приложении. По умолчанию direct. |
cover_index0–34 | Только фотопубликации: какое изображение является обложкой. |
cover_timestamp_msмиллисекунды | Только для видео: кадр, который TikTok использует как обложку. |
auto_add_musictrue · false | Только для фото: разрешает TikTok добавить рекомендованную музыку. По умолчанию true. |
Instagramoptions.instagram
| Параметр | Назначение |
|---|---|
kindreel · image · carousel · story | Задаёт тип публикации вместо определённого автоматически. Истории никогда не выбираются автоматически; Meta разрешает публиковать их из аккаунтов Business. |
share_to_feedtrue · false | Только для Reels: также показывать публикацию в ленте. По умолчанию true. |
cover_media_idID медиафайла | Только для Reels: загруженное изображение для обложки, отдельно от media. |
thumb_offset_msмиллисекунды | Только для Reels: кадр для обложки, если отдельное изображение не задано. |
collaboratorsДо 3 имён пользователей | Приглашает соавторов публикации в ленте или Reels. Для историй недоступно. |
user_tags[{ username, x?, y?, media_index? }], до 20 | Отмечает людей. x и y (от 0 до 1) задают положение отметки на изображении; для Reels и историй передаются только имена пользователей. |
location_idидентификатор местоположения | Добавляет место к публикации в ленте или Reels. |
alt_textsдо 10 строк | Альтернативный текст для каждого изображения в порядке media (фото в ленте). |
audio_nameДо 100 символов | Только для Reels: название оригинальной аудиодорожки. |
trial{ graduation: manual · performance } | Только для Reels: пробная публикация сначала показывается тем, кто не подписан на вас. graduation определяет, когда её увидят подписчики. |
Facebookoptions.facebook
| Параметр | Назначение |
|---|---|
kindpost · reel | post (по умолчанию) публикует в ленту страницы; reel публикует одно вертикальное видео длиной от 3 до 90 секунд как Reel. |
linkURL | Только для текстовых постов: ссылка, которая показывается карточкой с превью. |
alt_textsдо 10 строк | Альтернативный текст для каждого изображения, в порядке медиафайлов. |
reply_to_comment_idcomment id | Ответить на комментарий под постом вашей страницы от имени страницы вместо новой публикации. Только текст; id комментариев возвращает list_comments. |
YouTubeoptions.youtube
| Параметр | Назначение |
|---|---|
visibilitypublic · unlisted · private | Кто может смотреть видео. По умолчанию используются настройки рабочего пространства. |
titleДо 100 символов | Если название не задано, оно берётся из подписи. |
tagsсписок строк | Поисковые теги видео. |
made_for_kidstrue · false | Обязательная отметка для контента, предназначенного детям. |
ai_generatedtrue · false | Отметка о синтетическом контенте. По умолчанию — как в настройках (выключено, пока вы не включите). |
thumbnail_media_idID медиафайла | Загруженное изображение JPEG или PNG размером до 2 МБ для обложки, отдельно от media. |
category_idИдентификатор категории YouTube | Категория видео, например 22 — People & Blogs. |
publish_atвремя в формате ISO 8601 | В указанное время YouTube сделает видео общедоступным. До этого оно будет доступно только вам. |
notify_subscriberstrue · false | Уведомлять подписчиков о новом видео. По умолчанию true. |
licenseyoutube · creative_commons | Лицензия на видео. |
embeddabletrue · false | Разрешить другим сайтам вставлять видео. |
public_stats_viewabletrue · false | Показывать количество просмотров на странице просмотра. |
default_languageКод языка, например en | Язык названия и описания. |
default_audio_languageкод языка | Язык, на котором говорят в видео. |
recording_dateвремя в формате ISO 8601 | Когда было записано видео. |
reply_to_comment_idcomment id | Ответить на комментарий под вашим видео вместо загрузки. Только текст; id комментариев возвращает list_comments. |
Threadsoptions.threads
| Параметр | Назначение |
|---|---|
reply_linkURL | Публикуется первым ответом под вашей записью. |
reply_controleveryone · accounts_you_follow · mentioned_only · parent_post_author_only · followers_only | Кто может отвечать. По умолчанию everyone. |
topic_tagодин тег, без # | Тег темы публикации, без точек и символа &. |
reply_to_idID публикации в Threads | Ответ на эту запись: продолжение цепочки или ответ другому человеку. Пока недоступно в Welder. |
quote_post_idID публикации в Threads | Цитирует эту публикацию. |
link_attachmentURL | Только для текстовых публикаций: карточка ссылки. |
poll{ options: от 2 до 4, до 25 символов каждый } | Только для текстовых публикаций: опрос. |
spoilertrue · false | Скрывает фото и видео размытием, пока на них не нажмут. |
alt_textsдо 20 строк | Альтернативный текст для каждого изображения или видео в порядке media. |
reply_approvalstrue · false | Показывает ответы только после вашего одобрения. |
Blueskyoptions.bluesky
| Параметр | Назначение |
|---|---|
alt_textsдо 4 строк | Альтернативный текст для каждого изображения, по порядку. |
langsДо 3 кодов языка, например en | Языки текста. По умолчанию en. |
labelssexual · nudity · porn · graphic-media | Предупреждения о содержании, которые показываются перед фото или видео. |
reply_controlnobody или любое из значений mentioned · following · followers | Кто может отвечать. По умолчанию everyone. |
disable_quotestrue · false | Не позволяйте другим людям цитировать публикацию. |
reply_toURI at:// или ссылка bsky.app | Ответ на эту публикацию: продолжение цепочки или ответ другому человеку. |
quoteURI at:// или ссылка bsky.app | Цитирование этой публикации с собственными фото или видео либо без них. |
Xoptions.x
| Параметр | Назначение |
|---|---|
alt_textsдо 4 строк | Альтернативный текст для каждого изображения, по порядку. |
reply_settingsfollowing · mentionedUsers · subscribers · verified | Кто может отвечать. По умолчанию everyone. |
reply_to_post_idID публикации в X | Ответ на эту публикацию: продолжение цепочки или ответ другому человеку. |
quote_post_idID публикации в X | Цитирует эту публикацию. |
poll{ options: от 2 до 4, duration_minutes: от 5 до 10080 } | Только для текстовых публикаций: опрос длительностью от 5 минут до 7 дней. |
made_with_aitrue · false | Отметка для контента, созданного с помощью ИИ. |
paid_partnershiptrue · false | Отмечает платное партнёрство. |
community_idИдентификатор сообщества X | Публикует в сообществе X, в котором состоит аккаунт. |
Статистика и ответы#
get_analytics и get_post_analytics возвращают показатели, которые Welder собирает по расписанию после публикации; list_comments читает ответы. Доступность данных зависит от разрешений, выданных Welder каждой соцсетью:
- TikTok: Пока недоступна. TikTok ещё не разрешил Welder получать статистику, поэтому просмотры, лайки и число подписчиков пока можно посмотреть только в приложении TikTok.
- Instagram: Просмотры, охват, лайки, комментарии, репосты, сохранения и время просмотра Reels по каждой публикации, просмотры Stories в течение 24 часов и число подписчиков. Аккаунты, подключённые до 30 октября 2026 года, покажут просмотры после одного переподключения. Чтение комментариев станет доступно после одобрения Meta.
- Facebook: Просмотры, охват, реакции, комментарии, репосты и переходы по ссылкам по каждой публикации, просмотры видео там, где Facebook их отдаёт, и подписчики страницы. Комментарии можно читать и отвечать на них от имени страницы.
- YouTube: Просмотры, лайки, комментарии, репосты, время просмотра, средняя длительность просмотра и новые подписчики по каждому видео, расчётный доход для монетизированных каналов и число подписчиков канала. Каналы, подключённые до 30 октября 2026 года, показывают общедоступные данные до одного переподключения.
- Threads: Просмотры, лайки, ответы, репосты, цитаты и пересылки по каждой публикации и число подписчиков. Чтение ответов и ответы на них пока недоступны в Welder.
- Bluesky: Лайки, репосты, ответы, цитирования и закладки публикаций, число подписчиков. Bluesky не считает просмотры.
- X: Просмотры, лайки, ответы, репосты, цитирования и закладки публикаций, число подписчиков. В первые 30 дней после публикации также доступны переходы по ссылкам и посещения профиля.
Если соцсеть не передаёт показатель, он отсутствует в результате, а не равен 0. Каждая публикация или аккаунт содержит status (available, pending, permission_required, unsupported, unavailable, error) с понятным пояснением note. Welder удаляет публикации в X, Bluesky, YouTube и Facebook (delete_post); в TikTok, Instagram и Threads результат предлагает удалить запись в приложении самой соцсети.
Файлы из чата#
Помощник без терминала вызывает create_upload_link, показывает ссылку и ждёт, пока пользователь загрузит файлы на странице Welder. Затем вызывает get_upload_link с wait_seconds и передаёт ID медиафайлов в create_post. Ассистент с доступом к командной строке использует create_upload, один PUT и finalize_upload. list_media находит файлы, загруженные пользователем в приложении.
Ошибки#
Ошибки выполнения возвращаются в результате инструмента с isError: true, а не как ошибки протокола: модель может прочитать их и выбрать следующее действие. Сообщения не содержат URL, данные для доступа или email.
{ "error": { "code": "quota_exceeded", "message": "Monthly post quota exceeded.", "retryable": false } }| Код | Значение | Повторить попытку? |
|---|---|---|
unauthorized | Учетные данные отсутствуют, просрочены или отозваны.Повтор: Нет: войдите снова или используйте действительный ключ. | Нет: войдите снова или используйте действительный ключ. |
forbidden | У данных для доступа нет нужного права или действие не разрешено для этого рабочего пространства. Например, нельзя менять аккаунты в демонстрационном рабочем пространстве.Повтор: Нет | Нет |
validation | Введенные данные не соответствуют схеме инструмента.Повтор: Нет: исправьте входные данные. | Нет: исправьте входные данные. |
not_found | В рабочем пространстве нет такой публикации, медиафайла, ссылки для загрузки или аккаунта.Повтор: Нет | Нет |
quota_exceeded | Достигнут лимит публикаций за месяц, кредитов X, подключённых профилей, незавершённых загрузок или хранилища медиа. Сообщение уточняет, какой именно.Повтор: Нет | Нет |
plan_required | Публикация, в том числе в X, недоступна при текущих условиях доступа аккаунта. Настройка, загрузка файлов и проверка публикаций по-прежнему доступны.Повтор: Нет | Нет |
account_not_connected | Нет активной учетной записи для запрошенной сети.Повтор: Нет: вызовите connect_account. | Нет: вызовите connect_account. |
account_reauth_required | Соцсеть просит пользователя войти снова.Повтор: Нет: вызовите connect_account для получения новой ссылки. | Нет: вызовите connect_account для получения новой ссылки. |
media_not_ready | Файл ещё не загружен или проходит проверку.Повтор: Да, скоро. | Да, скоро. |
media_too_large | Размер файла превышает ограничение.Повтор: Нет | Нет |
unsupported | Соцсеть не поддерживает этот медиафайл или сочетание файлов.Повтор: Нет | Нет |
provider_error | Соцсеть отклонила запрос. Причина указана в details.provider_code.Повтор: Зависит от причины. | Зависит от причины. |
rate_limited | Слишком много вызовов. details.retry_after_seconds указывает, когда можно повторить попытку.Повтор: Да, после ожидания. | Да, после ожидания. |
conflict | Запрос не соответствует текущему состоянию: например, отмена завершённой публикации или закрытие отсутствующего предупреждения.Повтор: Нет | Нет |
closed | Срок действия ссылки для загрузки истёк или загрузка по ней уже завершена.Повтор: Нет: создайте новую ссылку. | Нет: создайте новую ссылку. |
internal | Ошибка на стороне Welder.Повтор: Да | Да |
Ограничения частоты запросов#
- На рабочее пространство: 60 вызовов инструмента в минуту и 600 в час.
- create_post, create_upload и create_upload_link: по 30 вызовов в минуту на каждый инструмент. Обновление показателей: 10 в минуту.
- OAuth-эндпоинты без входа и публичные маршруты загрузки по ссылке: от 30 до 60 запросов в минуту на IP.
- При превышении лимита возвращается
rate_limitedсdetails.retry_after_seconds, а вне вызовов инструментов — HTTP 429 с заголовком Retry-After.
Запросы и ресурсы#
- Запрос
post_thisпроводит агента через загрузку, проверку и публикацию файла в выбранных соцсетях. - Ресурс
welder://capabilities— те же данные, что и get_capabilities;welder://docs/quickstart— краткая инструкция в Markdown: агенты могут читать её без браузера.
Демонстрационное рабочее пространство для проверки#
Проверяющие каталога плагинов получают отдельное рабочее пространство Welder с пометкой Демо-режим для проверки на каждой странице приложения. Инструменты и проверки те же, но соцсети моделируются: запросов в реальные соцсети нет. Ссылки на публикации из этого пространства ведут сюда.
Демонстрационные данные
- Шесть тестовых аккаунтов — в TikTok, Instagram, YouTube, Threads, Bluesky и X. Их имена начинаются с demo_coffee_…, а подпись — «Demo Coffee · Simulated». Они не подключены к реальным соцсетям.
- Фото кофе и три тестовых поста в Instagram и Bluesky за 29 сентября — 1 октября 2026 года. Статистика задана для примера, а не получена из соцсетей.
- Один вымышленный комментарий к посту в Bluesky от 1 октября. Ответы можно подготовить в чате — они не отправляются.
Работает как обычно
- Загрузка по ссылкам и в приложении, проверка файлов, лимиты, защита от повторных публикаций, планирование, отмена и история постов.
- При публикации создаётся запись и тестовое подтверждение для каждого аккаунта. Пост получает статус «Опубликовано», а ссылка открывает эту страницу вместо соцсети. Для новых постов статистика и комментарии не выдумываются.
- Подключение ИИ-приложения: вход, ключи и отзыв доступа работают как обычно.
Отключено
- Подключение, обновление доступа и отключение аккаунтов соцсетей.
- Оплата, смена тарифа и платёжные настройки.
- Изменение настроек и удаление рабочей области.
- Удаление постов (delete_post) и обновление статистики из соцсетей.
- Импорт любых файлов, кроме публичных примеров Welder.
get_context возвращает review_demo: true и строку data_source для этого пространства. Приложение получает тот же флаг. Комментарии отмечены как вымышленные примеры. Другие пространства публикуют в реальные соцсети и не получают смоделированные результаты.