Monitor Core Web Vitals with Lighthouse, Gemini AI, and Telegram Alerts

This n8n workflow automates the process of monitoring Core Web Vitals for a specified URL using Google Lighthouse, summarizing the results with Google Gemini AI, and sending alerts via Telegram. It also logs the Lighthouse scores to a Google Sheet for historical tracking.

What it does

1. Schedules Checks: Triggers at a set interval (e.g., daily, weekly) to perform web vital checks.
2. Fetches Lighthouse Report: Makes an HTTP request to the Google Lighthouse API to get a performance report for a predefined URL.
3. Extracts Key Metrics: Processes the Lighthouse report to extract crucial Core Web Vitals scores (Performance, Accessibility, Best Practices, SEO).
4. Filters for Low Scores: Checks if any of the extracted scores fall below a predefined threshold (e.g., 90).
5. Summarizes with AI (if needed): If any scores are below the threshold, it uses Google Gemini AI (via a LangChain Summarization Chain) to create a concise summary of the Lighthouse report, highlighting areas for improvement.
6. Sends Telegram Alert: If scores are low, it sends a detailed alert message to a specified Telegram chat, including the URL, the low scores, and the AI-generated summary.
7. Logs to Google Sheets: Appends the current date, URL, and all Lighthouse scores to a Google Sheet for long-term monitoring and analysis, regardless of whether an alert was sent.

Prerequisites/Requirements

• n8n Instance: A running n8n instance.
• Google Lighthouse API Key: Access to the Google Lighthouse API (or a similar service if modified).
• Google Sheets Account: A Google account with access to Google Sheets. You'll need to create a new spreadsheet or specify an existing one.
• Telegram Bot Token: A Telegram Bot API token and the Chat ID where you want to receive alerts.
• Google Gemini AI (LangChain) Credentials: Credentials for Google Gemini AI to be used with the LangChain nodes.

Setup/Usage

1. Import the Workflow: Import the provided JSON into your n8n instance.
2. Configure Credentials:
   • Google Sheets: Set up your Google Sheets credential. You'll need to authorize n8n to access your Google Sheets.
   • Telegram: Set up your Telegram credential with your Bot Token.
   • Google Gemini Chat Model: Configure your Google Gemini AI credentials within the Google Gemini Chat Model node.
3. Customize Nodes:
   • Schedule Trigger (Node 839): Adjust the schedule as needed (e.g., daily, weekly, specific times).
   • HTTP Request (Node 19):
     • Update the URL for which you want to run Lighthouse audits.
     • Ensure the Lighthouse API endpoint and any required API keys are correctly configured.
   • Code (Node 834): This node extracts and formats the data from the Lighthouse report. Review and adjust if the Lighthouse API response structure changes or if you need to extract different metrics.
   • If (Node 20): Modify the conditions to set your desired thresholds for Core Web Vitals (e.g., performance < 90).
   • Summarization Chain (Node 1121): Ensure the prompt for the AI summarization is appropriate for your needs.
   • Telegram (Node 49):
     • Enter the Chat ID where you want the alerts to be sent.
     • Customize the message template to include the information you deem most relevant.
   • Google Sheets (Node 18):
     • Specify the Spreadsheet ID and Sheet Name where the data should be logged.
     • Ensure the column headers in your Google Sheet match the data being sent from the Code node (e.g., Date, URL, Performance, Accessibility, Best Practices, SEO).
4. Activate the Workflow: Once configured, activate the workflow to start monitoring your web vitals.