Audit a blog's SEO with a browser
I’m building a Nuxt blog starter called NuxtPapier. Task: I’m building a Nuxt blog starter called NuxtPapier. Like any developer who wants their project to show up in search results, I needed to make sure it works well with search engines. Manual SEO audits take too much time and I often miss things, so I used Claude Code with Puppeteer MCP to do this automatically. What is Claude Code? Claude Code is Anthropic’s official command-line tool that brings AI help right into your coding workflow. Think of it like having a skilled developer sitting next to you, ready to help with any coding task. What makes it really powerful for SEO audits is that it can use MCP (Model Context Protocol) tools. For a deeper look at what Claude Code can do, see my overview of the full Claude Code feature stack. Enter Puppeteer MCP What is MCP? According to Anthropic’s official documentation, the Model Context Protocol (MCP) is “an open standard that enables developers to build secure, two-way connections between their data sources and AI-powered tools.” It provides a universal interface for connecting AI systems with external tools, systems, and data sources, replacing fragmented integrations with a single protocol. MCP lets Claude Code connect with outside tools and services. I was using the Puppeteer MCP server which gives Claude Code the power to: Control a real web browser with code Go to any website Take screenshots Pull data from web pages Check page structure and speed This means Claude Code can visit your website, look at it the same way search engines do, and give you detailed insights. Claude Code CLIPuppeteer MCPReal Browser InstanceYour WebsiteExtract DataSEO AnalysisComprehensive ReportClaude Code SEO Audit Workflow Claude Code CLI Puppeteer MCP Real Browser Instance Your Website Extract Data SEO Analysis Comprehensive Report My SEO Audit Prompt Here’s the exact prompt I used: Simple and direct. It uses Claude Code’s ability to act like an expert while using the Puppeteer tools. Claude Code quickly responded with: “I’ll do a complete SEO audit for your blog, Senpai Alex. Let me start by making a plan and then checking your site using Puppeteer.” The Automated Process One of the coolest things is how Claude Code organizes itself by making todos. It quickly made its own plan: Claude Code’s Self-Generated Todo List: Navigate to the homepage and take screenshots Analyze meta tags and SEO elements Check blog post pages for optimization Evaluate page structure and heading hierarchy Analyze site performance and loading times Check mobile responsiveness Review robots.txt and sitemap availability Document all findings in a markdown report What amazed me was how Claude Code worked through each todo step by step, using Puppeteer to get real data from my site - checking meta tags, measuring how fast pages load, checking structured data, and even taking mobile screenshots. It checked off each item as it finished them. While working, Claude Code told me what it found: “I found a big SEO problem - the robots meta tag says ‘noindex, nofollow’ which stops search engines from finding your site. This is a major issue.” WebsiteBrowserPuppeteerClaude CodeWebsiteBrowserPuppeteerClaude Codeloop[For each SEO check]Generate Todo ListInitialize browser sessionLaunch browserNavigate to pageGo to URLLoad pageReturn contentExtract dataReturn analysis data✓ Mark todocompleteGenerate finalreportAutomated SEO Analysis Process The Report Claude Code created a detailed SEO audit report that I could actually use. It included: Critical Issues: My site had noindex, nofollow meta tags (development setting blocking all search engines!) robots.txt was blocking all crawlers Duplicate H1 tags on blog posts Positive Findings: Proper structured data implementation Good mobile responsiveness Fast page load times (200ms) Clean URL structure What to Fix: Quick fixes with code examples Short-term improvements ranked by importance Long-term improvement plans The report even told me exactly which files to change and what code to fix. Claude Code wrapped up with: “The audit found big blocking problems - search engines can’t see your site because of noindex, nofollow meta tags and development robots.txt settings. But the good news is your blog has great technical basics with proper structured data, mobile-friendly design, and fast loading.”; tools: Claude Code. Human role: The original post does not say how a person stayed involved.; limitations: The source does not specify costs, API limits, or failure rates for the Puppeteer MCP integration. Reliability depends on the correct setup of the MCP server and local development environment. The author did not detail how to handle exceptions if the browser fails to load or if specific SEO elements are missing. Human approval is required before applying any code changes suggested in the report..
Tools
Published on Agent Work Atlas:
Overview
I’m building a Nuxt blog starter called NuxtPapier.
Workflow
I’m building a Nuxt blog starter called NuxtPapier. Like any developer who wants their project to show up in search results, I needed to make sure it works well with search engines. Manual SEO audits take too much time and I often miss things, so I used Claude Code with Puppeteer MCP to do this automatically. What is Claude Code? Claude Code is Anthropic’s official command-line tool that brings AI help right into your coding workflow. Think of it like having a skilled developer sitting next to you, ready to help with any coding task. What makes it really powerful for SEO audits is that it can use MCP (Model Context Protocol) tools. For a deeper look at what Claude Code can do, see my overview of the full Claude Code feature stack. Enter Puppeteer MCP What is MCP? According to Anthropic’s official documentation, the Model Context Protocol (MCP) is “an open standard that enables developers to build secure, two-way connections between their data sources and AI-powered tools.” It provides a universal interface for connecting AI systems with external tools, systems, and data sources, replacing fragmented integrations with a single protocol. MCP lets Claude Code connect with outside tools and services. I was using the Puppeteer MCP server which gives Claude Code the power to: Control a real web browser with code Go to any website Take screenshots Pull data from web pages Check page structure and speed This means Claude Code can visit your website, look at it the same way search engines do, and give you detailed insights. Claude Code CLIPuppeteer MCPReal Browser InstanceYour WebsiteExtract DataSEO AnalysisComprehensive ReportClaude Code SEO Audit Workflow Claude Code CLI Puppeteer MCP Real Browser Instance Your Website Extract Data SEO Analysis Comprehensive Report My SEO Audit Prompt Here’s the exact prompt I used: Simple and direct. It uses Claude Code’s ability to act like an expert while using the Puppeteer tools. Claude Code quickly responded with: “I’ll do a complete SEO audit for your blog, Senpai Alex. Let me start by making a plan and then checking your site using Puppeteer.” The Automated Process One of the coolest things is how Claude Code organizes itself by making todos. It quickly made its own plan: Claude Code’s Self-Generated Todo List: Navigate to the homepage and take screenshots Analyze meta tags and SEO elements Check blog post pages for optimization Evaluate page structure and heading hierarchy Analyze site performance and loading times Check mobile responsiveness Review robots.txt and sitemap availability Document all findings in a markdown report What amazed me was how Claude Code worked through each todo step by step, using Puppeteer to get real data from my site - checking meta tags, measuring how fast pages load, checking structured data, and even taking mobile screenshots. It checked off each item as it finished them. While working, Claude Code told me what it found: “I found a big SEO problem - the robots meta tag says ‘noindex, nofollow’ which stops search engines from finding your site. This is a major issue.” WebsiteBrowserPuppeteerClaude CodeWebsiteBrowserPuppeteerClaude Codeloop[For each SEO check]Generate Todo ListInitialize browser sessionLaunch browserNavigate to pageGo to URLLoad pageReturn contentExtract dataReturn analysis data✓ Mark todocompleteGenerate finalreportAutomated SEO Analysis Process The Report Claude Code created a detailed SEO audit report that I could actually use. It included: Critical Issues: My site had noindex, nofollow meta tags (development setting blocking all search engines!) robots.txt was blocking all crawlers Duplicate H1 tags on blog posts Positive Findings: Proper structured data implementation Good mobile responsiveness Fast page load times (200ms) Clean URL structure What to Fix: Quick fixes with code examples Short-term improvements ranked by importance Long-term improvement plans The report even told me exactly which files to change and what code to fix. Claude Code wrapped up with: “The audit found big blocking problems - search engines can’t see your site because of noindex, nofollow meta tags and development robots.txt settings. But the good news is your blog has great technical basics with proper structured data, mobile-friendly design, and fast loading.”
Reported result
The audit identified critical issues including 'noindex, nofollow' meta tags and a blocking robots.txt file, alongside positive findings like fast load times (200ms) and proper structured data. The author reported that the process was faster than manual audits and produced a usable report with code fixes. No quantitative business impact or post-fix performance metrics were provided.
Human role
The original post does not say how a person stayed involved.
Limitations
The source does not specify costs, API limits, or failure rates for the Puppeteer MCP integration. Reliability depends on the correct setup of the MCP server and local development environment. The author did not detail how to handle exceptions if the browser fails to load or if specific SEO elements are missing. Human approval is required before applying any code changes suggested in the report.
Try it
Act as an SEO specialist using Claude Code with Puppeteer MCP. I am building a Nuxt blog starter called [replaceable: project name]. Please perform a comprehensive SEO audit on my local development server at [replaceable: URL]. Steps: 1. Verify Puppeteer MCP is connected and launch a browser instance. 2. Navigate to the homepage and key blog post pages. 3. Extract and analyze meta tags, heading structures, robots.txt, and sitemap availability. 4. Measure page load times and check mobile responsiveness via screenshots. 5. Generate a markdown report listing critical issues, positive findings, and specific code fixes with file locations. Constraints: - Do not modify any files automatically. - Stop after generating the report and wait for my confirmation before suggesting implementation steps. - If the site is unreachable, report the error immediately. Deliverable: A structured markdown file named 'seo_audit_report.md'. First, run a dry check on just the homepage to confirm the browser connection works, then proceed with the full audit.
Source reports are not independently verified. Publication date is the catalog publication date, not the original article date.