SEO Audit Studio: a free web app that turns claude-seo audits into branded, multilingual PDF reports

[nordkite]

Hi everyone 👋

I use claude-seo for client audits, and the slow part was always what came after the audit: turning the findings into a branded PDF the client can read, in their language. So I built a free, open-source web app on top of claude-seo for that, and I'm sharing it in case it helps someone else.

Repo: https://github.com/nordkite/seo-audit-studio (MIT)

How it works

It's a local web app called SEO Audit Studio. You do everything in the browser:

1. New report: paste a URL, choose Whole site or Single page, then click Start audit. claude-seo runs in the background and the progress shows in the top bar.
2. Edit the findings: drag them between severities, rewrite text, add your own sections with screenshots, and watch a live preview of the PDF.
3. Translate the report with one click. English, Estonian and Russian work out of the box, and each language is edited side by side with the English. If you change the English later, the Studio marks which translations are out of date.
4. Render PDF gives you a client-ready report with your agency's name, logo, colors and font. Even the PDF metadata uses your brand, so the tool's name doesn't appear anywhere in the file.

What it adds to claude-seo's coverage

claude-seo does the auditing, and the app adds a few checks that claude-seo 2.4.2 doesn't run as part of an audit:

• Hreflang validation on multilingual sites. seo-audit never calls seo-hreflang, and seo-page only checks that the tags exist, not reciprocity or x-default.
• Image audit (file sizes, formats, alt text, lazy loading) on the homepage plus up to 4 page templates. seo-audit has no image subagent.
• Social tags: Open Graph and X/Twitter Cards on every URL in the sitemap. claude-seo never checks twitter:image, and without it X shows shared links with no picture even when og:image is set.
• Lighthouse / PageSpeed numbers on every report, even without Google API credentials. Out of the box, claude-seo only measures Core Web Vitals when credentials are set up.
• Fuller single-page audits. seo-page is a single checklist, so the app also runs the technical, content, schema, performance, visual, GEO, agentic and SXO subagents on that one URL.

It's also strict about coverage. If a check didn't run, the report lists it under "Not covered" rather than quietly showing a pass. Each addition is documented with the gap it fills, and gets removed once claude-seo covers that gap itself.

Google data (optional)

If you've connected Google through claude-seo (/seo google setup), the report puts the data to use:

• Search Console: a section with the last 28 days of clicks, impressions, CTR and average position, plus the top 10 queries.
• Core Web Vitals: real-user CrUX data when it's available, otherwise a Lighthouse lab run. The report always says which one it is, because the two aren't interchangeable.
• Lighthouse scores appear on every report, even without any Google setup.
• GA4 isn't in the report yet.

The report's Method section shows which data sources were used and why any were missing. For client sites, the client just adds your service account to their Search Console property as a Restricted user.

Its own PDF, not claude-seo's

This is not claude-seo's built-in PDF report with a new logo. The app saves the findings as structured JSON and has its own renderer: an HTML/CSS print template turned into a PDF with headless Chrome (Puppeteer) and pdf-lib. So you get a different report: a branded cover, a findings overview, severity-grouped findings with evidence, metrics, your own custom sections, and a separate "Not covered" list. Because the data and the layout are kept apart, the same audit can be rendered in any language without re-running it.

Getting started

You need Node 22.18+ and Claude Code, installed and logged in. The app uses your Claude Code login to run audits.

git clone https://github.com/nordkite/seo-audit-studio
cd seo-audit-studio
npm run setup     # installs everything, including claude-seo
npm run studio    # opens http://127.0.0.1:4321

Let me know if you have any questions or ideas for the improvements.