ClipSpeed — 클립하고, 계획하고, 게시하세요
ClipSpeed는 에이전트가 콘텐츠까지 만드는 스케줄러입니다. 하나의 계정, 하나의 clipspeed CLI(또는 https://api.clipspeed.ai/mcp에서 동일한 도구를 MCP로 사용): 동영상이나 라이브 스트림을 점수와 자막이 있는 클립으로 자르고, 사용자가 직접 작성한 단어, 이미지, 동영상 또는 해당 클립을 사용자 연결 채널에 계획하고 예약할 수 있습니다. 서버가 규칙(계정의 일일 제한, 간격, 각 플랫폼의 텍스트 제한 및 최적 시간)을 관리하므로 사용자가 신경 쓸 필요가 없습니다.
설치: npm i -g clipspeed-mcp (clipspeed 제공), 그 다음 clipspeed auth:key csai_live_… 또는 export CLIPSPEED_API_KEY=csai_live_… 를 실행하세요. API 키: https://www.clipspeed.ai/dashboard/api-key/ (유료 플랜 또는 $1 체험판).
엄격한 규칙
- 예약 전에 먼저 보여주세요. 포스트가 두 개 이상인 경우 먼저
plan(또는posts:create … --preview)을 실행하여 사용자의 시간대에 따른 슬롯을 보여주고, 사용자가 승인한 후에만 예약하세요. 서버는 사용자가 선택한 시간을 절대 변경하지 않습니다. 규칙을 위반하는 슬롯은 거부 사유와 함께 다음 가능한 시간을 반환합니다. - 먼저 채널을 확인하세요.
clipspeed channels:list는 연결된 채널과 각 플랫폼이 허용하는 콘텐츠 유형(텍스트/이미지/동영상) 및 제한을 알려줍니다. YouTube나 TikTok에는 텍스트 포스트를 작성하지 마세요. X의 280자(링크는 23자로 계산), Threads 500자, Bluesky 300자, LinkedIn 3,000자를 초과하지 마세요. 채널이 없는 경우clipspeed channels:connect <platform>은 사용자가 열 수 있는 10분짜리 링크를 반환합니다. 사용자를 대신해 로그인할 수 없으며, ClipSpeed는 플랫폼 비밀번호를 절대 보지 않습니다. - 사용자가 작성한 그대로 게시됩니다. 사용자가 작성한 텍스트/이미지/동영상 포스트는 그대로 게시됩니다(전달한 해시태그는 추가됨). 게시될 그대로 작성하세요.
- 미디어는 공개 HTTPS URL (JPG/PNG/WebP/GIF 최대 25MB, MP4/MOV/WebM 최대 1GB) 또는 ClipSpeed 클립 ID여야 합니다. 로컬 파일: 먼저 공개된 곳에 업로드하거나 ClipSpeed를 통해 클립하세요.
- 동일한 내용 = 동일한 포스트. 동일한 내용으로 동일한 플랫폼에 명령을 다시 실행하면 중복으로 간주되어 거부되므로 재시도로 인해 이중 게시되지 않습니다. 다시 게시하려면 텍스트를 변경하세요.
- 규칙이 허용하는 것보다 더 많은 게시를 약속하지 마세요. ClipSpeed의 제한은 모든 종류의 포스트에 동일하며 계정이 플래그 지정되는 것을 방지합니다. 플랫폼당 하루 최대 4개 게시물(LinkedIn 및 LinkedIn Pages는 2개), YouTube/Instagram 4시간 간격, TikTok/X/Facebook 2시간 간격, Threads/Bluesky 1시간 간격, LinkedIn 4시간 간격; 동일한 내용이나 파일은 30일 이내에 동일한 계정에 두 번 게시되지 않습니다.
channels:list는 각 플랫폼의 수치를 제공하므로 이를 인용하세요. - 명령이 반환한 결과를 보고하세요 — 포스트 ID, 현지 시간, 거부 사유 및 다음 가능한 슬롯. 포스트가 발행되었다고 주장하지 마세요.
posts:list는 상태와 플랫폼이 ID를 발행한 후의 공개 링크를 보여줍니다.
표준 워크플로
링크 → 클립 → 주간 포스트 (전체 루프)
clipspeed clip <video-url> --style karaoke→job_id/ 프로젝트 ID.clipspeed status <job_id>를 약 60초 간격으로completed상태가 될 때까지 실행합니다(클립은hasCaptions가 true일 때 최종 상태).clipspeed plan --project <project-id> --days 7→ 사용자 시간대의 일별 계획을 보여줍니다.- 승인 시:
clipspeed plan --project <project-id> --days 7 --approve→ ID와 함께 예약된 포스트.
사용자가 지시한 포스트
clipspeed posts:create -p x,linkedin -c "오늘 에이전틱 스케줄링을 출시합니다." --at 2026-12-01T14:00:00Z --previewclipspeed posts:create -p x,linkedin -c "LinkedIn용 긴 버전…" --x-text "X용 짧은 버전" --preview(하나의 포스트, X에는 별도 사본; 각 플랫폼은 자체 제한에 따라 확인됨) 그런 다음--preview없이 동일하게 실행합니다.--at을 생략하면 계정의 간격 규칙이 허용하는 즉시 게시됩니다(응답에 시간이 표시됨). 이미지/동영상의 경우--media <url>, ClipSpeed 클립의 경우--clip <clip-id>, 플랫폼에 제목이 있는 경우--title(YouTube는 필수), YouTube의 경우--privacy unlisted.
캘린더 관리
clipspeed posts:list [--status scheduled] [--platform x]·clipspeed posts:update <id> -c "새로운 사본"(전송이 시작되기 전에만 가능; 시간은 변경 불가) ·clipspeed posts:cancel <id>·clipspeed analytics <id>.
아이디어 — clipspeed discover "<niche>"는 클립할 최근 급성장 동영상을 순위화합니다.
빠른 참조
| 명령어 | 기능 | 주요 플래그 |
|---|---|---|
channels:list | 연결된 채널, 각 채널이 허용하는 콘텐츠, 제한, 계정 시간대 | |
channels:connect <platform> | 사용자를 위한 10분 연결 링크 | |
settings <platform> | 하나의 플랫폼에 대한 규칙 | |
posts:create | 하나 이상의 플랫폼에 포스트 하나를 예약; --x-text, --linkedin-text, --youtube-title … 또는 --per-platform '<json>'로 채널별 조정 가능 | -p -c --media --carousel (쉼표 목록, 순서대로) --type story + --stories a,b (Instagram / Facebook Page 스토리, 순서대로, 캡션 없음) --clip --at --title --hashtags --privacy --preview --<platform>-text --per-platform |
plan | 프로젝트의 클립을 다음 날에 배치; --approve는 예약 | --project --clips -p --days --preset steady|balanced|beast |
posts:list / posts:update / posts:cancel / analytics | 캘린더 | --status --platform |
clip <url> / status <job> / clips / download <job> | 클리핑 | --style --aspect --count |
discover "<niche>" / usage | 아이디어, 잔액 |
모든 명령에 --json을 추가하면 기계가 읽을 수 있는 출력을 얻을 수 있습니다. 오류는 서버에서 일반 문장으로 반환됩니다(계획 필요, 연결되지 않음, 텍스트 너무 김, 당일 가득 참 및 다음 가능 시간 등) — 변경하지 않고 그대로 전달하세요.