/ 目錄 / 演練場 / narrator-ai-cli-skill
● 社群 GridLtd-ProductDev ⚡ 即開即用

narrator-ai-cli-skill

作者 GridLtd-ProductDev · GridLtd-ProductDev/narrator-ai-cli-skill

Narrator AI 影片配音 CLI 的 Agent 技能 — 由 Claude 從命令列端對端驅動配音流程。

narrator-ai-cli-skill 教導 Claude 如何使用 narrator-ai-cli(Narrator AI 影片配音 API 的 CLI 客戶端)。它封裝了旗標、常見流程與輸出處理,讓 Claude 能組合配音提示、啟動工作、輪詢完成狀態,並將輸出檔案放置到合適的位置 — 當您想要批次配音一系列影片而無需手動執行 CLI 時特別實用。

為什麼要用

核心特性

即時演示

實際使用效果

narrator-ai-cli-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "narrator-ai-cli-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "narrator-ai-cli-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
        "~/.claude/skills/narrator-ai-cli-skill"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "narrator-ai-cli-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill",
          "~/.claude/skills/narrator-ai-cli-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add narrator-ai-cli-skill -- git clone https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill ~/.claude/skills/narrator-ai-cli-skill

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: narrator-ai-cli-skill

如何根據腳本為單一影片配音

👤 使用 Narrator AI 進行配音的創作者與剪輯師 ⏱ ~15 min beginner

何時使用: 您有一部影片和一份配音腳本草稿,想透過 CLI 產生配音。

前置條件
  • 已安裝並設定 narrator-ai-cli — 依照 CLI 的上游安裝文件操作
  • 已複製技能 — git clone https://github.com/GridLtd-ProductDev/narrator-ai-cli-skill ~/.claude/skills/narrator-ai-cli-skill
步驟
  1. 準備輸入素材
    給定我的影片 scene_01.mp4 和配音腳本 script.md,執行 narrator-ai-cli 並將輸出儲存到 ./narrations/。✓ 已複製
    → 使用正確旗標呼叫 CLI
  2. 等待並驗證
    輪詢直到工作完成,然後確認輸出檔案存在且有音訊內容。✓ 已複製
    → 輸出檔案存在且時長不為零

結果: 配音檔案已就緒,可直接匯入您的剪輯軟體。

注意事項
  • 長時間工作在 shell 中逾時 — 使用 CLI 的非同步模式搭配輪詢,而非阻塞式呼叫
搭配使用: filesystem

批次為一系列場景配音

👤 擁有多場景專案的團隊 ⏱ ~45 min intermediate

何時使用: 您有 10 個以上場景,每個場景都有對應腳本,需要以一致的方式完成配音。

步驟
  1. 遍歷專案結構
    找出 project/ 下所有 scene_*.mp4 與 scene_*.md 配對,並逐一排入配音佇列。✓ 已複製
    → 列舉出所有配對並建立工作佇列
  2. 序列或並行執行
    最多同時執行 3 個工作;依 API 限制進行速率控制。✓ 已複製
    → 受控的並發執行
  3. 回報結果
    產生一份表格:場景、狀態、時長、輸出路徑。✓ 已複製
    → 清楚的完成狀態表格

結果: 整個專案在單次執行中完成配音,並附有清楚的狀態報告。

注意事項
  • 批次執行中途觸碰 API 限制 — 遵守上游速率限制;遇到 429 時進行退避重試
搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

narrator-ai-cli-skill + filesystem

自動尋找輸入素材,並將輸出放置到結構化資料夾中

遍歷 project/,為每個場景配音,輸出至 project/narrations/。✓ 已複製
narrator-ai-cli-skill + claude-shorts-skill

為 claude-shorts 產生的短片加入 AI 配音

為每支渲染完成的短片配音一段開場白並混音進去。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
cli-invocation inputs (video+script) + flags 每次配音執行時呼叫 narrator-ai API usage
job-polling job id 提交工作後呼叫 minimal
batch-orchestration list of jobs 多場景專案時呼叫 depends on batch size

成本與限制

運行它的成本

API 配額
依 Narrator AI 方案而定
每次呼叫 Token 數
LLM token 消耗極少;主要費用來自 API 使用分鐘數
費用
由 Narrator AI 按 API 用量計費
提示
僅對最終腳本進行配音;先在 LLM 中反覆調整文字內容

安全

權限、密鑰、影響範圍

憑證儲存: Narrator AI API 金鑰存放於環境變數中;切勿直接寫入程式碼
資料出站: Narrator AI endpoints

故障排查

常見錯誤與修復

Skill doesn't activate

確認 SKILL.md 位於複製目錄的根目錄,並重新啟動 Claude Code。

驗證: ls ~/.claude/skills/narrator-ai-cli-skill/SKILL.md
CLI command not found

安裝 narrator-ai-cli,並確認它在 Claude Code 執行環境的 PATH 中。

驗證: which narrator-ai-cli
401 from Narrator API

設定 NARRATOR_API_KEY(或 CLI 所需的對應環境變數)。

驗證: env | grep NARRATOR

替代方案

narrator-ai-cli-skill 對比其他方案

替代方案何時用它替代權衡
claude-shorts-skill您需要完整的長片轉短片流水線,而不只是配音功能完整流水線 vs 單一用途工具

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills