SEO Score: a beginner's guide

An SEO grade — sometimes called an SEO score, an SEO health score, or an SEO letter grade — is a single composite number (or A-to-F letter) that summarizes everything an automated audit found about a website's technical and on-page SEO health. The point of a single grade is to give non-technical stakeholders something they can read in two seconds and understand. "Our SEO grade is a B+, up from a C- last quarter" is a sentence that lands in a board meeting in a way that "our average page Core Web Vitals INP is 187ms" never will.

You should care because SEO is one of those areas where the technical detail overwhelms the people who actually need to make budget decisions about it. A founder, a CMO, or a board member does not need to know the difference between a 301 and a 302 redirect — they need to know whether SEO is a problem worth investing in this quarter. A single letter grade, computed transparently from a defined methodology, is the bridge between the technical detail and the strategic decision. As a bonus, it gives you a number to track over time, which makes the impact of SEO work visible in a way that abstract "we improved a few things" updates do not.

The five categories every SEO grade rolls up:

• Technical SEO — indexability, crawlability, sitemap and robots.txt hygiene, canonical tags, redirect health, structured data validation, mobile-friendliness, HTTPS.

• On-page SEO — title tags, meta descriptions, heading hierarchy, image alt text, internal linking, URL structure.

• Content quality — word count, uniqueness, readability, freshness, keyword relevance, duplicate-content detection.

• Performance and user experience — Core Web Vitals (LCP, INP, CLS), page weight, time-to-first-byte, mobile responsiveness.

• Authority and backlinks — domain authority estimate, total backlinks, referring domains, anchor-text diversity.

Each category gets weighted (technical SEO usually gets more weight than backlinks for sites just starting out, while authority gets more weight as a site matures), and the weighted average becomes the overall grade.

Three questions a single SEO grade answers:

• At a glance, is our SEO health getting better or worse over time?

• Which of the five major categories is dragging us down the most?

• Is the work the agency or the in-house team has been doing actually moving the needle?

The cost of not having a single grade is the slow accumulation of detailed reports that nobody on the leadership team actually reads. The fix is to roll up the existing detail into one number and one letter, computed the same way every time, and tracked on a recurring schedule. This is the difference between SEO being a black box and SEO being a measurable, accountable line item in the marketing budget.

In one sentence: Composite SEO (Search Engine Optimization) score from multiple audits

Returns a composite SEO (Search Engine Optimization) score (0-100) aggregated from 8 weighted components: on-page SEO audit (23%), Core Web Vitals (Google Core Web Vitals) (15%), technical SEO — canonical, indexability, viewport, lang, HTTPS (secure HyperText Transfer Protocol) (20%), structured data — JSON-LD/Schema.org validation (8%), content freshness (5%), content quality — readability, image optimization, link text (15%), link health (10%), and social meta — Open Graph (Open Graph protocol) + Twitter Card (Twitter (X) sharing metadata) (4%). Scoring methodology aligns with Google Lighthouse SEO audit checks and Google Search Essentials guidelines.

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.

Here's what's actually happening behind the scenes when you call this endpoint:

Runs multiple SEO (Search Engine Optimization) audits in parallel and aggregates results. On-page SEO (23% weight) evaluates title tags, meta descriptions, heading hierarchy, image alt text (alternative text), internal/external links, content length, keyword diversity, keyword prominence, and keyword-in-URL. Core Web Vitals (Google Core Web Vitals) (15%) queries Google CrUX for LCP, INP, CLS, TTFB, and FCP. Technical SEO (20%) checks canonical URL (web address) validity, noindex directives (meta robots + X-Robots-Tag), viewport meta tag with mobile-friendliness validation, HTML (HyperText Markup Language) lang attribute, HTTPS (secure HyperText Transfer Protocol), HTTP (HyperText Transfer Protocol) status code, and character encoding. Structured data (8%) parses JSON-LD (JSON (JavaScript Object Notation) for Linked Data) and Microdata for Schema.org types, validates required fields, and checks for high-value types like Organization, WebSite, BreadcrumbList, Article, and Product. Content quality (15%) measures Flesch Reading Ease score, image dimension/lazy-loading optimization, and link text descriptiveness. Content freshness (5%) analyzes Last-Modified headers, JSON-LD dates, and meta tag timestamps. Link health (10%) checks for broken links, redirect chains, and anchor text quality. Social meta (4%) scores Open Graph (Open Graph protocol) and Twitter Card (Twitter (X) sharing metadata) tag completeness. All component scores are normalized to a 0-100 scale. Handles partial failures gracefully — if one component fails, others still contribute.

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.

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 Score 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.

SEO (Search Engine Optimization) involves dozens of factors across technical, content, and off-page categories. A composite score distills this complexity into a single actionable metric for tracking, reporting, and benchmarking. Component breakdowns show exactly where to invest effort. The scoring aligns with official Google Lighthouse SEO audits (14 automated checks) and Google Search Essentials, ensuring the score reflects what actually impacts search rankings.

Picture this in real life. Imagine an SEO manager. Here's the situation they're walking into: Track composite SEO (Search Engine Optimization) scores across all properties in a single dashboard. 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 Score 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 Score 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.

If you're still on the fence about whether the SEO Score tool belongs in your toolbox, this section is for you. Below you'll meet three real people — an SEO manager, a SEO agency, and a web developer — 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: SEO Health Dashboard

Imagine you're an SEO manager. Track composite SEO (Search Engine Optimization) scores across all properties in a single dashboard.

Why it matters: Monitor overall SEO (Search Engine Optimization) health and identify properties needing attention.

Story 2: Client Reporting

Imagine you're an SEO agency. Generate monthly SEO (Search Engine Optimization) score reports for clients showing progress and component breakdown.

Why it matters: Demonstrate ROI of SEO (Search Engine Optimization) services with a clear, trackable metric.

Story 3: Pre-Launch Validation

Imagine you're a web developer. Run an SEO (Search Engine Optimization) score check before launching or updating a website to ensure SEO readiness.

Why it matters: Catch SEO (Search Engine Optimization) issues across all dimensions before they affect rankings.

Common situations across teams. Beyond the three stories above, here are the everyday workplace moments when people across the company reach for the SEO Score 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 Score 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 Score 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.

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 Score 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.

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.

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.

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.

These tools pair naturally with SEO Score. If you're already running this check, the related ones often answer the next question that comes up:

• SEO Audit — Comprehensive on-page SEO analysis

• Core Web Vitals — CrUX metrics with server-side performance analysis

• Link Health — Check broken links and redirect chains

• Search Readiness — Evaluate search engine optimization readiness

If you're using an AI assistant through MCP (Model Context Protocol), you can ask it to run several of these in one go: "Check SEO Score and the related tools for example.com and tell me what looks off."

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.

URL (web address) — The full address of a page, like https://example.com/about.

HTTP (HyperText Transfer Protocol) — The language web browsers and websites use to talk to each other.

HTTPS (secure HyperText Transfer Protocol) — HTTP with encryption — the little padlock in your browser. It means nobody between you and the website can read what you're sending.

SEO (Search Engine Optimization) — Everything you do to help search engines like Google find, understand, and rank your website.

HTML (HyperText Markup Language) — The basic language web pages are written in. The tags you see in the source code (<h1>, <p>, <a>) are HTML.

JSON (JavaScript Object Notation) — A lightweight format for sending data between programs. Looks like { "name": "example", "age": 5 }. Used by basically every modern web API.

JSON-LD (JSON for Linked Data) — A specific flavor of JSON used to embed structured information in web pages, so search engines like Google can understand the content. Example: marking up a recipe with ingredients, cook time, and ratings.

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.

Core Web Vitals (Google Core Web Vitals) — Google's official measurements of how fast and smooth your web pages feel — how quickly content appears, how long the page takes to become interactive, and how stable the layout is. Used as a search ranking signal.