lighthouse-wrapper

🥇Gold

Lighthouse-wrapper automates performance, accessibility, and SEO testing using Google's Lighthouse. Enhance your web applications by ensuring they meet high standards in user experience and search engine optimization.

1250Updated 2mo ago

Intermediate15 minutes to implementdevelopment

Saves ~60 min per use

Quick InstallView Source

claude install akagupta9/lighthouse-wrapper

Works with:

GitHub Copilot

Overview

About This Skill

Lighthouse-wrapper streamlines web performance and SEO testing by automating Google Lighthouse audits across multiple URLs in a single batch run. Instead of manually checking Lighthouse reports for each page, you define your URLs in a JSON configuration file and execute automated audits that generate organized reports by date and time. The tool outputs detailed performance, accessibility, and SEO metrics for each URL, helping development teams identify optimization opportunities efficiently. It's designed for developers and QA teams who need to monitor multiple web pages against quality standards without repetitive manual testing.

How to Use

Add your URLs and page names to ./resources/data.json, then run `npm run start` from the root directory. Once execution completes, find your generated reports in ./Reports/{date-time-folder}.

Use Cases

Automate SEO audits for web applications

Conduct performance testing for new features

Ensure accessibility compliance in web projects

Generate reports for stakeholders on site performance

Best For

GrowthMarketing

Setup & Installation

Quick Install

Terminal

claude install akagupta9/lighthouse-wrapper

Alternative Install (Git Clone)

git clone https://github.com/akagupta9/lighthouse-wrapper

Requirements

Claude Code or compatible AI agent
Works with: GitHub Copilot

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Run a Lighthouse audit on [WEBSITE_URL] focusing on performance, accessibility, and SEO. Provide a detailed report with actionable recommendations to improve the scores. Include specific metrics like First Contentful Paint, Largest Contentful Paint, and accessibility issues detected.

Example Output

# Lighthouse Audit Report for [WEBSITE_URL]

## Performance
- **First Contentful Paint**: 1.2s (Good)
- **Largest Contentful Paint**: 2.5s (Needs Improvement)
- **Speed Index**: 3.1s (Needs Improvement)
- **Total Blocking Time**: 120ms (Good)
- **Cumulative Layout Shift**: 0.05 (Good)

**Recommendations**:
- Optimize images to reduce Largest Contentful Paint.
- Implement lazy loading for offscreen images.
- Minify CSS and JavaScript files.

## Accessibility
- **Contrast Issues**: 3 elements with insufficient color contrast.
- **Missing Alt Text**: 2 images without alt text.
- **ARIA Attributes**: 1 button missing ARIA label.

**Recommendations**:
- Ensure all images have descriptive alt text.
- Use tools like Color Contrast Analyzer to fix contrast issues.
- Add ARIA labels to interactive elements.

## SEO
- **Meta Description**: Missing or too short.
- **Mobile-Friendly**: Good
- **Viewport**: Good
- **Tap Targets**: 2 elements with small tap targets.

**Recommendations**:
- Write a compelling meta description with 120-160 characters.
- Increase the size of tap targets to at least 48x48 pixels.
- Ensure the viewport meta tag is correctly set.