Communitygithub.com

clipspeed

동영상이나 라이브 스트림을 게시 준비가 완료된 자막 클립으로 변환하고, YouTube, TikTok, Instagram, X, LinkedIn, Threads, Bluesky, Facebook Page 등에 텍스트, 이미지, 동영상 또는 클립을 예약하거나 게시하며, 주간 포스트 계획, 소셜 계정 연결, 예약 확인, 포스트 통계 조회 등을 ClipSpeed를 통해 수행할 때 사용합니다.

clipspeed란 무엇인가요?

ClipSpeed는 에이전트가 콘텐츠 제작부터 스케줄링까지 모두 처리하는 소셜 미디어 게시 도구입니다. 하나의 계정과 `clipspeed` CLI(또는 MCP 프로토콜)를 통해 동영상/라이브 스트림에서 자동으로 점수가 매겨진 자막 클립을 추출하고, 사용자의 연결된 채널(YouTube, TikTok, Instagram, X, LinkedIn, Threads, Bluesky, Facebook Page)에 게시물을 계획하고 예약할 수 있습니다. 서버가 각 플랫폼의 게시 제한(일일 게시 수, 간격, 텍스트 길이 제한, 최적 시간)을 자동으로 관리하므로 사용자는 이 규칙을 신경 쓸 필요가 없습니다. 주요 워크플로는 '링크 → 클립 생성 → 주간 포스트 계획 → 승인 후 예약'의 완전한 루프를 제공하며, 사용자가 직접 작성한 텍스트, 이미지, 동영상을 그대로 게시하고, 중복 게시를 방지하며, 모든 명령은 미리보기 모드를 지원하여 사용자 승인 후에만 실제로 게시됩니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 MCP를 통해 통합될 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/thestockgoatballs/clipspeed-agent/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 체험판).

엄격한 규칙

  1. 예약 전에 먼저 보여주세요. 포스트가 두 개 이상인 경우 먼저 plan(또는 posts:create … --preview)을 실행하여 사용자의 시간대에 따른 슬롯을 보여주고, 사용자가 승인한 후에만 예약하세요. 서버는 사용자가 선택한 시간을 절대 변경하지 않습니다. 규칙을 위반하는 슬롯은 거부 사유와 함께 다음 가능한 시간을 반환합니다.
  2. 먼저 채널을 확인하세요. clipspeed channels:list는 연결된 채널과 각 플랫폼이 허용하는 콘텐츠 유형(텍스트/이미지/동영상) 및 제한을 알려줍니다. YouTube나 TikTok에는 텍스트 포스트를 작성하지 마세요. X의 280자(링크는 23자로 계산), Threads 500자, Bluesky 300자, LinkedIn 3,000자를 초과하지 마세요. 채널이 없는 경우 clipspeed channels:connect <platform>은 사용자가 열 수 있는 10분짜리 링크를 반환합니다. 사용자를 대신해 로그인할 수 없으며, ClipSpeed는 플랫폼 비밀번호를 절대 보지 않습니다.
  3. 사용자가 작성한 그대로 게시됩니다. 사용자가 작성한 텍스트/이미지/동영상 포스트는 그대로 게시됩니다(전달한 해시태그는 추가됨). 게시될 그대로 작성하세요.
  4. 미디어는 공개 HTTPS URL (JPG/PNG/WebP/GIF 최대 25MB, MP4/MOV/WebM 최대 1GB) 또는 ClipSpeed 클립 ID여야 합니다. 로컬 파일: 먼저 공개된 곳에 업로드하거나 ClipSpeed를 통해 클립하세요.
  5. 동일한 내용 = 동일한 포스트. 동일한 내용으로 동일한 플랫폼에 명령을 다시 실행하면 중복으로 간주되어 거부되므로 재시도로 인해 이중 게시되지 않습니다. 다시 게시하려면 텍스트를 변경하세요.
  6. 규칙이 허용하는 것보다 더 많은 게시를 약속하지 마세요. ClipSpeed의 제한은 모든 종류의 포스트에 동일하며 계정이 플래그 지정되는 것을 방지합니다. 플랫폼당 하루 최대 4개 게시물(LinkedIn 및 LinkedIn Pages는 2개), YouTube/Instagram 4시간 간격, TikTok/X/Facebook 2시간 간격, Threads/Bluesky 1시간 간격, LinkedIn 4시간 간격; 동일한 내용이나 파일은 30일 이내에 동일한 계정에 두 번 게시되지 않습니다. channels:list는 각 플랫폼의 수치를 제공하므로 이를 인용하세요.
  7. 명령이 반환한 결과를 보고하세요 — 포스트 ID, 현지 시간, 거부 사유 및 다음 가능한 슬롯. 포스트가 발행되었다고 주장하지 마세요. posts:list는 상태와 플랫폼이 ID를 발행한 후의 공개 링크를 보여줍니다.

표준 워크플로

링크 → 클립 → 주간 포스트 (전체 루프)

  1. clipspeed clip <video-url> --style karaoke → job_id / 프로젝트 ID.
  2. clipspeed status <job_id>를 약 60초 간격으로 completed 상태가 될 때까지 실행합니다(클립은 hasCaptions가 true일 때 최종 상태).
  3. clipspeed plan --project <project-id> --days 7 → 사용자 시간대의 일별 계획을 보여줍니다.
  4. 승인 시: clipspeed plan --project <project-id> --days 7 --approve → ID와 함께 예약된 포스트.

사용자가 지시한 포스트

  • clipspeed posts:create -p x,linkedin -c "오늘 에이전틱 스케줄링을 출시합니다." --at 2026-12-01T14:00:00Z --preview
  • clipspeed 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을 추가하면 기계가 읽을 수 있는 출력을 얻을 수 있습니다. 오류는 서버에서 일반 문장으로 반환됩니다(계획 필요, 연결되지 않음, 텍스트 너무 김, 당일 가득 참 및 다음 가능 시간 등) — 변경하지 않고 그대로 전달하세요.

관련 스킬