Transcribevideototext Sdk

transcribevideototext-sdk

VideoToTextの文字起こし API 用の公式クライアント、CLI、MCP サーバーです。いずれも公開 REST API を利用する薄型クライアントで、同じ vtt_ API キーで認証します。

パッケージ	インストール	内容
@transcribevideototext/client	npm i @transcribevideototext/client	型付きの JS/TS クライアントです。
@transcribevideototext/cli	npm i -g @transcribevideototext/cli	transcribe コマンドです。
@transcribevideototext/mcp-server	npx @transcribevideototext/mcp-server	Claude Code、Cursor、Codex 向け MCP サーバーです。

ダッシュボードの Developers → API Keys から API キーを取得してください。

クイックスタート

# CLI
npm install -g @transcribevideototext/cli
transcribe login
transcribe ./interview.mp4 --diarize

# MCP (Claude Code)
claude mcp add vtt -e VTT_API_KEY=vtt_… -- npx -y @transcribevideototext/mcp-server

MCP サーバーでは、YouTube、X、LinkedIn（およびその他の人気サイト）のリンク（公開コンテンツ）を貼り付けることもできます。リンク先のコンテンツはローカルにダウンロードされます。ダウンローダーは初回使用時に自動で取得され、その後文字起こしされます。MCP サーバーの READMEを参照してください。

// Client
import { createClient } from "@transcribevideototext/client";

const client = createClient({ apiKey: process.env.VTT_API_KEY! });
const result = await client.transcribeAndWait({ url: "https://example.com/podcast.mp3" });
console.log(result.segments.map((s) => s.text).join(" "));

開発

pnpm install
pnpm build        # builds all three (client first)
pnpm typecheck
pnpm lint

リリース

3 つのパッケージはChangesetsを使って、同じバージョン番号でリリースされます。

pnpm changeset          # describe a change
pnpm version-packages   # bump versions
pnpm release            # build + publish to npm