URLメタデータAPI

URLを指定すると、そのOpenGraph/metaタグから取得したtitle/description/image/site_nameを返します（MicrolinkスタイルのリンクプレビューAPI）。NEXUS候補#4 -- 手動ビルド、FORGE生成ではありません。

• POST /extract {"url": "..."} -- x402経由で$0.01が課金されます（Base Sepoliaテストネット）。

• /mcpのMCPツールextract_url_metadata -- 現在は無料です。「既知の制限」を参照してください。

• GET /health、GET /.well-known/agent-card.json、GET /openapi.json（x-payment-infoを含む）。

デプロイ先: Cloud Run（Railwayではありません）

products/mcp-boilerplate-gumroad/template/から構築（similarity-search-api/wsと同じMCP+x402+FastAPIパターン）し、RailwayではなくCloud Run用に適合させています。再利用可能なデプロイパイプラインについてはskills/infra-deploy-opsを参照してください（リポジトリルートのscripts/deploy_cloud_run.sh）。2段階デプロイ（ボイラープレートのREADMEに記載されているのと同じ落とし穴）：

# 1. First deploy -- PUBLIC_DOMAIN not known yet, every real request 421s until step 2.
./scripts/deploy_cloud_run.sh url-metadata-api manual_assets/url-metadata-api

# 2. Grab the printed *.run.app URL, then:
gcloud run services update url-metadata-api --region us-central1 --project nexus-505016 \
    --update-env-vars PUBLIC_DOMAIN=<the-real-domain>

Related MCP server: mcp-pageshot

既知の制限（意図的に未修正のまま -- CLAUDE.md SS3、必要性の証拠がなければゲートを設けない）

• MCPツール呼び出しは課金されません。 PaymentMiddlewareASGIはPOST /extractのみをゲートします。MCPツールは共有のextract_metadata()関数をプロセス内で直接呼び出します（ASGIアプリへのHTTP再エントリはありません -- この再エントリ経路が、skills/mcp-server-generationに文書化されている実際の「すべてのMCP呼び出しに誤った402が発生する」バグの原因でした）。本物のMCPネイティブなx402ゲート（x402[...,mcp]独自のペイメントゲート機構。FORGEのジェネレータがsimilarity-search-api/wsに対して行うのと同じ）を追加するのは、実際の作業であり、実際の落とし穴（重複するctxパラメータ注入、メモリ参照）があります -- この候補が7日間のウィンドウで実際のMCPトラフィックを示すまで延期します。それまでは、このアセットはボリューム（traffic_events/mcp_call_events）をログ記録できますが、MCP収益は記録できません。

• 呼び出し元ごとのレート制限はありません。 7日間の使い捨て測定には問題ありません。生き残るようなら追加します。

• SSRFガードはIPレンジベースであり、完全な許可リストではありません。 初期リクエストと、手動で追跡する各リダイレクトホップ（最大3回）で、プライベート/ループバック/リンクローカル/予約済みの宛先IP（クラウドメタデータの169.254.169.254を含む）を拒否します。チェックと実際の接続の間のDNSリバインディングには防御しません（この候補のスコープでは許容されるリスク）。

測定（セットアップセッションのパート3）

最初の本番デプロイから7日間のウィンドウ。信頼できる情報源: traffic_events/revenue_events/mcp_call_eventsテーブル（asset_name = 'url-metadata-api'）。Cloud Runのログではありません。7日目: 実際のトラフィックがゼロの場合（クローラーを除外）、Cloud Runサービスを一時停止/削除し（gcloud run services delete url-metadata-api --region us-central1 --project nexus-505016）、候補#3に移行します。