Skip to content
All articles

Run a Next.js SEO audit with your coding assistant

field guide // , 5 min read, by Darthwares

To audit a Next.js site with your coding assistant, connect dotmap's MCP server, audit the public deployment, and ask the assistant to fix a specific finding in the repository. Deploy the change and inspect the response before running another audit. A local code edit, an audit score and Google's indexing decision are separate checkpoints.

Illustration with sample values.
On this page // 4 sections
  1. 01Connect the assistant and choose one deployed site
  2. 02Map the finding to the Next.js implementation
  3. 03Verify the fix after deployment
  4. 04Measure whether the work helped people find the product

The short version

  • Audit the public deployment that search engines can reach, then connect each finding to a route or template.
  • Read the documentation installed with your Next.js version before editing metadata or routing code.
  • Verify the deployed HTML and response status after each change; a successful build is only one check.
  • Use Search Console to confirm indexing and query-page performance separately from audit scores.

Connect the assistant and choose one deployed site

The dotmap connection page provides setup for Claude Code, Cursor and VS Code. Use its current setup instructions, authenticate in your browser, and select a public deployment that you are authorized to audit. The dotmap crawler cannot inspect localhost or a private preview.

For Claude Code, the connection command below registers dotmap's remote MCP server. Cursor and VS Code use their own configuration flows on the connection page. Connecting the tool does not deploy code changes; review the resulting diff as part of your normal development workflow.

Claude Code connection command
claude mcp add --transport http dotmap https://dotmap.ai/mcp
  1. 01Connect and authenticate using the instructions for your assistant on /connect.
  2. 02Ask: Audit my public deployment and list the weakest indexable pages, with their specific issues.
  3. 03Choose one issue shared by a route or template. Ask for a proposed fix and its affected URLs before editing.

Map the finding to the Next.js implementation

For the App Router, inspect the route's metadata export or generateMetadata function, its layouts, and the robots and sitemap conventions. Read the documentation for the installed Next.js version: API details and caching behavior can change. Avoid fixing the same missing canonical by declaring conflicting values in both a parent layout and a child page.

The example below gives a public product route its own title, description and canonical. The absolute origin must come from your deployment's metadataBase or an explicit absolute canonical. It is an implementation example, not a measured ranking improvement.

App Router route metadata; adapt to your installed Next.js version
import type { Metadata } from "next";

export const metadata: Metadata = {
  title: "Website SEO audits and monitoring",
  description: "Check public pages for crawl, metadata and content issues.",
  alternates: { canonical: "https://example.com/product" },
};
FindingRepository area to inspect
Wrong canonical or missing titlePage metadata, generateMetadata and inherited layout metadata
Important page marked noindexRoute metadata and response headers; preserve intentional utility-page exclusions
Page absent from the sitemapSitemap generation, route availability and environment conditions
Related articles do not link to one anotherServer-rendered links and article relationship data

Verify the fix after deployment

Run the checks required by the repository, review the diff, and deploy through its normal release process. Fetch the actual public URL and check the response status, metadata and visible content. Inspect a second page using the same template to catch regressions beyond the original finding.

Prompt for a bounded verification pass
Re-audit the deployed site with the same scope. Compare the affected URLs,
not just the average score. Report the deployed canonical, indexing directive
and remaining issues. Do not claim a Google ranking or indexing improvement
from the audit score alone.

Measure whether the work helped people find the product

Check the individual URL in Search Console after Google recrawls it. Use the crawl date to distinguish an old observation from the current response. Then compare the same query-page pairs over comparable periods, separating brand searches and irrelevant report URLs from searches by prospective customers.

Track audit starts, completed audits and signups alongside organic clicks. A better score is useful diagnostic evidence, but a claim about acquisition needs visitor and conversion measurements. Record the deployment date and keep concurrent changes in mind before attributing a traffic difference to a single fix.

Primary sources and further reading

Prepared with AI-assisted drafting and checked against the primary sources below. These sources support the platform and measurement claims; the examples and recommendations are dotmap analysis, not results reported by the sources.