Google PageSpeed Tools

Run Lighthouse audits against any public URL using the Google PageSpeed Insights API. Use these tools in a workflow to measure performance scores, gate deployments on quality thresholds, or collect historical web vitals data.

Overview

Operations

Configuration

google_pagespeed_analyze

Outputs

google_pagespeed_analyze

• data (json) — The full PageSpeed Insights analysis result returned by the Google PageSpeed Insights v5 API. Contains the complete Lighthouse report object including audit scores, metrics, and diagnostics.
• metadata (json) — Compact summary of the analysis:
  • id (string) — The analyzed URL as echoed back by the API.
  • strategy (string) — The form factor / strategy that was used (mobile or desktop).

YAML Example

google_pagespeed_1:
  type: google_pagespeed
  name: "Google PageSpeed"
  inputs:
    operation: "google_pagespeed_analyze"
    url: "https://example.com"
    strategy: "desktop"
    category: "performance"
    apiKey: "{{GOOGLE_PAGESPEED_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Enable the API first — go to Google Cloud Console, create a project, enable the "PageSpeed Insights API", and generate an API key. Store the key as a workflow secret and reference it with {{GOOGLE_PAGESPEED_API_KEY}} rather than hard-coding the value.
• Gate deployments on scores — connect the data output to a Condition block that checks data.lighthouseResult.categories.performance.score against a minimum threshold (e.g. 0.9 for 90+) before allowing a deployment to proceed.
• Compare strategies in parallel — use two Google PageSpeed blocks in parallel branches with strategy: mobile and strategy: desktop to compare scores for the same URL simultaneously, then merge results in a downstream block.