Otomatiskan Alur Kerja Klip: API ClipMaster dan Server MCP

Kalau kamu memotong video setiap minggu, lama-lama UI aplikasi justru jadi bagian yang paling lambat. Kamu sudah tahu podcast mana yang mau diklip, ke channel mana klipnya dikirim, dan kira-kira kapan harus terbit — kamu cuma mengeklik layar yang sama berulang-ulang untuk mewujudkannya. Sekarang ClipMaster membuka seluruh alur kerja itu secara terprogram: REST API untuk skrip dan tool, serta server MCP yang memungkinkan Claude menjalankannya dari chat. Artikel ini menunjukkan cara kerja keduanya dan kapan sebaiknya memakai yang mana.

Satu API, dua pintu masuk

Kedua jalur memakai API dan akun yang sama: setiap panggilan terbatas pada proyekmu sendiri, dihitung dengan token yang sama seperti di aplikasi, tanpa tagihan terpisah. Autentikasinya pakai kunci API (cm_live_…) yang dibuat di aplikasi lewat Pengaturan → Akses API, tersedia di paket berbayar. Kunci itu dikirim di header Authorization, bisa dicabut kapan saja, dan tidak pernah memberi akses ke manajemen akun, tagihan, atau fungsi admin — semua itu tetap di aplikasi web.

• REST API untuk skrip, cron job, dan tool buatanmu sendiri — apa pun yang butuh kontrol yang pasti.
• Server MCP untuk bekerja lewat percakapan: kamu bilang ke Claude hasil apa yang kamu mau, lalu Claude memanggil API yang sama atas namamu.

Seluruh alur kerja tercakup

Semua yang ada di antara “ini videonya” dan “klipnya sudah dijadwalkan terbit” bisa diotomatiskan lewat skrip: impor video lewat URL atau unggah file, pantau pemrosesan, tampilkan klip yang dihasilkan beserta metadata AI-nya (kalimat hook, jenis klip, transkrip), atur batas dan caption, simpan pengaturan editor, render ekspor, susun kompilasi, dan jadwalkan ekspor yang sudah jadi ke channel YouTube yang terhubung.

Satu alur lengkap dalam empat langkah

Impor video dan bawa sampai jadi klip yang bisa diunduh:

# 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

Dari situ, pola yang sama berlanjut ke penjadwalan (POST /scheduled-posts). Referensi endpoint lengkap beserta contoh permintaan dan respons ada di clipmaster.app/docs/api, dengan versi Markdown polos di /docs/api.md kalau kamu ingin memberikannya ke LLM.

Atau serahkan ke Claude

Server MCP membungkus API sebagai tool untuk Claude Desktop, Claude Code, dan klien MCP apa pun. Penyiapannya cukup satu blok config berisi kunci API-mu:

{
  "mcpServers": {
    "clipmaster": {
      "command": "uvx",
      "args": ["clipmaster-mcp"],
      "env": { "CLIPMASTER_API_KEY": "cm_live_..." }
    }
  }
}

Setelah itu, alur kerjanya adalah apa pun yang bisa kamu ucapkan. Beberapa hal yang bisa jalan dengan satu permintaan saja:

• “Impor episode ini dan kabari aku kalau sudah selesai.”
• “Klip mana yang hook-nya paling kuat? Tunjukkan transkripnya.”
• “Render dua klip teratas dan jadwalkan ke channel-ku untuk Jumat jam 5 sore.”
• “Apa saja yang sudah antre untuk terbit minggu ini?”

Bedanya dengan skrip ada di penilaian: Claude membaca metadata klip — hook, jenis, transkrip — dan membuat pilihan yang biasanya kamu lakukan dengan mata sendiri. Klien MCP-mu akan bertanya dulu sebelum menjalankan panggilan tool yang berdampak, dan apa pun yang dijadwalkan muncul di kalender aplikasi, tempat jadwalnya bisa diubah atau dibatalkan seperti postingan lain. Panduan penyiapan: clipmaster.app/docs/mcp.

Detail praktisnya

• Biayanya sama persis dengan di aplikasi. 1 token = 1 menit video sumber untuk pemrosesan; ekspor dikenai biaya sesuai aturan aplikasi. Panggilan API tidak pernah dikenai biaya tambahan.
• Kunci bisa dicabut dan punya batas permintaan. 120 permintaan/menit per kunci; mencabut kunci di Pengaturan langsung mematikannya.
• Percobaan ulang aman di bagian yang penting.Menjadwalkan ekspor yang sama ke slot yang sama dua kali akan mengembalikan postingan yang sudah ada, bukan memublikasikannya dua kali.
• Koneksi channel dilakukan sekali, di aplikasi. API dan MCP bisa menjadwalkan ke channel yang terhubung, tapi tidak pernah melakukan koneksi OAuth sendiri.

Kalau rutinitas memotong klipmu sudah bisa ditebak, berhenti mengekliknya satu per satu. Buat skrip untuk bagian yang bisa ditebak, atau serahkan ke Claude — lalu pakai waktumu untuk rekamannya sendiri.