Unwatched

unwatched-mcp

输入视频 URL → 输出经过验证的操作手册。 面向 UNWATCHED 的 MCP 服务 + CLI。 任何 AI Agent（Claude Code、Cursor 或任何 MCP 客户端）都可以通过调用 UNWATCHED API，将视频解码为经过验证的结构化操作手册。

需要 Node.js ≥ 18 和从 https://unwatched.cloud/app/settings → API Keys 获取的 API 密钥。

60 秒快速入门

# 1. Install
npm i -g unwatched-mcp        # or use npx below without installing

# 2. Set your key
export UNWATCHED_API_KEY=uk_live_...     # or: ~/.config/unwatched/config

# 3. Decode a video (starts the job, waits, writes the runbook)
unwatched decode "https://www.youtube.com/watch?v=VIDEO_ID" --format yaml -o runbook.yaml

就是这样：runbook.yaml 现在已包含经过验证的操作手册。

CLI

unwatched decode <url> [--profile agent] [--format md|yaml|json] [-o file] [--timeout 600]
unwatched library [query] [--json]
unwatched status <job_id> [--wait] [--timeout 600]

• decode 会启动任务、轮询直至完成、获取操作手册，并将其写入 -o <file>（或标准输出）。
• library 会列出你所属租户之前的解码记录；query 会在客户端筛选。
• status 会显示任务状态和制品列表。

API 密钥解析

1. UNWATCHED_API_KEY 环境变量
2. ~/.config/unwatched/config — 内容为 UNWATCHED_API_KEY=uk_live_...，或单独一行的纯密钥

UNWATCHED_BASE_URL 可覆盖 API 基础 URL（默认值为 https://unwatched.cloud/api/v1）。

MCP 服务

此软件包附带一个 MCP 服务（stdio 传输），包含以下工具：

工具	功能
decode_video(url, profiles?)	启动解码任务 → 返回 job_id
get_job(job_id)	状态 + 制品列表
get_runbook(job_id, video_id, format: md|yaml|json)	操作手册内容
list_library(query?)	你所属租户之前的解码记录
wait_for_job(job_id, timeout_s=600)	轮询直至任务完成/部分完成/失败

典型的 Agent 工作流：decode_video → wait_for_job → get_job（查找 video_id）→ get_runbook。

错误会映射为可执行的提示：401 → 检查 API 密钥， 402 → 配额已用尽，请前往 https://unwatched.cloud/app/settings 升级， 429 → 请求受限（会遵循 Retry-After）。

Claude Code

claude mcp add unwatched --env UNWATCHED_API_KEY=uk_live_... -- npx -y unwatched-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "unwatched": {
      "command": "npx",
      "args": ["-y", "unwatched-mcp"],
      "env": { "UNWATCHED_API_KEY": "uk_live_..." }
    }
  }
}

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "unwatched": {
      "command": "npx",
      "args": ["-y", "unwatched-mcp"],
      "env": { "UNWATCHED_API_KEY": "uk_live_..." }
    }
  }
}

其他 MCP 客户端

直接通过 stdio 运行服务：

UNWATCHED_API_KEY=uk_live_... npx -y unwatched-mcp
# or, when installed globally:
unwatched-mcp

开发

npm install
npm run build
npm test          # smoke tests of the API client with mocked HTTP

目录结构：src/api-client.ts（REST 封装 + 错误映射）， src/cli.ts（commander CLI），src/mcp-server.ts（stdio MCP 服务）， src/config.ts（密钥/基础 URL 解析）。

许可证

MIT