Постинг в X из n8n

Что n8n умеет с calmposts

n8n запускает сценарии по расписанию, по вебхуку, по новой записи в RSS-ленте или новой строке в таблице. С calmposts за ИИ-агентом n8n сценарий превращает каждую новую запись в пост для X (Twitter) или тред и ставит его в очередь calmposts, где он ждёт вашего одобрения.

Есть два пути. MCP Client Tool даёт ИИ-агенту инструменты calmposts, и модель сама их выбирает; узел MCP Client вызывает один инструмент обычным шагом, с аргументами из предыдущих узлов и без модели. Оба берут ключ из учётных данных n8n: его сохраняют один раз, и им пользуются все сценарии.

MCP-сервер для X (Twitter) даёт n8n 11 инструментов — тех же, что и любому другому клиенту:

Настройка calmposts в n8n

Сначала проверьте ключ

Создайте ключ в calmposts в разделе «API и MCP» (он показывается один раз) и запросите у сервера список инструментов. Список из 11 инструментов значит, что адрес и ключ верны; 401 — ключ неверный или отправлен без «Bearer ».

curl -s https://calmposts.com/mcp \
  -H "Authorization: Bearer cp_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 200 {"jsonrpc":"2.0","id":1,"result":{"tools":[…]}}

Способ 1: ИИ-агент с MCP Client Tool

Агент читает запись, пишет пост и выбирает инструмент.

1. Создайте ключ в calmposts в разделе «API и MCP». В n8n создайте учётные данные Bearer Auth и вставьте ключ в поле Bearer Token без «Bearer » — n8n добавит его сам.

2. В сценарии откройте инструменты узла AI Agent и добавьте MCP Client Tool.

3. Заполните поля:

   Endpoint:          https://calmposts.com/mcp
   Server Transport:  HTTP Streamable
   Authentication:    Bearer Auth
   Bearer Token:      cp_live_…
   Tools to Include:  All

4. В промпте агента скажите, что делать, например «Напиши один пост для X про эту статью и сохрани его в calmposts с when=queue», запустите сценарий один раз и посмотрите вывод узла.

Способ 2: Обычный шаг с узлом MCP Client

Без модели: каждый запуск вызывает create_post с полями, которые вы сопоставили.

1. Добавьте узел MCP Client после триггера и заполните поля:

   MCP Endpoint URL:  https://calmposts.com/mcp
   Server Transport:  HTTP Streamable
   Authentication:    Bearer Auth
   Tool:              create_post
   Input Mode:        JSON

2. Передайте аргументы в JSON, подставив поля предыдущих узлов. ACCOUNT_ID берётся из list_accounts: один раз вызовите этот инструмент в отдельном узле MCP Client и посмотрите id.

   {
     "text": "{{ $json.title }} {{ $json.link }}",
     "account_ids": ["ACCOUNT_ID"],
     "when": "queue"
   }

Вход: ключ или OAuth

Учётные данные Bearer Auth отправляют Authorization: Bearer с вашим ключом в каждом запросе — ровно то, что ждёт calmposts. Ключ не истекает, поэтому подходит для сценариев, которые работают по ночам.

Если выберете Header Auth, укажите имя Authorization и значение Bearer cp_live_… — с пробелом.

В n8n есть и учётные данные MCP OAuth2, которые регистрируются сами (Dynamic Client Registration включён по умолчанию). calmposts принимает их адрес возврата, если ваш n8n открыт по https или с localhost; для сценария, который работает без присмотра, ключ проще.

Заведите для n8n отдельный ключ только с нужными правами (accounts:read, posts:read, posts:write), чтобы отозвать его, не трогая других агентов.

Как проверить, что всё работает

• В узле MCP Client список Tool заполняется 11 инструментами calmposts: адрес и ключ работают.
• Запустите ИИ-агента на тестовой записи: в его журнале видны вызовы list_accounts и create_post.
• Новый пост появился в разделе «Посты» calmposts — черновиком или в очереди, с источником mcp.

Что попросить

Просите своими словами — агент сам выберет инструменты. Хорошо работают такие просьбы:

