llms.txt |
2つの道、1つのAPI。 llms.txtをCursor、Claude Code、ChatGPTに貼るか、Publishable Keysでブラウザ直接アプリを作る。SDKなし、バックエンドなし、CORS地獄なし。
コピー。貼り付け。出荷。
llms.txtをCursor、Claude Code、Windsurf、ChatGPTに貼ると、AIが動く統合コードを書く。
本物のAPIコールを行うAI-Canvasアプリ。
単一ファイルのReactアプリでブラウザから直接APIを呼び出す — Claude Artifacts、ChatGPT Canvas、Gemini、Grokで。Stripe流のPublishable Keys (po_pk_) — スコープ制限、予算制限、Originロック。
AI用に設計 — Postman用ではない。
Postman Collectionは1.5MBのJSON、Postman/Insomnia/Bruno用。llms.txtは純粋なMarkdown — すべてのLLMがネイティブに読める。
Postman Collection
~1.5 MBPostman、Insomnia、Bruno にインポート — クリックしてテスト、デバッグ、チーム共有。
Postmanへ →llms.txt (Hub)
~53 KBShort index — paste into AI for quick lookups, endpoint discovery.
llms.txt →llms-full.txt
~780 KBEvery endpoint with params, response samples, error codes — paste when building real integrations.
llms-full.txt →プロンプト例
これらのプロンプトはClaude、Cursor、Windsurf、ChatGPT、Gemini、その他どんなコーディングAIでも動作。
API ドキュメントを読み込みます：
[internal-endpoint] PDF ファイルを受け取り、抽出された OCR テキストを返す Python 関数を作成します。@Docs [internal-endpoint] POTERM_0 エンドポイントを作成し、/documentai/classify を使用してアップロードされた請求書を分類します。You have access to the PaperOffice API. The full spec is at:
https://api.paperoffice.ai/latest/docs/llms-full.txt
Use a Bearer token in the Authorization header.どのAIもllms.txtを話す。
Markdownはモダン LLMの母国語。docsを読むあらゆるツールにURLを投げ込むだけ。
信頼不要 — ルールはコンクリートに刻まれている。
Publishable Keysは、AI-canvasアーティファクトのソースコードから誰かがコピーしても安全を保つ設計。
危険なエンドポイントはブロック
DELETE、admin、billing、webhooks、トークン管理 — scopeに関わらずハードコードブロック。
予算上限が即座に作動
生涯クレジット上限到達時：HTTP 402 BUDGET_EXHAUSTED。1クレジットも超えない。
Redis経由のレート制限
トークンごとのスライディングウィンドウ。超過でHTTP 429を返す。
Originヘッダー必須
ブラウザが自動設定。漏れたpo_pk_のサーバー間悪用は不可能。
即時Revoke
ダッシュボードで「Revoke」をクリック — Redisキャッシュが即無効化。侵害されたキーはミリ秒で死亡。
粒度の高いscope
各scopeはダッシュボードで個別にオン/オフ可能。
30秒でゼロから動くコードへ
URLをコピー
完全仕様ならllms-full.txt、スリムなインデックスならllms.txt。
AIに貼る
ClaudeはURLを自動取得。Cursorには@Docs。ChatGPTがブラウズ。
プロンプトして出荷
AIはすべてのエンドポイント、認証、料金、エラーコードを理解。
ReadyPublishable Keysについて知るべきすべて。
本当にClaude Artifactsでしか動かない？
いいえ — po_pk_はあらゆるモダンAI-Canvasプラットフォームで動作：Claude Artifacts、ChatGPT Canvas、Gemini（Canvas & Gems）、Grok Workspaces、およびv0.dev、Bolt.new、StackBlitz、CodeSandboxのようなブラウザ環境。
po_pk_はpo_sk_とどう違う？
po_sk_（秘密鍵）はサーバー間連携向けです — API 全体へのフルアクセスが可能で、ブラウザーには絶対に置かないでください。po_pk_（Publishable Key）はブラウザーコード向けに設計されており、明示的に許可されたエンドポイントグループに限定されたスコープ、利用可能クレジットの上限、オリジン固定を備えています。AI キャンバスのアーティファクト内に po_sk_ があると完全な破壊につながりますが、po_pk_ は設計上、想定される損害が限定されています。
po_pk_が公開されたらどうなる？
被害は抑制される：origin-lock、予算上限、レート制限。「Revoke」でミリ秒で停止。
my-company.comのような独自originを設定できる？
はい。キー作成時に許可origin一覧を設定可能。WIDGETプリセットはそのため。
クレジット予算はどう設定？
作成時に生涯上限を選択（デフォルト1,000、AIDEMO 2,000、WIDGET 5,000）。キー回転なしで調整可能。
po_pk_ は po_sk_ と課金が異なりますか？
いいえ。すべての API 呼び出しは、po_sk_、po_ut_、po_pk_ のいずれを通じても、同じクレジットをメインアカウントから消費します。po_pk_ の予算上限は追加の安全策であり、別の料金体系ではありません。
po_pk_で使えないエンドポイントは？
すべての DELETE メソッド、および admin、billing、webhook、token-management の各エンドポイントは、スコープで何を選んでもハードコードでブロックされています。したがって、po_pk_ ではデータを削除したり、請求情報を読んだり、新しいトークンを作成したりすることは技術的に不可能です。
より少ないトークン、より安いプロンプト、JSONボイラープレートなし — llms.txtは純AI推論のための純コンテンツ。
プロンプトの準備完了？
コピー、貼り付け、出荷 — IDEか直接ブラウザで。2つの道、1つのAPI、ロックインなし。