url-metadata-api
URL-Metadaten-API
Liefert für eine URL die title/description/image/site_name, die aus ihren OpenGraph-/Meta-Tags extrahiert wurden
(Microlink-artige Link-Preview-API). NEXUS-Kandidat #4 -- manueller Build, nicht FORGE-generiert.
POST /extract {"url": "..."}-- wird mit $0,01 über x402 berechnet (Base Sepolia-Testnetz).MCP-Tool
extract_url_metadataunter/mcp-- derzeit kostenlos, siehe "Bekannte Einschränkungen".GET /health,GET /.well-known/agent-card.json,GET /openapi.json(enthältx-payment-info).
Bereitstellungsziel: Cloud Run, nicht Railway
Erstellt aus products/mcp-boilerplate-gumroad/template/ (gleiches MCP+x402+FastAPI-Muster wie
similarity-search-api/ws), angepasst für Cloud Run statt Railway. Siehe
skills/infra-deploy-ops für die wiederverwendbare Bereitstellungs-Pipeline (scripts/deploy_cloud_run.sh im
Repository-Stammverzeichnis). Zweistufige Bereitstellung (dieselbe Stolperfalle, die die Boilerplate-README dokumentiert):
# 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
Bekannte Einschränkungen (bewusst nicht behoben -- CLAUDE.md SS3, kein Gate ohne Beleg, dass es nötig ist)
MCP-Toolaufrufe werden nicht berechnet.
PaymentMiddlewareASGIschützt nurPOST /extract; das MCP-Tool ruft die gemeinsameextract_metadata()-Funktion direkt prozessintern auf (kein HTTP-Wiedereintritt in die ASGI- App -- genau dieser Wiedereintrittspfad war die Ursache des echten "jeder MCP-Aufruf erhält einen unberechtigten 402"-Bugs, der inskills/mcp-server-generationdokumentiert ist). Ein echtes MCP-natives x402-Gate hinzuzufügen (x402[...,mcp]'s eigener Zahlungs-Gate-Mechanismus, derselbe, den FORGEs Generator fürsimilarity-search-api/wsverwendet), ist echte Arbeit mit einer echten Stolperfalle (doppeltectx-Parameter-Injektion, siehe Gedächtnis) -- aufgeschoben, bis dieser Kandidat im 7-Tage-Fenster echten MCP-Traffic zeigt. Bis dahin kann dieses Asset Volumen protokollieren (traffic_events/mcp_call_events), aber keine MCP-Einnahmen.Keine Rate-Limits pro Aufrufer. Für eine 7-tägige Einweg-Messung in Ordnung; hinzufügen, falls es überlebt.
Der SSRF-Schutz basiert auf IP-Bereichen, nicht auf einer vollständigen Whitelist. Lehnt private/Loopback-/Link-Local-/reservierte Ziel-IPs ab (einschließlich Cloud-Metadaten-
169.254.169.254) bei der ursprünglichen Anfrage und bei jedem manuell gefolgten Umleitungssprung (max. 3). Bietet keinen Schutz gegen DNS-Rebinding zwischen der Prüfung und der tatsächlichen Verbindung (akzeptiertes Risiko für den Umfang dieses Kandidaten).
Messung (Teil 3 der Einrichtungssitzung)
7-Tage-Fenster ab der ersten echten Bereitstellung. Quelle der Wahrheit: traffic_events/revenue_events/mcp_call_events-
Tabellen (asset_name = 'url-metadata-api'), nicht Cloud-Run-Logs. Tag 7: Wenn kein echter Traffic (nach
Herausfiltern von Crawlern), Cloud-Run-Dienst pausieren/löschen (gcloud run services delete url-metadata-api --region us-central1 --project nexus-505016) und zu Kandidat #3 übergehen.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Free URL metadata extraction API. Extract titles, descriptions, Open Graph tags, and favicons from any URL. No API keys required.
Zero-signup anonymous link-unfurl API. One GET returns clean JSON metadata for any public URL.
Link-preview metadata and clean page-to-Markdown for any public URL. No install.
Same link preview data as link-preview-api, ~1/3 the price via a shared cache.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides functionality to fetch and transform web content in various formats (HTML, JSON, plain text, and Markdown) through simple API calls.117,041 npm1MIT
- AlicenseNot gradedqualityCmaintenancePaste a URL to see exactly how it renders as a social card on Twitter, LinkedIn, Facebook, and Slack. Generate custom OG images from templates.MIT
- AlicenseNot gradedqualityDmaintenanceZero-signup link-preview API that returns clean metadata (title, description, image, etc.) from any public URL. No API key required.2MIT
- AlicenseNot gradedqualityCmaintenanceConverts HTML to plain text, extracts hyperlinks, and pulls page metadata (title, description, Open Graph tags) from HTML content.59 npmMIT