使い方ガイド

一度接続すれば、どの AI でも脚本を組版。

Narracore 脚本フォーマッターのすべて：AI アプリへの接続方法、入力の書き方、戻ってくる結果、無料枠と返金のルール、そして narracore.cn との関係。

1 · 接続

URL 1 つ、どんな MCP クライアントでも。

https://mcp.narracore.app/mcp コピーしました

Claude（claude.ai / Desktop）

Settings → Connectors → Add a custom connector
上の URL を貼り付け。無料枠に認証は不要
チャットで「この脚本を PDF に組版して」

ChatGPT（Developer mode）

Settings → Apps & Connectors → Developer mode
上の URL で dev connector を作成
あとはチャットで頼むだけ

Cursor

Settings → MCP → Add new global MCP server
タイプ url、値に上の URL

Gemini とすべての MCP クライアント

Streamable HTTP エンドポイント。無料枠は認証ヘッダー不要
ツール：format_screenplay と check_credits

有料キーをお持ちの方は、クライアントの認証設定に入れてください（Authorization: Bearer NRC-… または X-License-Key）。ヘッダーに入れればチャット履歴に残らず、license_key パラメータより優先されます。チャットに「私のキー：NRC-…」と貼って AI に渡しても構いません。

2 · 入力形式

Plain text でも、ブロック指定でも。

テキストモード（デフォルト）

1 行 1 要素で書きます：

見出し行：INT. LAB - DAY · 第 N 場 … · N 外 …
登場人物名は 1 行で（日本語・中国語はそのまま、英字は大文字）
対白（セリフ）は直後の行に、長くなりすぎず
単独の（ト書き）と CUT TO: / 切至： などの転換

ブロックモード（正確）

行ベース解析で判断が難しい文字（例：英字名＋「V.O.」）は、型付きブロックで提出：

対白ブロックは speaker と任意の delivery を持つ
ブロックは提出された通りに組版され、再分類されない
【…】の注記は報告されるだけで実行されない

無料の構造チェック：output="validate_only" を渡すと診断のみ。課金されず、無料枠も消費しません。改行のない長文は連続する动作として組版され、UNRESOLVED_STRUCTURE が付きます。

診断コード	意味
`UNRESOLVED_STRUCTURE`	脚本要素へ自信を持って分割できなかった（多くは改行なしの長文）。
`MISSING_SPEAKER`	対白ブロックに登場人物名がない。
`AMBIGUOUS_ACTION_MAYBE_DIALOGUE`	セリフに読めるが話者がいない行——動作として保持しフラグを付ける。
`LABELED_HEADER_LINE`	「ラベル：本文」の形で、ラベル付き見出しに見える行。
`REVISION_NOTE_PRESENT`	【…】や（…）に修正意図のキーワードがある——注記として報告、実行はしない。
`BRACKETED_ANNOTATION`	その他の【…】マーク（情報レベル）。
`UNBALANCED_DELIMITER`	対になるべき記号（括弧・引用符）の片方が欠けている。
`EMPTY_TEXT`	内容があるべき箇所が空行・空ブロック。

3 · 出力と制限

ブロック、整ったテキスト、印刷用 PDF。

毎回の呼び出しで、構造化ブロック・整ったプレーンテキストの脚本・PDF ダウンロードリンク（24 時間後に自動削除）が返ります。confidence は入力の何割の行が明確だったかの割合であって、精度の保証ではありません。

INT. 研究室 - 昼 1 ジョンはモニターを睨んでいる。針は着実に上がっていく。チャン（静かに）まだ水を沸かしている。これが唯一のチャンスだ。 CUT TO: — US Letter · CJK トラック 33 字 × 38 行 · ラテントラック 61 × 55 — 場面番号は右寄せ · Sarasa Mono / Courier Prime を埋め込み

文字グリッドが固定なのは意図です：1 ページ ≈ 1 分の画面時間、PDF は narracore.cn の印刷プレビューと行単位で一致します。テキストはメモリ上でのみ処理され、脚本内容はログにも訓練にも使いません。

4 · 無料枠・料金・返金

毎日 1 回は無料。

無料枠 — $0

毎日 1 回無料。アカウントもキーも不要
validate_only の構造チェックはいつでも無料

有料パック — $1.49／10 回 · $5.99／50 回

/checkout で購入（PayPal、ウィンドウ内でカード可）。支払い後すぐキーを表示
同じキーに追加購入でき、未使用分は失効しない

正直なルール：課金されるのは成功した組版だけ——失敗は一切課金されません。同じ request_id の再試行で二重課金はありません。未使用なら 7 日以内に全額返金（注文 ID を添えて huiyicd@foxmail.com へ）。サブスクなし、ウォレットなし、自動更新なし。キーは SHA-256 ハッシュと末尾 4 文字だけを保存します。

5 · narracore.app と narracore.cn

2 つの製品、同じ組版エンジン。

narracore.cn — 執筆ワークベンチ

ブラウザで完結する脚本ワークベンチ：8 種のブロックを持つ構造化エディタ、自動保存、印刷プレビューと PDF 出力
クラウドの作品管理、バージョン履歴、人物・場所・小道具、確定的な脚本統計（アカウント機能は招待制ベータ。エディタ自体はアカウント不要）

narracore.app — フォーマッター

リモート MCP ツール：AI クライアントにラフな原稿を渡すと、構造と PDF が返ってくる
エディタも作品管理もない——組版だけ。narracore.cn と同一の固定グリッド組版エンジンを使用

執筆はブラウザで narracore.cn、組版は AI で narracore.app。インストールドキュメントと実入力サンプルは公開リポジトリにもあります。