How to use

URL format: Supply your target domain or path without http:// or https:// (e.g. example.com or example.com/path). www vs. non-www: Some sites only respond on one hostname. If you don’t get results, retry with or without the www. prefix (e.g. www.example.com). This route queries Google PageSpeed Insights v5 (strategy = mobile or desktop) and returns a compact JSON report of the page’s most important performance KPIs plus insight-driven recommendations. fcp: First Contentful Paint (ms) – perceived load start. lcp: Largest Contentful Paint (ms) – primary Core Web Vital for loading. tti: Time to Interactive (ms) – when the page becomes usable. tbt: Total Blocking Time (ms) – JS main-thread bottleneck. cls: Cumulative Layout Shift – visual stability score. speed_index: Average time to display visible content (ms). performance_score: Lighthouse Performance score (0–100). ### Actionable Extras - **`opportunities`** – Up to six Lighthouse “Opportunities”, each with an estimated saving in milliseconds, sorted by impact (e.g. *Eliminate render-blocking resources*). - **`diagnostics`** – Up to ten additional audits scoring < 0.9 that are not classic opportunities (e.g. *Reduce JavaScript execution time*). - **`raw`** – Full PSI JSON payload when `full=true`; otherwise an empty object to keep responses lean. ### How It Works 1. **URL normalisation & safety** – Adds `https://` if omitted and blocks private-network hosts to reduce SSRF risk. 2. **Async HTTP/2 fetch with retries** – Uses `httpx` and exponential back-off (3 attempts) for fast, resilient calls. 3. **Metrics extraction & sorting** – Parses Lighthouse audits, calculates core numbers, ranks opportunities by potential savings, and surfaces low-scoring diagnostics. 4. **Flexible payload size** – Developers can request only the summary or the complete PSI schema for deeper analysis. ### Expected Output (abridged) > { "url": "https://example.com", "fcp": 1350, "lcp": 2450, "tti": 3100, "tbt": 120, "cls": 0.01, "speed_index": 1800, "performance_score": 89, "opportunities": [ { "title": "Reduce unused CSS", "savings_ms": 320 }, { "title": "Serve images in next-gen formats", "savings_ms": 260 } ], "diagnostics": [ "Avoid enormous network payloads", "Ensure text remains visible during webfont load" ], "raw": {} // full Lighthouse JSON if ?full=true } ### Why It’s Valuable - **Complete Core Web Vitals snapshot** in a single request—ideal for dashboards, CI/CD gates, and SLA monitoring. - **Action-oriented** – Opportunities and diagnostics turn raw numbers into a clear to-do list for performance tuning. - **Premium depth** – Adds Speed Index and detailed audit scoring beyond the basic CLS/LCP, giving power users richer insight without extra API calls.