Google Lighthouse Checker Comprehensive web performance analysis tool powered by Google Lighthouse. Evaluate your website's performance, accessibility, SEO, and best practices with customizable scoring thresholds and multiple output formats. ## Features ### Core Capabilities - Multi-Device Testing: Run audits on mobile, desktop, or both device types simultaneously - Comprehensive Analysis: Evaluate performance, accessibility, best practices, and SEO - Customizable Score Ranges: Define your own thresholds for excellent, good, and poor scores - Multiple Output Formats: Generate results as tables, graphs, and charts - Flexible Timeout Settings: Configure evaluation timeouts from 30 to 300 seconds - Improvement Suggestions: Optional detailed recommendations for performance optimization ### Lighthouse Categories The actor supports four key Lighthouse audit categories: 1. Performance - Page load speed, rendering metrics, and resource optimization 2. Accessibility - WCAG compliance and usability for users with disabilities 3. Best Practices - Modern web development standards and security 4. SEO - Search engine optimization and discoverability ## Input Configuration ### Required Parameters - url (string, required): The URL of the website to audit - Example: https://apify.com ### Optional Parameters - apiKey (string, optional): API key for authentication if required - outputFormats (array, optional): Output format preferences - Options: table, graphs, charts - Default: ["table"] - evaluationTimeoutInSeconds (integer, optional): Maximum time for Lighthouse evaluation - Range: 30-300 seconds - Default: 100 - deviceType (string, optional): Device type for audit simulation - Options: mobile, desktop, both - Default: "desktop" - lighthouseCategories (array, optional): Categories to evaluate - Options: performance, accessibility, best-practices, seo - Default: All categories - includeImprovements (boolean, optional): Include improvement suggestions - Default: false - scoreRanges (object, optional): Custom score thresholds for each category - Each category must have: excellent, good, poor (0-100) - Must satisfy: excellent >= good >= poor - Default ranges: excellent ≥ 90, good ≥ 50, poor ≥ 0 ## Sample Input ### Basic Usage json { "url": "https://example.com", "deviceType": "desktop", "outputFormats": ["table"] } ### Advanced Configuration json { "url": "https://apify.com/ideas/google-lighthouse-checker-44d82046", "apiKey": "", "outputFormats": ["table", "charts", "graphs"], "evaluationTimeoutInSeconds": 100, "deviceType": "desktop", "lighthouseCategories": ["performance", "accessibility", "best-practices", "seo"], "includeImprovements": true, "scoreRanges": { "performance": { "excellent": 90, "good": 50, "poor": 0 }, "accessibility": { "excellent": 90, "good": 50, "poor": 0 }, "best-practices": { "excellent": 90, "good": 50, "poor": 0 }, "seo": { "excellent": 90, "good": 50, "poor": 0 } } } ### Multi-Device Testing json { "url": "https://example.com", "deviceType": "both", "outputFormats": ["table", "graphs"], "lighthouseCategories": ["performance", "seo"] } ### Custom Score Thresholds json { "url": "https://example.com", "deviceType": "mobile", "scoreRanges": { "performance": { "excellent": 95, "good": 70, "poor": 0 }, "accessibility": { "excellent": 100, "good": 80, "poor": 0 } } } ## Output Structure The actor returns a structured output with the following fields: typescript { "success": boolean, "report": string, "message": string, "executionTimeInMs": number } - success: Indicates whether the audit completed successfully - report: Formatted report based on selected output formats - message: Status message or error details - executionTimeInMs: Total execution time of the audit ## Score Interpretation ### Default Score Ranges | Category | Excellent | Good | Poor | |----------|-----------|------|------| | All | ≥ 90 | 50-89 | 0-49 | ### Custom Score Ranges You can customize score thresholds for each category independently. This is useful for: - Setting stricter standards for critical metrics - Adjusting thresholds based on industry benchmarks - Creating custom performance targets aligned with business goals Validation Rules: - All scores must be between 0-100 - excellent must be ≥ good - good must be ≥ poor ## Use Cases ### Web Development - Pre-deployment performance checks - Continuous integration testing - Performance regression detection ### SEO Optimization - Technical SEO audits - Mobile-friendliness testing - Core Web Vitals monitoring ### Accessibility Compliance - WCAG compliance verification - Accessibility issue identification - Regular accessibility audits ### Competitive Analysis - Benchmark against competitors - Industry standard comparison - Performance gap analysis ## Best Practices 1. Timeout Configuration: For complex sites, increase timeout to 150-200 seconds 2. Device Testing: Always test both mobile and desktop for responsive sites 3. Regular Audits: Schedule periodic audits to track performance trends 4. Score Ranges: Adjust thresholds based on your site's baseline performance 5. Categories: Focus on relevant categories for your specific use case ## Error Handling The actor includes robust validation for: - Invalid URLs - Malformed score ranges - Unsupported categories - Timeout issues Invalid configurations are automatically corrected with warnings logged to the console. ## Limitations - Maximum evaluation timeout: 300 seconds - Supported categories: performance, accessibility, best-practices, seo only - Score ranges must follow logical ordering (excellent ≥ good ≥ poor) ## Support For issues, feature requests, or questions: - Check the Apify documentation - Review Lighthouse documentation at web.dev - Contact support through Apify platform ## Version History ### Latest Version - Multi-device testing support - Customizable score ranges - Multiple output format options - Enhanced validation and error handling --- Note: This actor uses Google Lighthouse under the hood. Results may vary based on network conditions, server response times, and other environmental factors. For consistent results, run multiple audits and average the scores.