• «Для каждой новой записи RSS напиши один пост для X короче 280 символов со ссылкой и сохрани его в calmposts с when=queue для моего аккаунта X».
• «Сделай из этой заметки к релизу короткий тред для X и Bluesky и сохрани черновиком».
• «Сначала вызови get_limits; если на сегодня осталось меньше 3 постов, сохрани пост черновиком, а не в очередь».
• «Никогда не используй when=now. Если calmposts ответит duplicate_recent, перепиши пост один раз и попробуй снова».

Соцсети, треды и одобрение

Посты уходят в X и Bluesky. В X и Bluesky тред выходит цепочкой ответов. Скоро: Threads и LinkedIn.

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

По умолчанию посты агента ждут вас: они возвращаются со статусом pending_approval, и вы одобряете или отклоняете каждый в приложении, в Telegram или из письма calmposts. Владелец рабочего пространства может разрешить агентам публиковать самим; для этого и пространство, и API-ключ должны быть переключены на публикацию. X ждёт, что у аккаунта, который постит автоматически, стоит метка Automated (Settings → Your account → Account information → Automation).

Какие соцсети уже работают→

Лимиты и стоимость

• Агентам нужен платный тариф: на Free нет API-ключей и нельзя одобрить подключение приложения. API-ключей по тарифам: Pro 3 · Advanced 10 · Agency 25.
• Посты агента считаются так же, как ваши. Постов в день: Pro 20 · Advanced 100 · Agency 300. Постов со ссылкой в месяц: Pro 30 · Advanced 300 · Agency 600. Каждый пост треда считается отдельно.
• Ссылки считаются отдельно, потому что X берёт с каждого приложения $0,015 за пост и $0,20 за пост со ссылкой. Плата X входит в тариф: свой аккаунт разработчика X и свой счёт за X API не нужны.
• Попробовать: 7 дней бесплатно. Нужна карта. 5 постов со ссылкой за пробный период.
• Каждый ключ может сделать 60 запросов в минуту, MCP и REST вместе; дальше сервер отвечает 429 с Retry-After.

Тарифы→

Что важно знать про n8n

• На странице документации n8n про MCP Client Tool поле по-прежнему называется SSE Endpoint — это первая версия узла. В нынешних версиях есть Endpoint и выбор Server Transport: выберите HTTP Streamable. SSE-адреса у calmposts нет.
• Сценарий по RSS ставит ссылку в каждый пост, а у постов со ссылкой в каждом тарифе свой месячный лимит, потому что X берёт за них больше. Проверьте этот лимит, прежде чем включать сценарий.
• Опция Timeout у узлов по умолчанию 60 секунд — намного больше, чем нужно calmposts; дольше всего идёт create_post с картинками, пока calmposts их скачивает.
• Сценарий, который постит для нескольких клиентов, может передавать customer_id в list_accounts и list_posts, чтобы не выходить за каналы одного клиента.

Без MCP: REST API

Всё, что делают инструменты, доступно и обычными REST-запросами к /api/v1 с тем же ключом. Это удобно для скрипта или шага, который умеет только HTTP. calmposts публикует через своё одобренное приложение X, поэтому ключи X API для запроса не нужны.

export CALMPOSTS_API_KEY=cp_live_…
curl -H "Authorization: Bearer $CALMPOSTS_API_KEY" https://calmposts.com/api/v1/accounts
curl -X POST https://calmposts.com/api/v1/posts \
  -H "Authorization: Bearer $CALMPOSTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parts":[{"text":"Calm posts, scheduled."}],"targets":[{"account_id":"ACCOUNT_ID"}],"schedule":{"mode":"queue"}}'

Документация REST API→

Документация n8n, по которой написана страница

• n8n docs: MCP Client Tool node
• n8n docs: MCP Client node
• n8n docs: MCP credentials
• n8n docs: HTTP Request credentials (bearer auth)
• n8n source: the MCP Client Tool node

calmposts — независимый сервис, он не связан с создателями n8n и не одобрен ими. Названия продуктов принадлежат их владельцам.