Pagespeed Insights Mcp

Abstract

1. Introduction

Get a free API key at Google Cloud Console → paste into Claude Desktop's claude_desktop_config.json → restart. Done. (Codex/OpenAI config, Docker)

2. Objective

Six-tool MCP server for Google PageSpeed Insights & Chrome UX Report APIs. Analyze, compare, and optimize web performance directly through Claude, Cursor, or any MCP-compatible AI client.

This project demonstrates how TypeScript can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Performance Analysis of web pages using Google PageSpeed Insights
• Multi-platform Support: mobile and desktop devices
• Detailed Lighthouse Reports with comprehensive metrics
• Simplified Reports with key performance indicators
• Smart Recommendations with priority scoring and actionable fixes
• Intelligent Caching to reduce API calls and improve performance
• Localization - support for multiple languages
• Quick Installation - one command setup
• Docker Support for containerized deployment

4. Technology Stack

• Visual Analysis - Screenshots, filmstrip, and full-page captures
• Element-Level Debugging - Find specific DOM elements causing issues
• Network Waterfall - Detailed request timing and resource loading
• JavaScript Profiling - Execution breakdown and unused code detection
• Image Optimization - Specific image issues with exact savings
• Render-Blocking Analysis - Critical request chains and dependencies
• Third-Party Impact - Script impact grouped by provider
• Full Audits - Complete Lighthouse audits for all categories

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/ruslanlap/pagespeed-insights-mcp.git
cd pagespeed-insights-mcp

{
  "mcpServers": {
    "pagespeed-insights": {
      "command": "npx",
      "args": ["-y", "pagespeed-insights-mcp"],
      "env": { "GOOGLE_API_KEY": "your-google-api-key" }
    }
  }
}

# Set environment variable
export GOOGLE_API_KEY=your-google-api-key

curl -sSL https://raw.githubusercontent.com/ruslanlap/pagespeed-insights-mcp/master/scripts/install.sh | bash

curl -sSL https://raw.githubusercontent.com/ruslanlap/pagespeed-insights-mcp/master/scripts/install.sh | \
  PAGESPEED_INSIGHTS_MCP_PACKAGE=@ruslanlap/pagespeed-insights-mcp bash

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by ruslanlap and published on GitHub under the Apache License 2.0. Please follow the license terms and credit the original author when you use or modify this code.