URL 메타데이터 API

URL이 주어지면 해당 URL의 OpenGraph/meta 태그에서 스크래핑한 title / description / image / site_name을 반환합니다 (Microlink 스타일의 링크 미리보기 API). NEXUS 후보 #4 — 수동 빌드, FORGE 생성이 아님.

• `POST /extract {"url": "..."}`` -- x402를 통해 $0.01이 청구됨 (Base Sepolia 테스트넷).

• MCP 도구 extract_url_metadata는 /mcp에서 제공 — 현재 무료, "알려진 제한 사항" 참조.

• 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). 두 단계 배포 (보일러플레이트 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[...]]의 자체 payment-gate 메커니즘, FORGE의 생성기가 similarity-search-api/ws에 대해 수행하는 것과 동일)는 실제 위험이 있는 실제 작업입니다 (ctx 파라메에서 주입의 중복, 메모리 참조). 이 후보가 7일 창에서 실제 MCP 트래픽을 보일 때까지 보류됩니다. 그때까지 이 에셋은 볼륨(mcp_call_events)을 기록할 수 있지만 MCP 수익은 기록할 수 없습니다.

• 호출자별 비율 제한이 없음. 7일 일회성 측정에는 무방합니다; 살아남으면 추가하십시오.

• SSRF 가드는 IP-범위 기반이며, 전체 허용 목록이 아닙니다. 초기 요청과 수동으로 따라가는 모든 리다이렉트 홉(최대 3개)에서 비공개/루프백/링크-로컬/예약된 대상 IP(클라우드 메타데이터의 169.254.169.254 포함)를 거부합니다. 검사와 실제 연결 사이의 DNS 리바인딩을 방어하지 않습니다 (이 후보의 범위에서 허용된 위험).

측정 (설정 세션의 1부)

첫 실제 배포 이후 7일 기간. 진실의 원천: traffic_events/revenue_events/mcp_call_events 테이블 (asset_name = 'url-metadata-api')이며, Cloud Run 로그가 아닙니다. 7일째: 실제 트래픽이 0건인 경우(크롤러 필터링), Cloud Run 서비스를 삭제하고 (gcloud run services delete url-metadata-api --region us-central1 --project nexus-505016) 후보 #3로 이동합니다.