Crabcut

io.github.realcrabcut由 GitHub 帳號 realcrabcut 發布v2.0.7更新於 Oct 24, 2026

Turn YouTube videos into short-form clips from any AI assistant

已驗證STDIO僅桌面效率與工作流媒體與設計

概覽

AI 產生的概覽

Crabcut 把 YouTube 連結轉成附字幕的直式短影音,讓助理發起任務、查詢進度並取得可下載的片段。

可以做什麼
  • 從 YouTube 連結發起切片生成,可限定起訖時間或設定 webhook 回呼
  • 查詢專案進度並取得依評分排序的成品片段
  • 列出歷史專案及其狀態與片段數量,查看單一片段的完整資訊
  • 查詢帳戶方案、剩餘額度與用量
適用情境
適合希望助理在對話中把長篇 YouTube 影片改造成直式短影音的場合,例如為社群媒體準備素材,或從錄影中挑出評分最高的精華片段。
執行需求
透過 npx 在本機執行,需要 Node.js;也可使用遠端 Streamable HTTP 端點。需要 Crabcut 帳戶,並以環境變數 CRABCUT_API_KEY 提供 API 金鑰(遠端端點使用 Bearer 權杖)。需要連線至 Crabcut API;可用 CRABCUT_API_URL 覆寫介面位址。
安裝前請注意
API 金鑰是正式憑證(形如 sk_live_...),會傳送到 Crabcut 伺服器,請勿放入共用設定。生成切片會消耗付費額度,回傳 402 表示額度不足。任務會把 YouTube 連結與處理結果傳送給第三方服務;若設定 callback_url,Crabcut 會向你指定的伺服器發出 POST 回呼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Crabcut,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@crabcut/mcp-server

Turn YouTube videos into short clips — from Claude, Cursor, or any AI assistant that supports MCP.

Give it a YouTube link. It finds the best moments, reframes for vertical video (9:16), adds subtitles, and returns download-ready clips.

[smithery badge] [CrabCut MCP server]

Quick Start

  1. Get an API key at app.crabcut.ai/developers
  2. Run:
bash
CRABCUT_API_KEY=sk_live_... npx @crabcut/mcp-server

Setup

Claude Desktop / Cursor

Add to your config file — claude_desktop_config.json for Claude, .cursor/mcp.json for Cursor:

json
{  "mcpServers": {    "crabcut": {      "command": "npx",      "args": ["@crabcut/mcp-server"],      "env": {        "CRABCUT_API_KEY": "sk_live_..."      }    }  }}

Cursor Directory

Install in Cursor

Smithery

bash
npx @smithery/cli mcp add crabcut/crabcut-mcp-server

Remote (Streamable HTTP)

For n8n, custom integrations, or any client that supports remote MCP:

  • Endpoint: https://mcp.crabcut.ai/mcp
  • Auth: Authorization: Bearer sk_live_...
  • Transport: Streamable HTTP (POST)

Tools

ToolWhat it does
generate_clipsStart clip generation from a YouTube URL. Returns a project_id right away.
get_project_statusCheck progress and get clips when ready. Clips are sorted by score (best first).
list_projectsList your projects with status and clip counts.
get_clipGet full details for a single clip.
check_usageSee your plan, remaining credits, and usage.

How It Works

  1. Call generate_clips with a YouTube URL
  2. Get back a project_id immediately
  3. Poll get_project_status every 10–15 seconds (or pass a callback_url for webhook)
  4. When done, clips are sorted by score (best first), each with a download_url

Statuses

Project: pending → processing → completed (or completed_no_clips / failed)

Processing steps: queued → DOWNLOADING_VIDEO → EXTRACTING_AUDIO → TRANSCRIBING → DETECTING_HIGHLIGHTS → CUTTING_CLIPS → EXPORTING_CLIPS → done

Clips: pending → exporting → completed (or failed). The download_url is available when clip_status is completed.

API Reference

generate_clips

Start clip generation from a YouTube video.

FieldTypeRequiredDescription
urlstringYesFull YouTube video URL
start_timenumberNoStart time in seconds (to process only a segment)
end_timenumberNoEnd time in seconds (to process only a segment)
callback_urlstringNoWebhook URL to receive results when done
json
{  "project_id": "43dbe622-8ac6-4579-9625-0ad7f0f9db0b",  "status": "processing",  "poll_url": "/api/v1/projects/43dbe622-8ac6-4579-9625-0ad7f0f9db0b",  "estimated_minutes": 5,  "message": "Processing started. Poll with get_project_status every 10-15 seconds until status is 'completed'."}

get_project_status

Check progress and get clips.

