For Agents
Agent-Friendly Interface
このページは AI Agent 向けのガイドです。必要なデータは JSON エンドポイントから取得できます。
Intent
- プロフィール情報と最新アウトプットを機械可読で取得できるようにする。
- 公開されている URL のみを扱い、認証や個人情報は含めない。
- 情報の鮮度はリクエスト時取得 + キャッシュで管理する。
Endpoints
- /api/profile — プロフィール・経歴・コンタクト・関心領域。更新頻度は低い。
- /api/outputs — Zenn / Qiita / note / SpeakerDeck / LayerX Blog を集約した最新アウトプット一覧。（既定14）に対応。
- /feed.json — アウトプット一覧のフィードリーダー向け形式。
- /llms.txt — エージェント向けの入口。エンドポイントの役割と取得作法を記載。
- / — 人間向けトップページ。JSON と同じデータから生成。
- /apps — ミニWebアプリ一覧。ブラウザUI前提で機械可読出力はなし。
Fetch Priority
- まず /llms.txt で入口と取得作法を確認する。
- データ取得は JSON エンドポイント（/api/profile / /api/outputs）を最優先する。
- HTML ページのスクレイピングは、JSON で取得できない表示上の確認が必要な場合の最終手段とする。
Access Policy
Do
- まず /llms.txt を参照して入口を確認する。
- 可能な限り /api/profile と /api/outputs を利用する。
- レスポンスのキャッシュヘッダを尊重し、再取得頻度を抑える。
Don't
- 短時間に高頻度でクロールしない（バーストアクセスを避ける）。
- 公開されていない情報の推測・補完をしない。
- ページDOMの過剰スクレイピングを前提にしない。
Rate Guidance
- 推奨: 1エージェントあたり、同一エンドポイントは 5 分に 1 回以下。
- 対話中に連続参照が必要な場合は、まず 1 回取得してローカルで再利用。
- Freshness が必要な場合のみ再取得し、通常はキャッシュを優先。
- レスポンスの Cache-Control ヘッダを尊重し、TTL 内の再取得は避ける。
- 再取得時は前回の ETag を で送る。304 が返れば手元のキャッシュが最新。
Retry Guidance
- 5xx またはタイムアウト時: 指数バックオフ（1秒 → 2秒 → 4秒）で最大 3 回まで再試行する。
- 4xx 時: リクエスト自体に問題があるため再試行しない。パスを見直す。
- /api/outputs の が空の場合は集約元フィードの一時的な障害。削除ではないので、時間をおいて再取得する。
- 手元にキャッシュ済みデータがあれば、再試行より先にそちらの利用を検討する。
Latest Outputs