steady-auditor

byMaruvada Aasritha Padmini Malayappan

# Website Auditor — Project Brief ## The idea, in one line A tool where someone enters a website URL and gets back a downloadable PDF report — objective performance/SEO/accessibility scores plus an AI-written critique of design and content — with issues mapped to Malayappan Dev's services, so every audit doubles as a soft pitch. ## Why this exists Not as a standalone paid product (this category — HubSpot Website Grader, PageSpeed Insights, GTmetrix — is permanently free from big brands, so charging end users for a report competes against free forever, not free-trial). Instead, it's a **permanent free lead-generation tool**: prospects self-serve a real, useful audit of their own site, see concrete problems in writing, and see Malayappan Dev positioned as the fix — before you ever have to cold-pitch them. ## What it does (pipeline) 1. User submits a URL on malayappan.dev 2. **Objective data**: Google PageSpeed Insights API pulls real Lighthouse scores — performance, SEO, accessibility, best practices 3. **Visual capture**: Puppeteer takes a full-page screenshot and extracts page signals (title, meta description, heading structure, image alt-text coverage) 4. **AI analysis**: Claude receives the scores + screenshot + signals and produces structured output — overall impression, strengths, prioritized issues (category, why it matters in plain language, concrete fix), quick wins, and which Malayappan Dev service would solve each issue 5. **Report generation**: everything renders into a styled HTML report and gets converted to a downloadable PDF 6. **Lead capture**: before the PDF downloads, capture name + email (this is the actual point of the tool — the audit is the value exchange for the lead) ## Tech stack (all things you already know) - **Backend**: Node.js + Express (wraps the audit pipeline as an API route) - **Frontend**: a page on malayappan.dev (TanStack Start / React, matching your existing site) with one URL input, a loading state, and a lead-capture form before download - **AI**: Claude (Anthropic API) for the qualitative critique — you already have API access - **Screenshot/rendering**: Puppeteer (also generates the final PDF via print-to-PDF) - **Data source**: Google PageSpeed Insights API (free, optional API key for higher limits) - **Hosting**: your existing Hostinger VPS (same one running VakilSummons) — needs Chromium installed for Puppeteer ## The revenue-generating mechanism (the actual point) The tool itself doesn't charge anyone. It generates revenue indirectly: - Every issue found gets mapped to a specific Malayappan Dev service (see mapping below) - The PDF report ends with a "How Malayappan Dev Can Help" section listing exactly which services address the found issues, with a contact CTA - Every completed audit = one qualified lead with name + email + a documented reason they need help (their own site's problems, in writing) - Follow up personally with anyone who runs an audit — you already know their pain points before the first call ## Issue → service mapping (customize as your service list grows) | Issue category | Malayappan Dev service to suggest | |---|---| | Performance (slow load, unoptimized images) | Website performance optimization | | SEO (missing meta tags, poor structure) | SEO setup & content structure | | Design/UX (unclear CTA, poor layout, weak trust signals) | Website redesign | | Accessibility (missing alt text, contrast issues) | Accessibility audit & fixes | | Content (outdated info, broken links, no clear value prop) | Content refresh / copywriting | | No booking/WhatsApp automation visible | WhatsApp AI agent for bookings & FAQs (your other product) | ## Guardrails to keep it credible - Keep the AI's tone constructive and specific, never salesy or exaggerated — a report that oversells problems to justify a pitch will read as untrustworthy and undermine the lead-gen goal - Don't gate the *audit itself* — only gate the *download* behind email capture, so the perceived value is "real free tool," not "content marketing trick" - Cap free audits per day/IP to control your Claude + PageSpeed API costs - Be upfront in the UI that this is an automated first-pass audit, not an exhaustive manual review — keeps expectations honest and protects your credibility when you do the real paid work i have my website www.malayappan.dev after creating this agent it should be integrated into my website