# YukkuriGen

> 日本語の「ゆっくり解説」動画を、AI エージェントが API 経由で作るためのサービス。
> 台本（話者＋セリフの配列）を渡すと、MP4 が返る。音声の合成から
> レンダーまでサーバ側で行う。
> **人が編集画面で作ることは想定していない。** 利用者は自分の AI（Claude /
> ChatGPT / Codex / Gemini）に頼み、その AI がここを呼ぶ。

エージェントがまず読むべきものは1つだけ:

- [Agent Skill（手順書・最初にこれを読む）](https://app.yukkurigen.com/skill.md): 接続、最小例、
  立ち絵、カメラ、クレジット、402 を受けたときの購入導線、冪等キー、
  バッチ生成、コールバックまで。日本語。

## 機械可読な定義

- [OpenAPI 3.1](https://app.yukkurigen.com/openapi.json): REST の全エンドポイント・全項目・エラーコード。
- [MCP エンドポイント](https://app.yukkurigen.com/api/mcp): JSON-RPC over HTTP。`Authorization: Bearer <token>`。
  `tools/list` でツール一覧が取れる。OpenAPI と同じ集合を公開している。
- [Protected Resource Metadata (RFC 9728)](https://app.yukkurigen.com/.well-known/oauth-protected-resource):
  スコープ一覧と認可サーバの場所。
- [Authorization Server Metadata (RFC 8414)](https://app.yukkurigen.com/.well-known/oauth-authorization-server):
  OAuth 2.1。動的クライアント登録（RFC 7591）と PKCE（S256 のみ）。発行されるトークンは API キーと同じもの。
  登録できる redirect_uri は https・ループバックの http（ポートは問わない。RFC 8252 §7.3）・
  アプリ独自のスキーム（`cursor://…` など。RFC 8252 §7.1。`javascript:` `data:` `file:` などは拒否）。

## つなぎ方

- **ChatGPT・claude.ai などのコネクタ**: `https://app.yukkurigen.com/api/mcp` を追加するだけ。
  YukkuriGen の許可画面が開くので、利用者が「許可する」を押す。鍵の発行は要らない。
- **VS Code**: MCP サーバーを種類 `http`・URL `https://app.yukkurigen.com/api/mcp` で追加するだけ。
  VS Code が認証してよいかを聞くので許可し、ブラウザで開く YukkuriGen の許可画面で「許可する」を押す。
  鍵の発行は要らない（2026-10-05 に VS Code 1.139 で、ツール一覧が出るまで確認）。
- **ほかのコードエディタ**（Cursor・Windsurf など）: 同じ URL でつながるか試してよい（実機では未確認）。
  つながらなければ、次の鍵を渡す方法を使う。
- **ヘッダーを足せるクライアント**（Claude Code・Codex CLI・Cursor・スクリプト）:
  [API キーの発行](https://app.yukkurigen.com/settings/api-keys) で鍵を発行し、`Authorization: Bearer <key>` で送る。
  OAuth でつながらないクライアントでも、この方法は従来どおり使える。
- OAuth で発行された鍵は、API キーの画面にアプリ名（VS Code なら「Visual Studio Code」）と「OAuth で接続」の札で
  出て、そこから取り消せる。
- 無料プランでできること: 台本づくり・読み返し・修正・**音声合成**・共有リンクでの確認（すべて0クレジット）。
- 有料が要ること: 本番の MP4 レンダー（動画1分につき1クレジット、端数切り上げ）。

## 人間向け

- [トップ](https://yukkurigen.com/)
- [料金](https://yukkurigen.com/pricing)
- [ヘルプセンター](https://help.yukkurigen.com/)
- [自分の AI につなぐ](https://help.yukkurigen.com/connect-your-ai)

## 未確認であること

- `create_yukkuri_video` から MP4 まで一息に通す経路は**本番未検証**
  （2026-09-07 時点）。台本の作成・音声の合成・レンダーの各段は個別に動いている。
  **まず少数の行で試し、`get_render` が `completed` を返すことを確かめること。**
  詳細は skill.md。