Files
pitchfast/backlog/tasks/task-9 - Integrate-PageSpeed-Insights-into-internal-audits.md
2026-06-03 21:18:36 +02:00

1.6 KiB

id, title, status, assignee, created_date, labels, dependencies, references, priority, ordinal
id title status assignee created_date labels dependencies references priority ordinal
TASK-9 Integrate PageSpeed Insights into internal audits To Do
2026-06-03 19:13
mvp
audit
pagespeed
TASK-8
PRD.md
medium 9000

Description

Add Google PageSpeed Insights as an objective internal audit signal. The system should run mobile and desktop checks when possible, store raw results internally, and expose only plain-language implications to the later LLM/text pipeline rather than customer-facing scores.

Acceptance Criteria

  • #1 PageSpeed API runs for mobile and desktop strategies for qualified website leads
  • #2 Raw PageSpeed/Lighthouse response data is stored internally in Convex
  • #3 Key metrics are normalized for downstream analysis without exposing scores on customer audit pages
  • #4 Failures, quota errors, and unavailable pages are recorded without failing the entire audit pipeline
  • #5 Generated audit inputs translate technical signals into customer-impact language for later text generation

Implementation Plan

  1. Add PageSpeed API client using environment/Convex secrets.
  2. Run mobile and desktop analysis for the lead domain or final URL.
  3. Normalize key findings such as load speed, mobile/desktop gap, SEO, accessibility, and best-practice hints.
  4. Store raw and normalized results in Convex.
  5. Add error handling and dashboard-visible status for quota, timeout, and API failures.