Frequently Asked Questions
Everything you need to know about website performance monitoring with LighthouseRobot.
Why PageSpeed Matters
Why should I care about website speed?
Website speed directly impacts your business success. Studies show that 53% of mobile users abandon sites that take longer than 3 seconds to load. Every second of delay can reduce conversions by up to 7%.
Beyond user experience, Google uses page speed as a ranking factor. Faster websites rank higher in search results, leading to more organic traffic and visibility.
How does PageSpeed affect SEO?
Google has confirmed that page speed is a ranking factor for both desktop and mobile searches. The Core Web Vitals – which measure loading, interactivity, and visual stability – are part of Google's page experience signals.
Sites that perform poorly may be penalized in search rankings, while fast, well-optimized sites get a competitive advantage.
Lighthouse vs PageSpeed Insights
What is Google Lighthouse?
Google Lighthouse is an open-source, automated tool developed by Google to audit web pages. It runs directly in your browser (built into Chrome DevTools) or via command line, and generates a report on how well your page performs.
Lighthouse tests your page in a simulated environment and measures things like loading speed, accessibility, SEO basics, and adherence to web development best practices.
What is PageSpeed Insights?
PageSpeed Insights (PSI) is Google's web-based tool that uses Lighthouse under the hood. When you enter a URL on pagespeed.web.dev, Google runs a Lighthouse audit on their servers and returns the results.
The key difference: PSI also includes real-world data from the Chrome User Experience Report (CrUX), showing how actual visitors experience your site. Lighthouse alone only provides lab data from simulated tests.
Which one does LighthouseRobot use?
LighthouseRobot uses the official PageSpeed Insights API, which means you get the same Lighthouse scores you'd see on pagespeed.web.dev – but automated and tracked over time.
I chose the PSI API because it's reliable, free, and runs tests from Google's infrastructure rather than requiring my own testing servers. This keeps the service simple and the results consistent.
Understanding the Four Scores
What is the Performance score?
The Performance score measures how fast your page loads and becomes interactive. It's based on several metrics including:
- First Contentful Paint (FCP) – When the first content appears
- Largest Contentful Paint (LCP) – When the main content is visible
- Total Blocking Time (TBT) – How long the page is unresponsive
- Cumulative Layout Shift (CLS) – Visual stability during loading
- Speed Index – How quickly content is visually displayed
This is often the most volatile score as it depends on server response times, network conditions, and resource optimization.
What is the Accessibility score?
The Accessibility score measures how usable your site is for people with disabilities. It checks for common issues like:
- Missing alt text on images
- Insufficient color contrast
- Missing form labels
- Incorrect heading hierarchy
- Missing ARIA attributes
- Keyboard navigation issues
A high accessibility score means your site is usable by more people and may also be legally required in many jurisdictions.
What is the Best Practices score?
The Best Practices score checks whether your site follows modern web development standards and security practices:
- Using HTTPS
- Avoiding deprecated APIs
- No browser errors in the console
- Correct image aspect ratios
- Proper charset declaration
- Safe use of JavaScript
This score helps ensure your site is secure, reliable, and future-proof.
What is the SEO score?
The SEO score checks basic search engine optimization factors that help your pages get discovered:
- Valid meta descriptions and titles
- Crawlable links
- Valid robots.txt
- Legible font sizes
- Proper use of hreflang tags
- Valid structured data
Note: This checks technical SEO basics, not content quality or backlinks.
What do the score colors mean?
LighthouseRobot uses Google's official color thresholds:
- Red (0-49) – Poor. Needs significant improvement.
- Yellow (50-89) – Needs improvement. Room for optimization.
- Green (90-100) – Good. Meets best practices.
How LighthouseRobot Works
How does LighthouseRobot collect data?
LighthouseRobot uses Google's official PageSpeed Insights API to audit your websites. When an audit runs, I make three separate API calls and take the median score for each metric.
This "median-run strategy" significantly reduces score variability. A single Lighthouse test can vary by 10-15 points for the same page; taking the median reduces this to approximately 3 points.
How often are sites audited?
All monitored sites are audited automatically every 8 hours – that's 3 times per day. Each audit runs 3 tests and takes the median score for stability, meaning 9 API calls per URL per day.
What is the Total Score?
The Total Score displayed on LighthouseRobot is a simple average of all four Lighthouse scores (Performance + Accessibility + Best Practices + SEO) divided by 4.
This gives you a quick at-a-glance indicator of your overall website health, while the individual scores show you exactly where to focus improvements.
Why do my scores fluctuate?
Lighthouse scores – especially Performance – can vary between runs due to:
- Server response time variations
- Network conditions
- Third-party scripts loading differently
- CDN cache states
- A/B tests or dynamic content
LighthouseRobot uses daily averages and median-run scoring to smooth out these fluctuations and give you meaningful trend data.
Desktop or mobile testing?
Currently, LighthouseRobot tests all sites using desktop settings. Desktop testing provides more stable and consistent scores.
Mobile testing with simulated throttling might be added in the future.
Using the Dashboard
What is a Leaderboard?
A Leaderboard is a collection of websites you want to compare. Your sites are automatically ranked by their Total Score, creating a competitive view of your portfolio's performance.
Each account can have one leaderboard with up to 10 monitored sites.
What does the Monitor detail page show?
The Monitor detail page shows comprehensive data for a single website:
- Current scores (daily average)
- Historical score chart showing trends over time
- Core Web Vitals with visual range indicators
- Resource overview (total requests, page size)
- Individual audit history
- Quick actions like running a new audit or sharing
This view helps you track how your optimization efforts impact scores over time.
What are Core Web Vitals?
Core Web Vitals are Google's key metrics for measuring real-world user experience. LighthouseRobot displays these on each monitor's detail page with visual range bars showing where your site falls:
- Largest Contentful Paint (LCP) – How fast the main content loads. Good: under 2.5s
- First Contentful Paint (FCP) – When the first content appears. Good: under 1.8s
- Cumulative Layout Shift (CLS) – Visual stability during loading. Good: under 0.1
- Total Blocking Time (TBT) – How long the page is unresponsive. Good: under 200ms
These metrics directly impact your Google search rankings and user experience.
How do share links work?
You can generate public share links for both your leaderboards and individual monitors. Anyone with the link can view the shared content without needing an account.
This is perfect for sharing performance reports with clients, posting comparisons on social media, embedding in presentations, or showcasing your optimization work.
Can I embed my scores on my website?
Yes! When you enable sharing for a monitor, you get an embeddable SVG badge that shows all four Lighthouse scores as visual rings. The badge updates automatically with your latest scores.
Simply copy the HTML code from the Share modal and paste it into your website. The badge uses the official Lighthouse colors (green/orange/red) and links back to your public share page.
This is great for showing visitors that you care about performance, or for adding a trust signal to your portfolio.
Is my data private?
Yes, by default all your data is private. Only you can see your dashboard, monitors, and audit history when logged in.
Share links are opt-in – you decide what to make public. You can deactivate share links at any time.
AI Assistant Integration (MCP)
What is MCP?
MCP (Model Context Protocol) is an open standard that allows AI assistants like Claude to connect to external data sources. LighthouseRobot provides an MCP server that lets you query your performance data directly from your AI assistant.
Instead of logging into the dashboard, you can simply ask: "How is my website performing?" or "What should I optimize on example.com?" and get instant answers.
Which AI assistants are supported?
LighthouseRobot's MCP server works with any MCP-compatible client, including:
- Claude Desktop – Anthropic's desktop app for macOS and Windows
- Cursor – The AI-powered code editor
- Other MCP clients – Any tool that supports the MCP protocol
ChatGPT integration via OAuth is planned for the future.
What can I ask my AI assistant?
Once connected, you can ask questions like:
- "Show me my dashboard overview"
- "List all my monitored websites"
- "How is example.com performing?"
- "What should I optimize on my website?"
- "Generate a performance report for the last 7 days"
- "Which websites improved or declined this week?"
- "Show me the ranking history for my site"
The AI can provide actionable improvement suggestions based on your PageSpeed data.
What tools are available?
The MCP server provides these tools:
- get_dashboard – Overview with average scores across all monitors
- list_monitors – All monitored websites with current scores
- get_monitor – Detailed data including Core Web Vitals
- get_improvement_suggestions – Actionable optimization tips from PageSpeed
- get_performance_report – Trend analysis over 7/14/30/90 days
- get_ranking_history – How your ranking changed over time
- get_winners_losers – Best and worst performers in your portfolio
How do I generate an API token?
To connect your AI assistant, you need an API token:
- Log into your LighthouseRobot account
- Go to Account Settings → API Tokens
- Click "Generate New Token"
- Give it a name (e.g., "Claude Desktop")
- Copy the token immediately – it won't be shown again!
Keep your token secure. Anyone with the token can access your LighthouseRobot data.
How do I connect Claude Desktop?
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"lighthouserobot": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://lighthouserobot.com/api/mcp",
"--header",
"Authorization: Bearer YOUR_API_TOKEN"
]
}
}
}Config file location:
- macOS:
~/.config/claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
After saving, restart Claude Desktop. You should see LighthouseRobot in your available tools.
How do I connect Cursor?
Create a file called .cursor/mcp.json in your project folder:
{
"mcpServers": {
"lighthouserobot": {
"url": "https://lighthouserobot.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}Restart Cursor after adding the configuration.
Is the MCP connection secure?
Yes. All communication happens over HTTPS, and your API token is hashed (SHA-256) before being stored in the database – we never store the plain token.
You can revoke tokens at any time from your Account Settings, and create separate tokens for different devices or applications.
About This Project
Who is behind LighthouseRobot?
Just me! LighthouseRobot is a personal side project. I built it because I wanted a simple way to track Lighthouse scores for multiple websites without running manual tests all the time.
There's no company, no team, no investors – just one person who enjoys building useful tools.
Is LighthouseRobot free?
Yes, completely free. No credit card required, no trial period, no hidden costs. I built this for myself and decided to share it. Enjoy!
What are the current limits?
Each account includes:
- 1 leaderboard
- Up to 10 monitored websites
- Daily automated audits (every 24 hours)
- Unlimited share links
- Full audit history
Start Monitoring Your Sites
Create your free dashboard and track performance in seconds.
Get Started — Free