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

Сервер Welder MCP

Welder — удалённый MCP-сервер по адресу https://weldergtm.com/mcp. Сначала вызовите get_context. Для публикации используйте create_post, а файлы передавайте через create_upload (из терминала) или create_upload_link (из чата). Эта страница предназначена для разработчиков; в остальных разделах технические термины не нужны.

Адрес сервераhttps://weldergtm.com/mcp

Адрес сервера#

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/mcp

Codex CLIИнструкция

codex mcp add welder --url https://weldergtm.com/mcp

CursorИнструкция

.cursor/mcp.json
{
  "mcpServers": {
    "welder": { "url": "https://weldergtm.com/mcp" }
  }
}

WindsurfИнструкция

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "welder": { "serverUrl": "https://weldergtm.com/mcp" }
  }
}

Gemini CLIИнструкция

gemini mcp add --transport http welder https://weldergtm.com/mcp

VS 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Инструкция

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "welder": { "serverUrl": "https://weldergtm.com/mcp" }
  }
}

KiroИнструкция

~/.kiro/settings/mcp.json
{
  "mcpServers": {
    "welder": {
      "url": "https://weldergtm.com/mcp"
    }
  }
}

Kimi CodeИнструкция

~/.kimi-code/mcp.json
{
  "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 через браузер, используя вход из вашего приложения.

Публичный пакетgithub.com/Endless-River-Labs/welder-pluginsMIT

Claude Code. Добавьте каталог плагинов и установите плагин. Вводите команды по одной в Claude Code. Затем выполните /mcp, выберите сервер Welder и нажмите Authenticate. Откроется браузер для входа.

В Claude Code
/plugin marketplace add Endless-River-Labs/welder-plugins
/plugin install welder-social-manager@welder-plugins

Codex. 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 welder

ChatGPT. Установите официальный плагин из каталога плагинов ChatGPT в одно нажатие и войдите в аккаунт: Welder: Social Autoposting. Инструкции для ChatGPT показывают каждый экран настройки.

Приложение Claude. Добавьте https://weldergtm.com/mcp как пользовательский коннектор в настройках и войдите в аккаунт. Инструкции для Claude показывают каждый экран настройки.

Каталоги плагинов. Welder есть в каталоге плагинов ChatGPT. Каталог Claude проверяет и одобряет плагин перед размещением; пока этого не произошло, установите плагин из публичного репозитория или подключите Welder напрямую.

Инструменты#

Рабочее пространство и аккаунты

Кто подключен, что можно публиковать и как подключить другую сеть.

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'Сеть для подключения.

Возвращает

{ provider, url, expires_in }

  • Пользователь входит на странице самой соцсети; помощник не получает пароль. Для Bluesky ссылка открывает форму ввода пароля приложения. В Facebook пользователь выбирает страницы на экране Facebook: каждая страница, где он может публиковать, становится отдельным аккаунтом в пределах лимита аккаунтов тарифа.
  • Повторное подключение того же аккаунта обновляет его: ID аккаунта, запланированные публикации и история сохраняются, а функции, которые соцсеть одобрила с тех пор, включаются.
  • В демонстрационном рабочем пространстве для проверки возвращает forbidden: тестовые аккаунты в нём добавлены Welder.

Файлы

Передача фото или видео в Welder: ссылка для загрузки из чата, подписанная загрузка из терминала или публичный URL.

list_media

read

Список загруженных медиафайлов. Аннотации: Только чтение, Идемпотентный

Последние загрузки, сначала самые новые, для таких запросов, как «опубликовать мою последнюю загрузку». Файлы с истекшим сроком хранения не учитываются.

ПараметрОписание
limit1–50По умолчанию 10.
status'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Исходное имя файла, например launch.mp4.
mimeобязателен'image/jpeg' | 'image/png' | 'image/webp' | 'video/mp4' | 'video/quicktime'Тип файла.
bytesобязателен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)Из create_upload.

Возвращает

{ media: Media }

  • Если файл ещё не загружен, возвращает media_not_ready. Можно безопасно повторить вызов чуть позже.

import_media

publish

Импортировать медиафайлы с общедоступного URL-адреса. Аннотации: Изменяет данные, Внешние обращения (open-world)

Загружает публичный файл по HTTPS в хранилище Welder вместо загрузки с диска.

ПараметрОписание
urlобязателенstring (https)URL-адрес общедоступного файла. Частные сети и более трех редиректов отклонены.
filenamestringНеобязательное имя файла.

Возвращает

{ media: Media }

  • В демонстрационном рабочем пространстве для проверки разрешён импорт только публичных примеров Welder. Любой файл можно загрузить обычным способом.

Публикации

Проверка, публикация, планирование, отслеживание, отмена, удаление и закрытие предупреждений.

validate_post

read

