audit-website-insights

Audit website insights

Get a Lighthouse audit and detected technology stack for a URL via microlink_insights.

Run an audit

Pass insights: true for defaults, or an insights object to configure it:

• Lighthouse only: { "url": "...", "insights": { "lighthouse": true } }
• Technologies only: { "url": "...", "insights": { "technologies": true } }
• Both (default): { "url": "...", "insights": true }

Configure Lighthouse under insights.lighthouse:

• preset: "desktop", "perf", "experimental", "lr-desktop", "lr-mobile", "full", or "default" (mobile). Use "desktop" for desktop-emulated audits.
• onlyCategories: limit the audit to specific categories to run faster, e.g. ["performance", "accessibility"]. Valid IDs: performance, accessibility, best-practices, seo, pwa.
• output: "json" (default), "html", or "csv".

Focused performance-only example:

{
  "url": "https://example.com",
  "insights": {
    "lighthouse": { "preset": "desktop", "onlyCategories": ["performance"] },
    "technologies": true
  }
}

Read the results

• Category scores: microlink.data.insights.lighthouse.categories.<id>.score (0–1; multiply by 100 for the familiar 0–100 score).
• Core Web Vitals & metrics: under microlink.data.insights.lighthouse.audits (e.g. largest-contentful-paint, cumulative-layout-shift, total-blocking-time, first-contentful-paint).
• Tech stack: microlink.data.insights.technologies — an array of detected tools/frameworks (name + categories), e.g. React, Next.js, Cloudflare, GA.

When reporting to the user, translate scores to 0–100, call out the weakest category, and cite the specific failing audits rather than only the headline number.

Tips & gotchas

• Slow tool: a full Lighthouse run takes many seconds. Narrow with onlyCategories and a preset to speed things up when you only need one dimension.
• Timeouts: raise timeout (e.g. "60s") for heavy pages.
• Fresh numbers: audits are cached — pass force: true to re-measure.
• Combine: microlink_extract accepts insights alongside screenshot/meta, so you can grab an audit and a screenshot of the page in one request.
• Free endpoint caps at 50 requests/day; set MICROLINK_API_KEY for more.