FieldTypeRequiredDescription
project_idstringYesThe project ID from generate_clips
json
{  "id": "43dbe622-...",  "name": "Video Title",  "status": "completed",  "step": "done",  "error": null,  "expected_clips": 9,  "duration": 639,  "created_at": "2026-03-15T02:21:46.226Z",  "clips": [    {      "id": "32538b9c-...",      "title": "One Dating Theory Leads to Chaos",      "duration": 41.83,      "score": 90,      "reason": "Sharp universal joke that hooks instantly with strong reactions.",      "clip_status": "completed",      "download_url": "https://cdn.crabcut.ai/exports/premium/.../clip-32538b9c-....mp4",      "quality": "1080p",      "thumbnail_url": "https://cdn.crabcut.ai/exports/premium/.../clip-32538b9c-...-thumb.jpg",      "created_at": "2026-03-15T02:29:10.954Z",      "updated_at": "2026-03-15T02:30:43.907Z"    }  ]}

Clips are sorted by score (highest first).

list_projects

FieldTypeRequiredDescription
limitnumberNoMax projects to return. Default 20, max 100.
statusstringNoFilter: pending, processing, completed, completed_no_clips, failed
json
{  "projects": [    {      "id": "43dbe622-...",      "name": "Video Title",      "status": "completed",      "step": "done",      "expected_clips": 9,      "clips_count": 8,      "duration": 639,      "created_at": "2026-03-15T02:21:46.226Z"    }  ],  "total": 1,  "limit": 20,  "offset": 0}

get_clip

FieldTypeRequiredDescription
clip_idstringYesThe clip ID from a project's clips array
json
{  "id": "32538b9c-...",  "project_id": "43dbe622-...",  "title": "One Dating Theory Leads to Chaos",  "duration": 41.83,  "score": 90,  "reason": "Sharp universal joke that hooks instantly.",  "export_status": "completed",  "export_quality": "1080p",  "is_exported": true,  "video_url": "https://cdn.crabcut.ai/...",  "video_url_720p": "https://cdn.crabcut.ai/...",  "video_url_1080p": "https://cdn.crabcut.ai/...",  "thumbnail_url": "https://cdn.crabcut.ai/...",  "created_at": "2026-03-15T02:29:10.954Z",  "updated_at": "2026-03-15T02:30:43.907Z"}

check_usage

No input required.

json
{  "plan": "pro",  "credits_remaining": 450,  "credits_total": 500,  "period_start": "2026-03-01T00:00:00.000Z",  "period_end": "2026-04-01T00:00:00.000Z"}

Errors

HTTP StatusErrorWhat to do
400Invalid YouTube URLCheck the URL format
401UnauthorizedCheck your API key
402Insufficient creditsBuy more credits or use a shorter video
429Rate limit exceededWait and try again
500Internal server errorTry again later

Webhooks

Pass a callback_url when calling generate_clips to receive a POST when all clips are ready.

Completed:

json
{  "event": "project.completed",  "project_id": "43dbe622-...",  "status": "completed",  "source_url": "https://www.youtube.com/watch?v=H51iLa1leOU",  "clips": [    {      "id": "32538b9c-...",      "title": "One Dating Theory Leads to Chaos",      "duration": 41.83,      "score": 90,      "download_url": "https://cdn.crabcut.ai/exports/premium/.../clip-32538b9c-....mp4",      "thumbnail_url": "https://cdn.crabcut.ai/exports/premium/.../clip-32538b9c-...-thumb.jpg",      "quality": "1080p"    }  ]}

Failed:

json
{  "event": "project.failed",  "project_id": "43dbe622-...",  "status": "failed",  "error": "YouTube video is unavailable",  "clips": []}

Clips are sorted by score (highest first). We retry up to 3 times if your server doesn't respond.

Signature verification (optional): Each callback includes an X-Crabcut-Signature header. Compute HMAC-SHA256 of the request body using SHA-256(your_api_key) as the signing key. Compare with the header value (sha256=<hex>).

Using with n8n

Option A — Webhook (recommended):

  1. Create a workflow with a Webhook trigger node. Copy its URL.
  2. Add an HTTP Request node: POST https://api.crabcut.ai/api/v1/clips/generate with Header Auth (Authorization: Bearer sk_live_...) and body:
    json
    {  "url": "https://www.youtube.com/watch?v=...",  "callback_url": "https://your-n8n.com/webhook/abc123"}
  3. When clips are ready, the Webhook node receives the payload.
  4. Best clip: {{ $json.clips[0].download_url }}

Option B — Polling loop:

  1. POST to generate clips (same as above, without callback_url).
  2. Wait 15 seconds → GET https://api.crabcut.ai/api/v1/projects/{{ $json.project_id }} → IF status is not completed, loop back to Wait.

REST API

For direct HTTP calls without MCP:

MethodEndpointDescription
POST/api/v1/clips/generateStart clip generation
GET/api/v1/projects/:idGet project status and clips
GET/api/v1/projectsList projects
GET/api/v1/clips/:idGet single clip details
GET/api/v1/account/usageCheck credits and plan

Base URL: https://api.crabcut.ai — All endpoints require Authorization: Bearer sk_live_...

Environment Variables

VariableRequiredDefault
CRABCUT_API_KEYYes—
CRABCUT_API_URLNohttps://api.crabcut.ai

Links

License

MIT

來源:README.md,提交 7ed258b

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v2.0.7最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分