Автоматизуйте робочий процес з кліпами: API ClipMaster та сервер MCP
Якщо ви щотижня створюєте кліпи з відео, інтерфейс застосунку з часом починає сповільнювати роботу. Ви вже знаєте, з якого подкасту потрібно створити кліпи, на який канал їх завантажити та приблизно коли вони мають бути опубліковані — ви просто клацаєте одні й ті самі екрани, щоб це зробити. ClipMaster тепер програмно надає доступ до всього цього робочого процесу: REST API для скриптів та інструментів, а також сервер MCP, який дозволяє Claude керувати ним з чату. У цій статті показано, як працюють обидва варіанти та коли який використовувати.
Один API, два способи доступу
Обидва шляхи використовують один і той самий базовий API та один і той самий обліковий запис: кожен виклик прив'язаний до ваших проєктів, тарифікується тими ж токенами, що й застосунок, без окремого виставлення рахунків. Автентифікація здійснюється за допомогою ключа API (cm_live_…), створеного в застосунку в розділі Налаштування → Доступ до API, доступного на платних планах. Ключ додається до заголовка Authorization, може бути відкликаний у будь-який час і ніколи не надає доступу до керування обліковим записом, виставлення рахунків або адміністративних функцій — вони залишаються у вебзастосунку.
- REST API призначений для скриптів, завдань cron та власних інструментів — усього, де потрібен детермінований контроль.
- Сервер MCP призначений для розмовної роботи: ви кажете Claude, який результат вам потрібен, і він викликає той самий API від вашого імені.
Охоплено весь робочий процес
Усе між «ось відео» та «кліп заплановано до публікації» можна скриптувати: імпортувати відео за URL-адресою або завантажити файл, опитувати обробку, перераховувати згенеровані кліпи з їхніми метаданими ШІ (хук-фрази, типи кліпів, транскрипції), налаштовувати межі та субтитри, зберігати налаштування редактора, рендерити експорти, створювати добірки та планувати готові експорти на підключений канал YouTube.
Повний запуск за чотири кроки
Завантажте відео та доведіть його до кліпу, доступного для завантаження:
# 1. Import a YouTube video
curl -X POST "https://api.clipmaster.app/api/v1/upload/from-url" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"source_url": "https://youtube.com/watch?v=..."}'
# -> {"project_id": 123, ...}
# 2. Poll until processing completes
curl "https://api.clipmaster.app/api/v1/projects/123/status" \
-H "Authorization: Bearer $KEY"
# -> {"status": "completed", "total_clips": 6, ...}
# 3. List the generated clips
curl "https://api.clipmaster.app/api/v1/projects/123/clips" \
-H "Authorization: Bearer $KEY"
# 4. Export it (captions, effects, trim), then download the export
curl -X POST "https://api.clipmaster.app/api/v1/projects/123/clips/456/export" \
-H "Authorization: Bearer $KEY"
# -> {"export_id": 37, ...}; poll /exports/37/status until "completed"
curl "https://api.clipmaster.app/api/v1/exports?clip_id=456" \
-H "Authorization: Bearer $KEY"
# -> newest completed export's "download_url" (presigned S3, expires next 00:00 UTC)
curl -L "$DOWNLOAD_URL" -o clip.mp4Звідси той самий шаблон поширюється на планування (POST /scheduled-posts). Повна довідка по кінцевих точках з прикладами запитів та відповідей знаходиться за адресою clipmaster.app/docs/api, з простим Markdown-дзеркалом за адресою /docs/api.md, якщо ви передаєте його до LLM.
Або направте на нього Claude
Сервер MCP обгортає API як інструменти для Claude Desktop, Claude Code та будь-якого клієнта MCP. Налаштування — це один блок конфігурації з вашим ключем API:
{
"mcpServers": {
"clipmaster": {
"command": "uvx",
"args": ["clipmaster-mcp"],
"env": { "CLIPMASTER_API_KEY": "cm_live_..." }
}
}
}Після цього робочий процес — це все, що ви можете сформулювати. Деякі речі, які працюють як єдині запити:
- «Імпортуй цей епізод і скажи мені, коли він буде готовий».
- «Який кліп має найсильніший хук? Покажи мені його транскрипцію».
- «Відрендери два найкращі кліпи та заплануй їх на мій канал на п'ятницю о 17:00».
- «Що вже стоїть у черзі на публікацію цього тижня?»
Відмінність від скрипта полягає в судженні: Claude читає метадані кліпу — хуки, типи, транскрипції — і робить вибір, який ви інакше зробили б візуально. Ваш клієнт MCP запитує перед значущими викликами інструментів, і все заплановане відображається в календарі застосунку, де його можна перенести або скасувати, як будь-яку іншу публікацію. Посібник з налаштування: clipmaster.app/docs/mcp.
Практичні деталі
- Витрати ідентичні витратам у застосунку. 1 токен = 1 вихідна хвилина для обробки; експорт тарифікується за правилами застосунку. Виклик API ніколи не коштує додатково.
- Ключі можна відкликати та вони мають обмеження за частотою. 120 запитів/хвилину на ключ; відкликання ключа в Налаштуваннях негайно його деактивує.
- Повторні спроби безпечні там, де це важливо.Планування одного й того ж експорту в один і той же слот двічі повертає існуючу публікацію замість подвійної публікації.
- Підключення каналів відбувається один раз, у застосунку.API та MCP можуть планувати публікації на підключений канал, але ніколи не виконують підключення OAuth самостійно.
Якщо ваша рутина створення кліпів вже передбачувана, припиніть проклацувати її. Скриптуйте передбачувану частину або передайте її Claude — і витратьте час на самі записи.
