linkscribe

linkscribe

linkscribe にリンクを渡すと、言葉になって返ってきます。linkscribe は txscribe アカウントと連携します。録音へのリンク（YouTube 動画、Google Drive ファイル、Dropbox の共有リンク）を貼り付けると、サービスが 文字起こしします（録音そのものはダウンロードせず、その場で 文字起こしされます）。その後、完成した 文字起こしを必要な形式で読んだり、要約を依頼したり、すべての録音を検索して 単語やフレーズが話された箇所を探したり、 不要になった録音を削除したりできます。

8 つのツール：

• list_transcriptions — 文字起こしの一覧を新しい順に表示します。 limit / cursor によるページングと、任意の status フィルターに対応しています。
• search_transcriptions — タイトルではなく、発話内容を検索します。 録音ごとに最大 5 件の一致を返し、それぞれ開始時刻を秒単位で示します。
• transcribe_link — リンク（YouTube、TikTok、Instagram、X (Twitter)、Facebook、Vimeo、 Loom、Dropbox）から文字起こしを作成します。任意の language （"auto" または en-US などのコード）、diarization、captions（YouTube のみ。動画の字幕が適切な場合は使用）を指定できます。 利用時間を消費します。
• get_transcription — 1 件の文字起こしのステータスとメタデータを取得します。
• get_transcript — 完成した文字起こしを json （セグメント、単語のタイミング、話者）、txt、docx、pdf、srt、vtt、fcpxml、premiere、nvivo、maxqda、または atlasti 形式で取得します。timestamps と speakers は任意で指定でき、 from / to に秒単位で範囲を指定すると、ある時点の前後の段落だけを返します。
• get_summary — 要約とそのステータスを取得します。
• request_summary — 要約、または新しい要約を依頼します。出力 language と録音の種類（scene。例：会議、インタビュー、講義。省略するとモデルが選択）を指定できます。
• delete_transcription — 文字起こしと、それをもとに作成されたすべてのものを削除します。 元に戻すことはできません。

すべての呼び出しには、独自の txscribe API キーが使用されます。

export TXSCRIBE_API_KEY="txs_live_…"   # sent as Authorization: Bearer <key>
# optional: export TXSCRIBE_API_BASE="https://txscribe.ai/api/v1"

TXSCRIBE_API_KEY を設定しなくてもサーバーは起動し、ツール一覧を表示しますが、すべてのツール呼び出しは TXSCRIBE_API_KEY is not set で失敗し、リクエストは送信されません。成功時には、ツールは上流の JSON 本文をそのまま返します。エラー本文にコードが含まれる場合、上流エラーは txscribe error: <code> (HTTP <status>) として返されます。コードが含まれない場合は txscribe error: HTTP <status> として返されます。サービスに到達できない場合は txscribe unreachable として返されます。

設計上、実装していないもの：REST Webhook エンドポイントと ファイルアップロードのフローは、元のサービスでは MCP ツールではないため、linkscribe でも公開していません。元の README には get_transcript の summaryOnly フラグについても記載されていますが、 公開済みの OpenAPI ドキュメントには存在しないため、ここでは公開していません。

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドです。

npx @reneturcios/linkscribe list_transcriptions '{"limit":10}'
npx @reneturcios/linkscribe search_transcriptions '{"q":"budget"}'
npx @reneturcios/linkscribe transcribe_link '{"url":"https://youtu.be/…","diarization":true}'
npx @reneturcios/linkscribe get_transcript '{"id":"<id>","format":"srt"}'
npx @reneturcios/linkscribe request_summary '{"id":"<id>","scene":"meeting"}'
npx @reneturcios/linkscribe --version

出力はツールの結果テキストです。終了コード：成功時は 0、 実行時エラー（検証エラーや txscribe の失敗を含む）は 1、使用方法のエラーは 2 です。

MCP サーバー

npx -y @reneturcios/linkscribe mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "linkscribe": {
      "command": "npx",
      "args": ["-y", "@reneturcios/linkscribe", "mcp"],
      "env": {
        "TXSCRIBE_API_KEY": "txs_live_…"
      }
    }
  }
}

Docker

docker run -i -e TXSCRIBE_API_KEY="txs_live_…" ghcr.io/cloudcorprecords/linkscribe
docker run --rm -e TXSCRIBE_API_KEY="txs_live_…" ghcr.io/cloudcorprecords/linkscribe list_transcriptions '{}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios