SEO Audit: a beginner's guide
Comprehensive on-page SEO analysis
What an SEO content audit really is, explained without the jargon
An SEO content audit is a systematic review of every page on a website, scored against the things search engines actually use to decide which pages to recommend. Think of it as a health check-up for a website. A consultant who runs one is not poking around randomly — they are working through a defined checklist of technical, on-page, and content-quality signals, page by page, and writing down what is broken, what is mediocre, and what is great. The output is an actionable inventory: keep this page, update that one, merge these two together, delete this one entirely.
You should care because the difference between a website that ranks and one that doesn't is rarely about the writing itself — it is almost always about the dozens of small technical and structural things underneath the writing. A page with great content but a missing title tag, a broken canonical URL, or a 6-second load time will quietly lose to a worse-written competitor that has the basics right. A content audit is how you find every one of those small problems before they cost you traffic.
The five things every SEO content audit looks at:
Indexability and crawlability — can search engines actually find and read this page? This means checking `robots.txt`, the `noindex` meta tag, canonical URLs, internal linking, and the XML sitemap.
On-page elements — title tags, meta descriptions, heading hierarchy (H1, H2, H3), image alt text, internal links, and structured data (schema.org markup that tells Google what a page is about).
Content quality and relevance — is the page actually about what it claims to be about? Is it long enough? Is it unique, or is it duplicating something else on the same site (a problem called "keyword cannibalization")?
Technical performance — how fast does the page load? Are images optimized? Is the page mobile-friendly? These feed directly into Google's Core Web Vitals ranking signals.
Engagement signals — bounce rate, time on page, click-through rate from search results, and external links pointing in.
Three questions a content audit answers:
Why isn't this page ranking, even though I think the writing is good?
Which of my pages is the single biggest "easy fix" — high-traffic potential, currently broken in a small way?
What should I delete, what should I merge, and what should I leave alone?
The cost of skipping an audit is invisible until it isn't. You publish content for years without ever checking the technical foundation, and one day you notice your traffic has been sliding for six months. By then the diagnosis is harder and the fix is bigger. A content audit done quarterly catches problems while they are still cheap to fix, and turns SEO from a black box into a checklist you can actually work through. This is exactly the work that the Backlinko content audit guide, the Screaming Frog audit primer, and every working SEO consultant has been doing for years — just spelled out in plain English.
The SEO Audit endpoint, in plain language
In one sentence: Comprehensive on-page SEO (Search Engine Optimization) analysis
Performs a comprehensive on-page SEO (Search Engine Optimization) audit including title tags, meta descriptions, heading hierarchy, image alt text (alternative text), internal/external links, content quality, Open Graph (Open Graph protocol), and Twitter Card (Twitter (X) sharing metadata) validation.
Don't worry if some of the words above are still unfamiliar — there's a plain-language glossary at the bottom of this page, and most of the terms link to their own beginner guides if you want to learn more.
What is actually happening when you call it
Here's what's actually happening behind the scenes when you call this endpoint:
Fetches the target page and analyzes all on-page SEO (Search Engine Optimization) elements: title tag length and optimization, meta description (meta description tag) quality, heading hierarchy (H1-H6) for proper structure, image alt text (alternative text) coverage, internal and external link ratios, content word count and keyword density, Open Graph (Open Graph protocol) completeness, and Twitter Card (Twitter (X) sharing metadata) validation. Returns a score (0-100), letter grade, and actionable recommendations.
If you're using an AI assistant through MCP, you don't need to understand any of the technical details — the assistant calls the tool and translates the result for you.
Why this specific tool matters
Let's skip the marketing fluff and answer the only question that actually matters: why should you, a real human with a real to-do list, care about the SEO Audit tool? Here's the plain-English version, written the way you'd hear it from a friend who happens to do this for a living.
On-page SEO (Search Engine Optimization) directly impacts search engine rankings and click-through rates. This audit surfaces issues that are invisible to the naked eye — missing alt text (alternative text), duplicate headings, thin content, and incomplete social meta tags — so you can fix them before they hurt rankings.
Picture this in real life. Imagine an SEO specialist. Here's the situation they're walking into: Audit pages across a website to identify SEO (Search Engine Optimization) issues like missing meta descriptions, thin content, or broken heading hierarchy. Without the right tool, that person would be stuck copy-pasting between five browser tabs, reading documentation written for engineers, and crossing their fingers that the answer they cobble together is correct. With the SEO Audit tool, the same person gets a clear answer in seconds — no spreadsheets, no guessing, no waiting for someone on the infrastructure team to free up.
Three questions this tool answers in plain English. If any of these have ever crossed your mind, the SEO Audit tool is built for you:
Are search engines actually able to crawl, understand, and recommend my pages?
What is the single biggest fix I could make today to climb in Google?
How does my site compare against the technical SEO checklist that the top results all pass?
You can either click the tool and get the answer yourself, or ask your AI assistant — connected through MCP (Model Context Protocol) — to ask the question for you and translate the answer into something you can paste into Slack.
Who gets the most out of this. Marketers, content writers, freelancers running client sites, founders trying to grow without paying for ads, and SEO specialists running monthly health checks. If you see yourself in that list, this is one of the EdgeDNS tools you should bookmark today.
What happens if you skip this entirely. Skip it and search engines quietly stop sending you traffic and you don't find out until the next quarterly review. That's why running this check — even once a month — is one of the cheapest forms of insurance you can give your domain.
Available on the developer plan. The technical details: `GET /v1/domain/seo-audit`.
When would I actually use this?
If you're still on the fence about whether the SEO Audit tool belongs in your toolbox, this section is for you. Below you'll meet three real people — an SEO specialist, a content editor, and a content strategist — facing three real situations where this tool turns a stressful afternoon into a five-minute task. Read whichever story sounds closest to your week.
Story 1: Content Audit
Imagine you're an SEO specialist. Audit pages across a website to identify SEO (Search Engine Optimization) issues like missing meta descriptions, thin content, or broken heading hierarchy.
Why it matters: Prioritize fixes by impact to improve organic search rankings.
Story 2: Pre-publish Check
Imagine you're a content editor. Run an SEO (Search Engine Optimization) audit on new pages before publishing to ensure all on-page elements meet standards.
Why it matters: Catch SEO (Search Engine Optimization) issues before search engines index the page.
Story 3: Competitor Page Analysis
Imagine you're a content strategist. Analyze competitor landing pages to understand their on-page optimization strategy.
Why it matters: Identify content gaps and optimization opportunities versus competitors.
Common situations across teams. Beyond the three stories above, here are the everyday workplace moments when people across the company reach for the SEO Audit tool — or one of the tools right next to it in this category. If any of these are on your calendar this month, that's your sign:
Before launching a new page, site, or campaign — to catch the dumb mistakes.
During a quarterly SEO health check.
When organic traffic suddenly drops and you need to find out why.
When pitching a new client and you need an audit deck in under an hour.
If you can see yourself in even one of those bullets, the SEO Audit tool will pay for itself the first time you use it.
Still not sure? Here's the easiest test in the world. Open Claude, ChatGPT, Gemini, or any other AI assistant connected to the EdgeDNS MCP server and ask, in your own words: "Is the SEO Audit tool useful for my job?" The assistant will look at the tool, ask you a couple of follow-up questions about what you're trying to accomplish, and give you a straight answer in plain English. No commitment, no signup forms, no jargon.
The easiest way: just ask your AI assistant
If you've connected the EdgeDNS MCP server to Claude, ChatGPT, Gemini, Cursor, or any other AI assistant, you don't need to write any code. Just ask in plain English:
"Use the SEO Audit tool to check example.com and explain anything that looks wrong in plain language."
The AI will figure out which tool to call, fill in the right parameters, run it, and then explain the result back to you. No copy-pasting between tabs. No reading raw JSON. No memorizing endpoint names.
MCP (Model Context Protocol) access is free on every plan, including the free tier. One API key works for both REST and AI — you do not have to choose.
The technical way: call it from code
If you're a developer and want to call the endpoint from a script or your own application, here's the simplest possible example. Replace the placeholder API key with the real one from your dashboard.
# Replace edns_live_YOUR_KEY with your real API key from the dashboard
curl -H "Authorization: Bearer edns_live_YOUR_KEY" \
"https://api.edgedns.dev/v1/domain/seo-audit?domain=example.com"What you need to provide
There's just one piece of information you need to provide. The table below explains exactly what it is and what a real value looks like.
| Field | Type | Required? | What it means | Example |
|---|---|---|---|---|
domain | string | Yes | The domain to perform the SEO (Search Engine Optimization) audit on | example.com |
What you get back
When you call this tool, you'll get back a JSON object with the fields below. If you're talking to it through an AI assistant, the assistant reads these for you and explains them in plain language — you don't need to memorize them.
| Field | Type | What you'll see in it |
|---|---|---|
domain | string | The audited domain |
title | object | Title tag analysis: text, length, isOptimal, recommendation |
metaDescription | object | Meta description analysis: text, length, isOptimal |
headings | object | Heading hierarchy (H1-H6), proper order, duplicates |
images | object | Image alt text (alternative text) coverage and quality breakdown |
links | object | Internal/external link counts and ratios |
content | object | Word count and top keyword density |
openGraph | object | OG tag completeness and missing tags |
twitterCard | object | Twitter Card (Twitter (X) sharing metadata) completeness and missing tags |
score | number | SEO (Search Engine Optimization) score 0-100 |
grade | string | Letter grade A-F |
gradeDescription | string | Human-readable description of the grade (e.g., "Very Good - strong posture") |
breakdown | object | Per-component score breakdown with max weights: title (18), metaDescription (13), headings (13), content (16), imageAlt (10), links (10), duplicateMeta (5), keywords (5), canonical (4), structuredData (4), hreflang (2) |
recommendations | array | Actionable improvement suggestions |
Words you might be wondering about
If any words on this page felt like jargon, here's a plain-language version. Click any linked term to read a full beginner-friendly guide.
SEO (Search Engine Optimization) — Everything you do to help search engines like Google find, understand, and rank your website.
Open Graph (Open Graph protocol) — A set of meta tags you put in your web pages so that when someone shares your link on Facebook, LinkedIn, or Slack, the right title, image, and description show up.
Twitter Card (Twitter (X) sharing metadata) — The Twitter/X equivalent of Open Graph — meta tags you add to your page so a nice card with a title, image, and description appears when someone tweets your link.
alt text (alternative text) — A short text description you add to every image on your website. Screen readers read it aloud to visitors who can't see the image, and it's also what shows up if the image fails to load.
meta description (meta description tag) — A short summary of a web page that you embed in the page's source code. Search engines often display it under the page title in search results.
Need Programmatic Access?
Automate domain intelligence with 100+ API endpoints and a free MCP server for AI integration.