FRESH — Shared URL Freshness Intelligence

FRESH

再取得が必要かどうかを判断します。

FRESH は、AI エージェント向けの共有 URL 鮮度インテリジェンスです。URL を再取得、再スクレイピング、再レンダリング、または再埋め込みする前に、以前確認したバージョンを再利用できるほど新しい状態かどうかを確認します。

本番環境のベース URL：https://fresh-api-production-c783.up.railway.app

MCP エンドポイント：https://fresh-api-production-c783.up.railway.app/mcp

FRESH は、次の 3 つの判断のいずれかを返します。

• REUSE — キャッシュされた情報は、再利用できるほど新しい状態である可能性が高いです
• REFETCH — URL は古くなっている可能性が高く、再取得する価値があります
• UNKNOWN — 根拠が不十分です。FRESH は誤った確信よりも不確実性を優先します

FRESH が存在する理由

ローカルキャッシュでわかるのは、あなたが最後に何かを取得した時点です。それ以降に外部リソースが変更されたかどうかや、ほかの呼び出し元が最近何を確認したかはわかりません。FRESH は、タイムスタンプ、ETag、Last-Modified 値、コンテンツハッシュをもとに、プライバシーに配慮した共有 URL 変更履歴を構築します。

REST

POST /v1/check

{"url":"https://example.com/docs/api","lastSeenAt":"2026-08-13T12:00:00Z","toleranceSeconds":3600}

POST /v1/observe

{"url":"https://example.com/docs/api","observedAt":"2026-08-13T13:00:00Z","etag":"abc123","lastModified":"Wed, 13 Aug 2026 12:45:00 GMT","contentHash":"sha256:..."}

ページの生コンテンツは不要です。

MCP

• fresh_check — URL を再取得するかどうかを判断します
• fresh_observe — 取得後、プライバシーに配慮した鮮度の根拠を報告します

プライバシー

FRESH は、ページの生コンテンツ、Cookie、対象サイトの認証情報、顧客のペイロードを必要としません。URL キーは、一方向ハッシュと集計済みの観測メタデータとして保存されます。

外部利用者の検証

コアツールの呼び出しは利用の証拠ですが、それだけで実際の外部利用者によるものだと証明されるわけではありません。FRESH は、候補となるアクティビティを KNOWN_VALIDATOR、LIKELY_VALIDATOR、CONTROLLED_TEST、UNKNOWN_MACHINE、CREDIBLE_REAL_USE に分類します。外部利用者のマイルストーンが進むのは CREDIBLE_REAL_USE のみです。

受け入れテスト／スモークテストのトラフィックでは X-Tollbooth-Internal: 1 または X-Fresh-Internal: 1 を使用するため、外部利用者としての実績には加算されません。

本番受け入れゲート

すべての Railway デプロイでは、/health が 200 を返す前に、稼働中のサービスに対して内部チェックを実行するようになりました。このゲートでは、REST、UNKNOWN、REUSE、REFETCH、永続化された観測データの再読み込み、MCP の初期化、MCP ツールの検出、MCP fresh_check をテストし、制御されたセルフテストによって検証済み外部利用者数が増加しないことを確認します。

ステータス

v0.1.2 実験的な本番インフラストラクチャです。優先事項：保守的な判断、低レイテンシ、1 ペニー未満のコスト、プライバシーに配慮した共有学習、REST + MCP、永続的な観測データ、監査可能な実利用分析。