Автоматизирайте работата с клипове: API и MCP сървърът на ClipMaster

Ако обработвате видеоклипове всяка седмица, потребителският интерфейс на приложението в крайна сметка се превръща в бавната част. Вече знаете кой подкаст ще бъде изрязан, в кой канал ще отидат клиповете и приблизително кога трябва да бъдат публикувани – просто щракате през едни и същи екрани, за да го осъществите. ClipMaster вече излага целия този работен процес програмно: REST API за скриптове и инструменти и MCP сървър, който позволява на Claude да го управлява от чат. Тази статия показва как работят и кога да използвате кое.

Един API, два начина за достъп

И двата пътя използват един и същ основен API и един и същ акаунт: всяко повикване е обхванато от вашите собствени проекти, таксувано със същите токени като приложението, без отделно таксуване. Удостоверяването е API ключ (cm_live_…), създаден в приложението под Настройки → Достъп до API, достъпен при платени планове. Ключът отива в заглавката за оторизация, може да бъде отменен по всяко време и никога не предоставя достъп до управление на акаунти, таксуване или административни функции – те остават в уеб приложението.

• REST API е за скриптове, cron задачи и вашите собствени инструменти – всичко, където искате детерминиран контрол.
• MCP сървърът е за работа в разговорна форма: казвате на Claude какъв резултат искате и той извиква същия API от ваше име.

Целият работен процес е обхванат

Всичко между „ето едно видео“ и „клипът е насрочен за публикуване“ може да бъде скриптирано: импортирайте видеоклип по URL или качете файл, проследявайте обработката, изброявайте генерираните клипове с техните AI метаданни (закачащи реплики, типове клипове, преписи), коригирайте граници и субтитри, запазвайте настройките на редактора, рендирайте експорти, създавайте компилации и насрочвайте завършени експорти към свързан 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_..." }
    }
  }
}

След това работният процес е всичко, което можете да формулирате. Някои неща, които работят като единични заявки:

• „Импортирай този епизод и ми кажи кога е готов.“
• „Кой клип има най-силен „hook“? Покажи ми неговия препис.“
• „Рендирай първите два клипа и ги насрочи за моя канал за петък в 17:00 ч.“
• „Какво вече е насрочено за публикуване тази седмица?“

Разликата от скрипта е преценката: Claude чете метаданните на клипа – „hooks“, типове, преписи – и прави избора, който иначе бихте направили на око. Вашият MCP клиент пита преди важни извиквания на инструменти и всичко насрочено се показва в календара на приложението, където може да бъде пренасрочено или отменено като всяка друга публикация. Ръководство за настройка: clipmaster.app/docs/mcp.

Практическите детайли

• Разходите са идентични с тези на приложението. 1 токен = 1 минута източник за обработка; експортите се таксуват според правилата на приложението. API повикване никога не струва допълнително.
• Ключовете са отменими и с ограничена честота. 120 заявки/минута на ключ; отмяната на ключ в Настройки го убива незабавно.
• Повторните опити са безопасни, където е важно. Насрочването на същия експорт в същия слот два пъти връща съществуващата публикация, вместо да публикува двойно.
• Връзките към канали се осъществяват веднъж, в приложението. API и MCP могат да насрочват към свързан канал, но никога не извършват OAuth свързването сами.

Ако вашата рутина за изрязване вече е предвидима, спрете да щракате през нея. Скриптирайте предвидимата част или я предайте на Claude – и прекарайте времето в самите записи.