| name | get-premium-content |
| description | x402プロトコルでtubone24ブログのペイウォール記事をAIエージェントが自律的にアンロック・取得するスキル。「ペイウォール記事を読みたい」「x402で記事をアンロックして」「premium記事の内容を取得して」「USDCで記事を購入して」など、有料記事の閲覧を依頼された場合に使用。Base SepoliaのUSDCで決済し、暗号化されたHTMLを復号してplaintextを返す。 |
get-premium-content
tubone24ブログのペイウォール記事を、AIエージェントが自律的にx402決済→復号→コンテンツ取得まで完結させるためのスキル。
いつこのスキルを使うか
以下のような依頼を受けたとき:
- 「
x402-paywall-demo の中身を読みたい」
- 「ペイウォール記事の一覧から面白そうなのを買って読んで」
- 「premium記事を全部アンロックして要約して」
- 「USDCで記事を購入してコンテンツを取って来て」
アーキテクチャ
このスキルは 2系統のインターフェース を提供する。同じ共通ライブラリ (functions/src/utils/x402-paywall.js) を内部で利用。
┌──────────────────────────────────┐
│ functions/src/utils/x402- │
│ paywall.js (共通実装) │
│ - unlockPremium │
│ - decryptEncryptedHtml │
│ - getPremiumContent │
└──────┬─────────────────┬──────────┘
│ │
┌────────────┴───────┐ ┌──────┴──────────┐
│ A) リモートMCP │ │ B) Skill CLI │
│ mcp-blog-server.js │ │ (Skill scripts) │
│ (Netlify Function) │ │ via yarn │
│ 【読み取り専用】 │ │ 【決済・取得】 │
└─────────────────────┘ └─────────────────┘
A) リモートMCPツール（読み取り専用・将来用）
mcp-blog-server.js (Netlify Function) が以下のMCPツールを公開する。決済を伴わない読み取り専用ツールのみ利用可能。
| MCPツール | 種別 | 役割 |
|---|
list_premium_posts | 読み取り | premium:true な記事一覧（priceUsd込み） |
get_premium_post_paywall_info | 読み取り | 単一slugの決済メタデータ（endpoint・network・asset・payTo） |
decrypt_premium_post | 計算のみ | password既知時の encrypted.html 取得・復号 |
注意: 決済ツール (unlock_premium_post / get_premium_content) はMCPサーバー側に EVM_PRIVATE_KEY を設置する必要があるため実装不可。決済は必ず Skill CLI（B）で行う。
B) Skill CLI（決済・コンテンツ取得の主経路）
| コマンド | 入力 | 出力 |
|---|
yarn unlock-premium <slug> | slug | password (hex) |
yarn decrypt-premium <slug> <password> | slug + password | plaintext HTML |
yarn get-premium-content <slug>... | slug 1..N | plaintext HTML 配列（JSON） |
CLI 経由の場合、決済署名は ローカルプロセス内 で完結し、.env の EVM_PRIVATE_KEY を使う（サーバーには鍵を渡さない）。
前提条件
実行前に必ず確認すること:
.env に EVM_PRIVATE_KEY が設定されている（CLI使用時）- ウォレットに Base Sepolia の USDC 残高がある（USDC Faucet で取得可能）
tsx が node_modules/.bin/tsx に存在する — 存在しない場合は yarn install を促す
実行上の注意
CLI は Claude Code エージェントから自律実行することを 優先する。ただし以下の制約がある:
- サンドボックスがデフォルトで
.env ファイルの読み取りを拒否する → dangerouslyDisableSandbox: true で実行すること
- hook がサンドボックス無効化 +
.env 読み取りの組み合わせを拒否した場合のみ、ユーザーに ! プレフィックスで実行を依頼する（フォールバック）
! yarn get-premium-content "<slug>"
標準フロー
ステップ1: アンロック対象の特定
方法A（MCPサーバー接続時）: list_premium_posts / search_posts / get_premium_post_paywall_info を使用。
方法B（MCPサーバー未接続時）: curl プリフライトリクエストで 402 レスポンスから決済情報を取得:
curl -s -i -X POST "https://tubone-project24.xyz/.netlify/functions/premium-content?slug=<slug>" \
-H "Content-Type: application/json" -d "{}"
レスポンスの payment-required ヘッダは Base64 エンコードされた JSON で、デコードすると payTo / amount / network / asset が得られる:
echo "<base64値>" | base64 -d | python3 -m json.tool
ステップ2: ユーザー確認（必須）
決済は 実費が発生する不可逆な行為。実行前に必ず確認:
- アンロック対象のslugとタイトル
- 合計の
priceUsd（複数記事ならその合計）
- 送金先（
payTo）
- ネットワーク（Base Sepolia）
ユーザーが明示的に承認するまで関連CLIを実行しないこと。
ステップ3: CLI実行（自律実行を優先）
確認後、dangerouslyDisableSandbox: true で CLI を自律実行する:
yarn get-premium-content "<slug>"
hook に拒否された場合のみ、ユーザーに ! yarn get-premium-content "<slug>" で実行を依頼する（フォールバック）。
各slugに対して内部的に:
- x402決済（Base Sepolia USDC）→ password取得
https://tubone-project24.xyz/{slug}/encrypted.html を fetch- pagecrypt フォーマット（PBKDF2-SHA256 2M回 → AES-GCM-256）で復号
- plaintext HTML を返却
出力形式:
[
{
"slug": "...",
"password": "...",
"encryptedUrl": "https://tubone-project24.xyz/.../encrypted.html",
"contentHtml": "<!-- 復号されたHTML -->"
}
]
ステップ4: 後処理
- 取得したplaintextは原則 メモリ上のみで扱い、ファイルに保存しない
- ユーザーから明示的な保存指示があった場合のみファイル化する
エラーハンドリング指針
EVM_PRIVATE_KEY が未設定 → .env への設定を促すinvalid private key → .env の EVM_PRIVATE_KEY が 0x プレフィックス付き64桁の16進数形式であることを確認するよう促すtsx: command not found → yarn install を実行するよう促すVerification failed / Insufficient funds → ウォレット残高をfaucetで補充するよう促すPost not found / Post is not premium → slugが正しいか確認するよう案内復号失敗 → SITE_SECRET の不一致（運営者側の問題）。ユーザーに連絡を促す
してはいけないこと
- ユーザー確認なしで決済を実行しない
- 取得したplaintextをchatログ以外（Slack・GitHub Issue・Gist等）に転記しない
EVM_PRIVATE_KEY をログ・stdoutに出力しない- 同一slugを大量回数呼び出さない（重複決済の防止）
