superwall-editor

Superwall Paywall Editor

ペイウォールは、認証済みリレーを介してツールを公開するブラウザーエディターで作成します。このスキルは MCP ゲートウェイと同じ画面を操作するため、すべてのツールはユーザーが開いているライブブラウザーセッション内で実行されます。

使用する場面

• ユーザーが Superwall のペイウォール、オンボーディング、または web2app フローの作成、編集、レビューを希望している場合。
• ユーザーがペアリングコードを貼り付け、編集の引き継ぎを依頼した場合。
• ユーザーが「今すぐ実行できるツールは何ですか？」と尋ねた場合。記憶に頼らず、ブラウザーから確認してください。

まずは接続してから、ツールを確認する

ツール名やシグネチャを記憶から決めつけないでください。ブラウザーを正しい情報源としてください。ツールセットはリリースごとに変わります。

--agent-name には、codex、claude、cursor など、エージェントに認識されているスラッグを使用してください。CLI リファレンスに記載されていないエージェントには other を使用します。Grok Build と Muse Code も other を使用してください。

推奨する API 起動フロー：

1. 自動公開 URL を作成します：scripts/sw-editor.sh expose --application-id <id> --paywall-id <id> --agent-name <agent> --open --wait
2. 求められた場合は、ブラウザーの認証を完了するようユーザーに依頼します。エディターは自動で公開されるため、公開ボタンをクリックするよう依頼しないでください。
3. 現在利用できるものを確認します：scripts/sw-editor.sh tools
4. ツールを実行します：scripts/sw-editor.sh call <tool-name> --args '<json>'

代替の手動フロー：

1. エディター UI に表示されているペアリングコードをユーザーに尋ねます。
2. 接続します：scripts/sw-editor.sh attach <pairing-code> --agent-name <agent>
3. tools と call に進みます。

CLI の全リファレンス：references/cli.md。

作成と編集の方法

• ワークフロー、作成順序、各ツールの使い分け：references/workflow.md
• ネイティブの sw-* 要素（multiple-choice、indicator、drawer、picker、lottie、navigation）：references/native-elements.md
• デザイン基準、レビュー時の確認事項、タイポグラフィ、コンバージョンの原則：references/design.md

オーケストレーションのルール

• 編集を始める前に、必ず接続を確立してください。可能であれば expose --open --wait を使用し、それ以外の場合は attach <pairing-code> --agent-name <agent> を使用します。tools、call、status、release はすべて、接続済みのセッションが必要です。
• SUPERWALL_API_KEY、アプリケーション ID、ペイウォール ID がある場合は、expose --open --wait を優先してください。手動ペアリングと同じリレーを使用しますが、人がペアリングコードを入力する手順を省けます。
• このセッションでまだ使っていないツールを呼び出す前に、tools を実行して、そのツールが存在することと現在のパラメータースキーマを確認してください。ツールはブラウザーバンドル内で定義されているため、エディターが更新されると、このスキルを変更しなくても新しいツールが追加されたり、名前が変更されたりすることがあります。
• ツール一覧に get_screenshot がある場合は、2、3 回変更するごとに実行して確認してください。手探りで進めないでください。
• 既存の構造に対して write_html を再実行するよりも、セマンティックなツール（update_styles、set_text_content、set_dynamic_value、move_nodes）を優先してください。references/workflow.md を参照してください。
• UI がセマンティックなコントロールを表す場合は、独自に <div> で再現するよりもネイティブの sw-* 要素を優先してください。references/native-elements.md を参照してください。
• CLI の出力を解析するときは、Python ではなく jq を使用してください。例：sw-editor.sh call get_subtree --args '...' | jq -r '.content[0].text'
• ユーザーが作業を終えたら、接続を解除します：scripts/sw-editor.sh release。

問題が発生した場合

• session_not_ready: ブラウザーが切断されたか、再読み込みされました。ユーザーにエディターのタブを再度開くよう依頼してから、再アタッチしてください。ペアリングコードはローテーションされるため、ユーザーは新しいコードを提示する必要があります。
• session_locked: 別のクライアントがすでにアタッチされています。ユーザーが別の MCP クライアントからアタッチしたか、以前の CLI のアタッチが解放されていない可能性があります。ユーザーはエディターの UI からデタッチでき、その後再試行できます。
• unauthorized: コントローラートークンが古くなっています。新しいペアリングコードで再アタッチしてください。
• attach_failed: provide a valid current pairingCode: ペアリングコードは約 10 分で有効期限が切れ、デタッチ時にローテーションされます。ユーザーに現在のコードを提示するよう依頼してください。