🤖 Пилорама в вашем ИИ-агенте

Пилорама — сервис записи подкастов. Через API ваш ИИ-агент может создавать комнаты записи, сводить и мастерить дорожки, делать транскрипцию с заметками выпуска, публиковать эпизоды в Telegram-канал и в собственный RSS — от вашего имени.

Зачем это — что поручить агенту

Смысл в том, чтобы не ходить в веб-кабинет руками: агент в вашем чате (Claude, Cursor, свой бот) делает рутину публикации и дистрибуции по одной фразе.

Автопубликация после записи. «Опубликуй мою последнюю запись и запости в Telegram-канал» — агент находит свежую запись с мастером и транскрипцией, публикует эпизод и отправляет его в канал с обложкой и таймкодами.
Спасти истекающие записи. «Какие мои записи истекают на этой неделе? Опубликуй их» — записи живут 7 дней, агент публикует нужные, пока не удалились.
Пакетная выгрузка. «Опубликуй все записи, которых ещё нет в канале» — агент сверяет список эпизодов и постит недостающие.
Анонс с генерацией текста. Агент берёт заголовок и главы эпизода, пишет пост-анонс для соцсетей своими силами, а Пилораму использует, чтобы достать аудио и опубликовать.
Настройка подкаста фразой. «Назови подкаст …, автор …, слаг …» — агент задаёт метаданные и отдаёт готовый URL RSS-фида для Яндекс Музыки / Apple / mave.
Проверка перед постингом. «Подключён ли мой Telegram-бот?» — агент смотрит статус интеграции и не публикует вслепую.
Встроить в свой продукт. Подключаете MCP к своему агенту/пайплайну — «записал → по расписанию само публикуется и расходится по каналам».

Запись подкаста (сведение, мастеринг) пока делается в вебе; агент через API берёт на себя публикацию и дистрибуцию — самую рутинную часть.

1. Получите ключ

Войдите через Яндекс ID → Личный кабинет → API-ключи → «Создать ключ». Ключ вида pil_… показывается один раз — сохраните его.

2. Подключение по MCP (для Claude, Cursor и др.)

MCP-сервер Пилорамы даёт агенту инструменты записи и публикации напрямую. Добавьте в конфигурацию MCP-клиента:

{
  "mcpServers": {
    "pilorama": {
      "command": "npx",
      "args": ["-y", "@axdigital/pilorama-mcp"],
      "env": { "PILORAMA_API_KEY": "pil_ваш_ключ" }
    }
  }
}

MCP-пакет публикуется отдельно; следите за обновлениями в кабинете.

3. Или напрямую по REST

Любой запрос — с заголовком Authorization: Bearer pil_ваш_ключ. База: https://podcast.axdigital.ru

Метод	Что делает
`GET /api/my/rooms`	ваши записи со статусами
`GET /api/my/episodes`	опубликованные эпизоды
`POST /api/my/episodes`	опубликовать запись как эпизод
`POST /api/my/episodes/:id/post-telegram`	отправить эпизод в Telegram-канал
`GET/PUT /api/my/podcast`	метаданные подкаста и RSS-слаг
`PUT /api/my/integrations/telegram`	подключить бота и канал

curl -H "Authorization: Bearer pil_ваш_ключ" \
  https://podcast.axdigital.ru/api/my/episodes

Безопасность

Ключ действует от вашего имени — храните как пароль.
Отозвать в любой момент: кабинет → API-ключи → «Отозвать».
Выпускать и отзывать ключи можно только из кабинета (по входу), не самим ключом.

Создать ключ →