Puma.tech 開発者向けリソース
Puma.tech は公開の読み取り専用サイトです。エージェントは会社ページとディスカバリー文書を読めます。Puma AI は研究、Puma Browser はプロダクトです。このホストは API キーを受け付けず、サンドボックスでもありません。
利用場面は llms.txt を、短い一覧は API ドキュメント を見てください。
公開しているもの
- /llms.txt — エージェント向け索引。このサイトが合う仕事を含みます。
- /sitemap.xml — 正規の公開ページ。
- /robots.txt — クローラーとコンテンツ利用の方針。学習用クローラーは拒否します。
- /docs/api — ディスカバリー文書の説明。日本語は /ja/docs/api。
- /openapi.json — それらの文書と problem+json エラーの OpenAPI 3.1 記述。
- /.well-known/api-catalog — RFC 9727 API カタログ。
- /health.json — 公開ステータス。200 は静的サイトが配信されていることを示します。
- /.well-known/agent-skills/index.json — エージェントスキル索引。
- /.well-known/agent-skills/puma-site/SKILL.md — サイト案内スキル。
- /.well-known/mcp/server-card.json — ホームページの WebMCP ツールのカード。リモート HTTP MCP サーバーではありません。
- /.well-known/oauth-authorization-server、/.well-known/openid-configuration、/.well-known/oauth-protected-resource、/.well-known/jwks.json — 公開メタデータ。JWKS の鍵は空です。トークンは発行しません。
ページの読み方
公開 HTML ページには Accept: text/markdown を送ってください。応答は Content-Type: text/markdown; charset=utf-8 と Vary: Accept の Markdown です。ホームページは読み取り専用の WebMCP ツール list_puma_pages、find_puma_page、get_puma_summary、get_puma_app_links を登録します。これらはホームページのブラウザ上でのみ動き、ネットワーク API ではありません。
Accept: text/markdown で存在しないパスを開くと、HTTP 404 のまま Markdown が返り、/llms.txt、/sitemap.xml、/docs/api へリンクします。
エラー
JSON 文書とすべての /api/* は RFC 9457 の application/problem+json を返します。各オブジェクトは type、title、status、detail、instance、安定した code、次に何をすべきかを示す resolution を含みます。汎用の /api サービスはありません。その配下の未知パスは 404 です。
api_route_not_found
HTTP 404。/api にルートがありません。次の一手は /openapi.json、/llms.txt、このページです。
not_found
HTTP 404。JSON 文書のパスが存在しません。OpenAPI 記述か llms.txt で公開文書を探してください。
method_not_allowed
HTTP 405。Allow: GET, HEAD です。文書は読み取り専用です。GET か HEAD で再試行してください。
internal_error
HTTP 500。文書を読めませんでした。再試行し、だめなら /llms.txt に戻ってください。
製品判断
API キーはありません。API キーの発行は未決の製品判断です。Authorization ヘッダーを送らず、キーを作らないでください。
サンドボックスはありません。サンドボックス環境の提供は未決の製品判断です。公開サイトだけが環境であり、読み取り専用です。
OAuth と OpenID のメタデータファイルは、発見ツールが読めるように公開しています。トークン発行、クライアント登録、中身のある JWKS は実装していません。認可サーバーを作るかどうかは、上の静的文書とは別の製品判断です。
連絡先
人への連絡は [email protected]、採用は [email protected] です。AI で生成した応募は審査しません。会社ページは チーム、投資家、採用 です。