Проверить публикацию для соцсетей. Аннотации: Только чтение, Идемпотентный

Проверка перед 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Подпись, описание, текст публикации или ответа — в зависимости от соцсети.
targetsобязателен[{ account_id } | { provider }]Если указан provider, публикация направляется во все активные аккаунты этой соцсети.
mediastring[]ID медиафайлов. Оставьте список пустым для текстовой публикации в Facebook, Threads, Bluesky или X и для ответа на комментарий в YouTube или Facebook.
titlestringНазвание видео YouTube или фотопубликации TikTok. Если не задано, берётся из подписи.
idempotency_keystringРекомендуется задавать один постоянный ключ для каждой публикации и использовать его при всех повторных попытках. Без ключа одинаковые запросы всё равно автоматически защищены от дублирования.
schedule_atISO 8601Опубликовать позже, до 30 дней вперед.
optionsobjectПараметры для каждой сети: tiktok, instagram, facebook, youtube, threads, bluesky, x (истории, Reels, черновики, ответы, цитаты, опросы, альтернативный текст и многое другое). См. раздел «Параметры для каждой сети» ниже.
wait_seconds0–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)Из create_post.
wait_seconds0–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По умолчанию 20.
cursorstringИз next_cursor с предыдущей страницы.
status'queued' | 'publishing' | 'published' | 'partial' | 'failed' | 'canceled' | 'needs_attention'Только публикации в указанном состоянии. needs_attention возвращает неудачные и частично опубликованные записи с незакрытым предупреждением.

Возвращает

{ posts: Post[], next_cursor }

dismiss_post_attention

publish

Закрыть предупреждение о публикации. Аннотации: Изменяет данные, Идемпотентный

Закрывает предупреждение о неудачной или частично опубликованной записи. Результаты остаются в истории, а запись исчезает из списка needs_attention.

ПараметрОписание
post_idобязателенstring (uuid)Публикация, у которой нужно закрыть предупреждение.

Возвращает

{ post: Post }

  • Не повторяет публикацию, ничего не публикует, не удаляет и не отменяет. Не обращается к соцсетям. Исходные ошибки, медиа и расход остаются прежними.
  • Безопасно вызывать повторно. Если незакрытого предупреждения нет, возвращает conflict. Явный повтор публикации снимает отметку о закрытии, поэтому новые ошибки будут видны.
Вызов
dismiss_post_attention({ post_id: "8c1f…" })

cancel_post

publish

Отменить запланированную публикацию в соцсети. Аннотации: Изменяет данные, Необратимое действие, Идемпотентный

Останавливает публикации в очереди и по расписанию до отправки. Публикации, отправка которых уже началась, будут завершены.

ПараметрОписание
post_idобязателенstring (uuid)Публикация, которую нужно отменить.

Возвращает

{ post: Post }

  • Отмену нельзя отменить. Чтобы вернуть публикацию, запланируйте её снова.

delete_post

publish

Удалить опубликованную запись. Аннотации: Изменяет данные, Необратимое действие, Внешние обращения (open-world), Идемпотентный

Удаляет опубликованную запись из X, Bluesky, YouTube и Facebook. Для TikTok, Instagram и Threads результат предлагает удалить её в приложении самой соцсети. Действие необратимо: точный запрос на удаление этой записи уже даёт разрешение. Если запись или аккаунт указаны неоднозначно, сначала уточните.

ПараметрОписание
post_idобязателенstring (uuid)Публикация, которую нужно удалить.
account_idsstring[]Только копии в указанных аккаунтах. По умолчанию все опубликованные копии.

Возвращает

{ 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Публикации за последние N дней. Игнорируется, если задан since.
since, untilISO 8601Пользовательский период по времени публикации.
provider'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'threads' | 'bluesky' | 'x'Только одна сеть.
account_idstring (uuid)Только один аккаунт.
sort'published_at' | 'views' | 'likes' | 'comments' | 'shares' | 'interactions' | 'engagement_rate'Порядок сортировки top_posts. По умолчанию published_at.
limit1–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)Пост.
refreshbooleanПолучить свежие показатели сразу, не дожидаясь планового сбора: не чаще одного раза в 10 минут для каждой публикации. По умолчанию false.
historybooleanДобавить все сохранённые точки истории, начиная с самой ранней. По умолчанию 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)Пост.
account_idstring (uuid)Только копия этого аккаунта. По умолчанию каждая опубликованная копия.
limit1–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 · draftdraft отправляет видео или фото во входящие 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 · reelpost (по умолчанию) публикует в ленту страницы; 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.
account_reauth_requiredСоцсеть просит пользователя войти снова.Повтор: Нет: вызовите 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 для этого пространства. Приложение получает тот же флаг. Комментарии отмечены как вымышленные примеры. Другие пространства публикуют в реальные соцсети и не получают смоделированные результаты.