Imam-Abubakar/ultimate-seo

- **Canonical origin** — the production URL (`https://www.example.com`). Look in env files, deploy configs (`vercel.json`, `netlify.toml`, `CNAME`, `wrangler.toml`), README, existing metadata.

- **Built output** (best for static/SSG): build the project, then `python3 <skill-dir>/scripts/seo_audit.py <build-dir>` (e.g. `dist`, `out`, `build`, `.output/public`, `public`, `_site`). - **Running server** (best for SSR/SPAs): start the

- **Running server** (best for SSR/SPAs): start the dev or preview server and run `python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50`. The audit fetches raw HTML without executing JavaScript, which is exactly what so

2. Re-run `seo_audit.py` the same way as the baseline and compare the score and issue list. 3. Validate JSON-LD: `python3 <skill-dir>/scripts/validate_jsonld.py <build-dir-or-url-or-file>`. 4. Spot-check the rendered HTML of the home page a

3. Validate JSON-LD: `python3 <skill-dir>/scripts/validate_jsonld.py <build-dir-or-url-or-file>`. 4. Spot-check the rendered HTML of the home page and one dynamic page (`curl -s URL | head -80` or open the built file): title, description, c

4. Spot-check the rendered HTML of the home page and one dynamic page (`curl -s URL | head -80` or open the built file): title, description, canonical, OG tags, JSON-LD present and absolute URLs correct.

- **"Just audit my site"** — run phases 1–3 without changing code, then write `ULTIMATE-SEO.md` in audit form: replace *Scorecard*'s before/after with the current score, turn *What was implemented* into *What's wrong* (each finding with its

- **A single concern** ("add a sitemap", "fix OG images") — do that thing excellently using the relevant reference, check its neighbours (a sitemap is useless if robots blocks the URLs), and skip the full playbook unless asked; mention the 

- **Live URL with no repo** — run `seo_audit.py https://site --crawl 100` and `validate_jsonld.py https://site`, then produce `ULTIMATE-SEO.md` as an audit + roadmap.

> Generated by the ultimate-seo Claude skill on {{YYYY-MM-DD}} for `{{https://www.example.com}}` ({{framework + version}}, {{rendering mode}}).

| What | Where | Current value | |---|---|---| | Production origin | `{{.env.production → NEXT_PUBLIC_SITE_URL}}` | {{`https://www.example.com` (placeholder)}} |

|---|---|---| | Production origin | `{{.env.production → NEXT_PUBLIC_SITE_URL}}` | {{`https://www.example.com` (placeholder)}} | | Social profiles for `sameAs` | `{{src/config/site.ts}}` | {{empty}} |

| Production origin | `{{.env.production → NEXT_PUBLIC_SITE_URL}}` | {{`https://www.example.com` (placeholder)}} |

- [ ] **Google Search Console** — add a *Domain* property for `{{example.com}}` (DNS TXT record), then submit `{{https://www.example.com/sitemap.xml}}` under *Sitemaps*.

- [ ] **Bing Webmaster Tools** — import the site from Search Console (one click); submit the sitemap. Bing also feeds Copilot and other AI search tools. - [ ] **Redirects** — make sure `{{http://}}` and `{{apex/www variant}}` 301 to `{{http

- [ ] **Redirects** — make sure `{{http://}}` and `{{apex/www variant}}` 301 to `{{https://www.example.com}}` at the host/CDN ({{Vercel → Domains}}).

- [ ] **Validate** — run 3 key URLs through the [Rich Results Test](https://search.google.com/test/rich-results) and [PageSpeed Insights](https://pagespeed.web.dev/) after deploy.

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"@type": "BlogPosting",   "@id": "https://www.example.com/blog/post-slug/#article",   "mainEntityOfPage": "https://www.example.com/blog/post-slug/",

"@id": "https://www.example.com/blog/post-slug/#article",

"mainEntityOfPage": "https://www.example.com/blog/post-slug/",

"description": "The post's meta description.",   "image": [     "https://www.example.com/blog/post-slug/cover-1200x675.jpg"

"image": [     "https://www.example.com/blog/post-slug/cover-1200x675.jpg"   ],

"https://www.example.com/blog/post-slug/cover-1200x675.jpg"

"@type": "Person",     "name": "Author Name",     "url": "https://www.example.com/authors/author-name/"

"name": "Author Name",     "url": "https://www.example.com/authors/author-name/"   },

"url": "https://www.example.com/authors/author-name/"

},   "publisher": {     "@id": "https://www.example.com/#organization"

"publisher": {     "@id": "https://www.example.com/#organization"   },

"@id": "https://www.example.com/#organization"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"position": 1,       "name": "Home",       "item": "https://www.example.com/"

"name": "Home",       "item": "https://www.example.com/"     },

"item": "https://www.example.com/"

"position": 2,       "name": "Blog",       "item": "https://www.example.com/blog/"

"name": "Blog",       "item": "https://www.example.com/blog/"     },

"item": "https://www.example.com/blog/"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"startDate": "2026-11-20T18:00:00-05:00",   "endDate": "2026-11-20T21:00:00-05:00",   "eventStatus": "https://schema.org/EventScheduled",

"endDate": "2026-11-20T21:00:00-05:00",   "eventStatus": "https://schema.org/EventScheduled",   "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",

"eventStatus": "https://schema.org/EventScheduled",

"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",

},   "image": [     "https://www.example.com/events/event-cover.jpg"

"image": [     "https://www.example.com/events/event-cover.jpg"   ],

"https://www.example.com/events/event-cover.jpg"

"offers": {     "@type": "Offer",     "url": "https://www.example.com/events/event-slug/",

"@type": "Offer",     "url": "https://www.example.com/events/event-slug/",     "price": "25.00",

"url": "https://www.example.com/events/event-slug/",

"price": "25.00",     "priceCurrency": "USD",     "availability": "https://schema.org/InStock",

"priceCurrency": "USD",     "availability": "https://schema.org/InStock",     "validFrom": "2026-09-01T00:00:00-05:00"

"availability": "https://schema.org/InStock",

"@type": "Organization",     "name": "Example Brand",     "url": "https://www.example.com/"

"name": "Example Brand",     "url": "https://www.example.com/"   }

"url": "https://www.example.com/"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"@type": "LocalBusiness",   "@id": "https://www.example.com/#business",   "name": "Business name",

"@id": "https://www.example.com/#business",

"name": "Business name",   "url": "https://www.example.com/",   "image": "https://www.example.com/images/storefront.jpg",

"url": "https://www.example.com/",

"image": "https://www.example.com/images/storefront.jpg",

],   "sameAs": [     "https://www.facebook.com/example",

"sameAs": [     "https://www.facebook.com/example",     "https://www.instagram.com/example"

"https://www.facebook.com/example",

"https://www.instagram.com/example"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

{       "@type": "Organization",       "@id": "https://www.example.com/#organization",

"@type": "Organization",       "@id": "https://www.example.com/#organization",       "name": "Example Brand",

"@id": "https://www.example.com/#organization",

"name": "Example Brand",       "url": "https://www.example.com/",       "logo": {

"url": "https://www.example.com/",

"logo": {         "@type": "ImageObject",         "url": "https://www.example.com/logo-512.png",

"@type": "ImageObject",         "url": "https://www.example.com/logo-512.png",         "width": 512,

"url": "https://www.example.com/logo-512.png",

"description": "One sentence describing what the organization does.",       "sameAs": [         "https://www.linkedin.com/company/example",

"sameAs": [         "https://www.linkedin.com/company/example",         "https://github.com/example",

"https://www.linkedin.com/company/example",

"https://github.com/example",

"https://x.com/example"

{       "@type": "WebSite",       "@id": "https://www.example.com/#website",

"@type": "WebSite",       "@id": "https://www.example.com/#website",       "name": "Example Brand",

"@id": "https://www.example.com/#website",

"name": "Example Brand",       "url": "https://www.example.com/",       "inLanguage": "en",

"url": "https://www.example.com/",

"inLanguage": "en",       "publisher": {         "@id": "https://www.example.com/#organization"

"publisher": {         "@id": "https://www.example.com/#organization"       }

"@id": "https://www.example.com/#organization"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"mainEntity": {     "@type": "Person",     "@id": "https://www.example.com/#person",

"@type": "Person",     "@id": "https://www.example.com/#person",     "name": "Full Name",

"@id": "https://www.example.com/#person",

"name": "Full Name",     "url": "https://www.example.com/",     "jobTitle": "Role",

"url": "https://www.example.com/",

"jobTitle": "Role",     "image": "https://www.example.com/images/headshot.jpg",     "description": "One-line bio.",

"image": "https://www.example.com/images/headshot.jpg",

"description": "One-line bio.",     "sameAs": [       "https://www.linkedin.com/in/example",

"sameAs": [       "https://www.linkedin.com/in/example",       "https://github.com/example"

"https://www.linkedin.com/in/example",

"https://github.com/example"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"@type": "Product",   "@id": "https://www.example.com/products/sku-123/#product",   "name": "Product name",

"@id": "https://www.example.com/products/sku-123/#product",

"description": "Product description as shown on the page.",   "image": [     "https://www.example.com/images/sku-123-1x1.jpg",

"image": [     "https://www.example.com/images/sku-123-1x1.jpg",     "https://www.example.com/images/sku-123-4x3.jpg",

"https://www.example.com/images/sku-123-1x1.jpg",

"https://www.example.com/images/sku-123-4x3.jpg",

"https://www.example.com/images/sku-123-16x9.jpg"

"offers": {     "@type": "Offer",     "url": "https://www.example.com/products/sku-123/",

"@type": "Offer",     "url": "https://www.example.com/products/sku-123/",     "price": "49.00",

"url": "https://www.example.com/products/sku-123/",

"price": "49.00",     "priceCurrency": "USD",     "availability": "https://schema.org/InStock",

"priceCurrency": "USD",     "availability": "https://schema.org/InStock",     "itemCondition": "https://schema.org/NewCondition",

"availability": "https://schema.org/InStock",

"itemCondition": "https://schema.org/NewCondition",

"@type": "MerchantReturnPolicy",       "applicableCountry": "US",       "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",

"applicableCountry": "US",       "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",       "merchantReturnDays": 30,

"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",

"merchantReturnDays": 30,       "returnMethod": "https://schema.org/ReturnByMail",       "returnFees": "https://schema.org/FreeReturn"

"returnMethod": "https://schema.org/ReturnByMail",

"returnFees": "https://schema.org/FreeReturn"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"@type": "SoftwareApplication",   "name": "App name",   "url": "https://www.example.com/",

"name": "App name",   "url": "https://www.example.com/",   "applicationCategory": "BusinessApplication",

"url": "https://www.example.com/",

},   "publisher": {     "@id": "https://www.example.com/#organization"

"publisher": {     "@id": "https://www.example.com/#organization"   },

"@id": "https://www.example.com/#organization"

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"description": "What the video covers.",   "thumbnailUrl": [     "https://www.example.com/videos/thumb-1280x720.jpg"

"thumbnailUrl": [     "https://www.example.com/videos/thumb-1280x720.jpg"   ],

"https://www.example.com/videos/thumb-1280x720.jpg"

"uploadDate": "2026-04-01T08:00:00+00:00",   "duration": "PT4M30S",   "contentUrl": "https://www.example.com/videos/video.mp4",

"duration": "PT4M30S",   "contentUrl": "https://www.example.com/videos/video.mp4",   "embedUrl": "https://www.youtube.com/embed/VIDEO_ID"

"contentUrl": "https://www.example.com/videos/video.mp4",

"embedUrl": "https://www.youtube.com/embed/VIDEO_ID"

- [Home](https://www.example.com/): what the product does, in one line

- [Pricing](https://www.example.com/pricing): plans and what's included

- [Features](https://www.example.com/features): the main capabilities

- [Getting started](https://www.example.com/docs/getting-started): set up in five minutes

- [API reference](https://www.example.com/docs/api): endpoints and authentication

- [About](https://www.example.com/about): team, mission and history

- [Contact](https://www.example.com/contact): support and sales channels

- [Blog](https://www.example.com/blog): announcements and guides

- [Changelog](https://www.example.com/changelog): release history

# robots.txt — template from the ultimate-seo skill. # Replace https://www.example.com with the production origin, and adjust the

# Replace https://www.example.com with the production origin, and adjust the

Sitemap: https://www.example.com/sitemap.xml

Executable file

Executable file

#!/usr/bin/env bash

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

app/layout.tsx exports metadata with metadataBase built from https://www.jamiecodes.dev (directly or via an env var/config with that fallback) and a title template.

#!/usr/bin/env bash

hey, i've got a little nextjs blog (app router) that i'm about to launch at https://www.jamiecodes.dev. can you sort out all the SEO stuff properly? i want it to actually show up on google

index.html, menu.html and contact.html each have a unique title and meta description, an absolute canonical on https://rosasbakerypdx.com (with or without www, consistently), html lang, viewport and Open Graph tags.

#!/usr/bin/env bash

Executable file

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="6" fill="#0e7c66"/></svg>

Executable file

<nav>         <Link to="/">Tidyhive</Link> <Link to="/features">Features</Link> <Link to="/pricing">Pricing</Link> <Link to="/about">About</Link>         <span onClick={() => (window.location.href = "https://app.tidyhive.com/signup")}>Start

<Link to="/">Tidyhive</Link> <Link to="/features">Features</Link> <Link to="/pricing">Pricing</Link> <Link to="/about">About</Link>         <span onClick={() => (window.location.href = "https://app.tidyhive.com/signup")}>Start free trial</s

<span onClick={() => (window.location.href = "https://app.tidyhive.com/signup")}>Start free trial</span>

Executable file

Executable file

Executable file

Executable file

Executable file

Executable file

public/robots.txt (or a generated equivalent) and a sitemap listing https://tidyhive.com routes exist, with robots.txt referencing the absolute sitemap URL.

#!/usr/bin/env bash

We're launching Tidyhive (scheduling software for cleaning companies) next week. The marketing site is this Vite + React app with react-router. Our SEO person says Google "can't see" our pages and link previews on LinkedIn and Slack are bla

Sitemap: https://www.example.com/sitemap.xml

Sitemap: https://www.example.com/sitemap.xml

- **Google**: `nosnippet`, `max-snippet:N`, and `data-nosnippet` apply to AI Overviews/AI Mode as well as classic snippets. `noindex` removes the page entirely. - **Bing/Copilot**: `<meta name="robots" content="nocache">` limits Copilot to 

- **Bing/Copilot**: `<meta name="robots" content="nocache">` limits Copilot to titles/URLs/snippets; `noarchive` excludes content from Copilot answers. Verify against current docs: https://blogs.bing.com/webmaster

## Product - [Features](https://www.example.com/features): Invoicing, recurring billing, reminders, multi-currency

- [Features](https://www.example.com/features): Invoicing, recurring billing, reminders, multi-currency

- [Pricing](https://www.example.com/pricing): Plans and limits

## Docs - [Getting started](https://www.example.com/docs/getting-started.md): Create your first invoice in 5 minutes

- [Getting started](https://www.example.com/docs/getting-started.md): Create your first invoice in 5 minutes

- [API reference](https://www.example.com/docs/api.md): REST API for invoices and clients

## Optional - [Blog](https://www.example.com/blog): Guides on freelancing finances

- [Blog](https://www.example.com/blog): Guides on freelancing finances

- SSR/SSG/prerender all public content. - Main content, headings, and key facts in HTML — not in images, canvases, or tabs loaded on click. - Test: `curl -A "GPTBot" -s https://site/page | sed 's/<[^>]*>//g' | grep -c "your key phrase"`.

- Main content, headings, and key facts in HTML — not in images, canvases, or tabs loaded on click. - Test: `curl -A "GPTBot" -s https://site/page | sed 's/<[^>]*>//g' | grep -c "your key phrase"`. - Don't block AI crawlers by accident with

- Test: `curl -A "GPTBot" -s https://site/page | sed 's/<[^>]*>//g' | grep -c "your key phrase"`.

Verify against current docs: https://developers.google.com/search/docs/essentials/spam-policies and https://developers.google.com/search/docs/fundamentals/creating-helpful-content

For blogs, news, changelogs, podcasts: - Provide an RSS 2.0 or Atom feed with full or summary content, absolute URLs, `pubDate`/`updated`. - Advertise it: `<link rel="alternate" type="application/rss+xml" title="Site Blog" href="https://exa

- Provide an RSS 2.0 or Atom feed with full or summary content, absolute URLs, `pubDate`/`updated`. - Advertise it: `<link rel="alternate" type="application/rss+xml" title="Site Blog" href="https://example.com/rss.xml">`. - Feeds help disco

- Advertise it: `<link rel="alternate" type="application/rss+xml" title="Site Blog" href="https://example.com/rss.xml">`.

Google has two product experiences: **product snippets** (review stars/price in organic results) and **merchant listings** (Shopping tab, product knowledge panels, free listings) — merchant listings require offer details. Reference: https:/

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"@type": "Product",   "@id": "https://example.com/products/nimbus-26#product",   "name": "Nimbus 26 Women's Running Shoe",

"@id": "https://example.com/products/nimbus-26#product",

"brand": { "@type": "Brand", "name": "Example Brand" },   "image": [     "https://example.com/img/nimbus-26-1x1.jpg",

"image": [     "https://example.com/img/nimbus-26-1x1.jpg",     "https://example.com/img/nimbus-26-4x3.jpg",

"https://example.com/img/nimbus-26-1x1.jpg",

"https://example.com/img/nimbus-26-4x3.jpg",

"https://example.com/img/nimbus-26-16x9.jpg"

"offers": {     "@type": "Offer",     "url": "https://example.com/products/nimbus-26",

"@type": "Offer",     "url": "https://example.com/products/nimbus-26",     "priceCurrency": "USD",

"url": "https://example.com/products/nimbus-26",

"price": "159.99",     "priceValidUntil": "2026-12-31",     "availability": "https://schema.org/InStock",

"priceValidUntil": "2026-12-31",     "availability": "https://schema.org/InStock",     "itemCondition": "https://schema.org/NewCondition",

"availability": "https://schema.org/InStock",

"itemCondition": "https://schema.org/NewCondition",

"@type": "MerchantReturnPolicy",       "applicableCountry": "US",       "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",

"applicableCountry": "US",       "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",       "merchantReturnDays": 30,

"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",

"merchantReturnDays": 30,       "returnMethod": "https://schema.org/ReturnByMail",       "returnFees": "https://schema.org/FreeReturn"

"returnMethod": "https://schema.org/ReturnByMail",

"returnFees": "https://schema.org/FreeReturn"

- `availability` must match what the page shows and what Merchant Center feeds say. - Use GTIN/MPN/brand when they exist — they strengthen product matching. - Store-wide shipping and return policies can also be declared once at the organiza

- Use GTIN/MPN/brand when they exist — they strengthen product matching. - Store-wide shipping and return policies can also be declared once at the organization level (`Organization` → `hasMerchantReturnPolicy`, and shipping policy support 

- Store-wide shipping and return policies can also be declared once at the organization level (`Organization` → `hasMerchantReturnPolicy`, and shipping policy support in Organization markup) and/or in Merchant Center; page-level markup over

- Variants: Google supports `ProductGroup` with `hasVariant` and `variesBy` (size, color...) — use it when variants share a page. Reference: https://developers.google.com/search/docs/appearance/structured-data/product-variants

- Sale prices: use `priceSpecification` with `UnitPriceSpecification` and `priceType` `https://schema.org/StrikethroughPrice` for the original price (verify current docs).

Human tasks for the playbook: 1. Create a Merchant Center account (https://merchants.google.com), verify and claim the website.

1. Create a Merchant Center account (https://merchants.google.com), verify and claim the website.

- Block crawling of parameter patterns in `robots.txt` when crawl volume is a problem (e.g. `Disallow: /*?*sort=`, `Disallow: /*?*price=`). Don't combine robots.txt blocking with expecting `noindex` to be seen. 3. Keep consistent parameter 

4. Google's guidance (verify against current docs): https://developers.google.com/search/docs/crawling-indexing/crawling-managing-faceted-navigation

export const SITE = {   name: "Acme",   url: "https://www.example.com", // replaced per environment via fileReplacements, or read from environment.ts

name: "Acme",   url: "https://www.example.com", // replaced per environment via fileReplacements, or read from environment.ts   description: "Acme helps small teams ship invoices in minutes.",

url: "https://www.example.com", // replaced per environment via fileReplacements, or read from environment.ts

const p = this.post();       this.seo.set({ title: p.title, description: p.excerpt, path: `/blog/${p.slug}`, type: "article",         jsonLd: { "@context": "https://schema.org", "@type": "BlogPosting", headline: p.title, datePublished: p.pu

this.seo.set({ title: p.title, description: p.excerpt, path: `/blog/${p.slug}`, type: "article",         jsonLd: { "@context": "https://schema.org", "@type": "BlogPosting", headline: p.title, datePublished: p.publishedAt } });     });

jsonLd: { "@context": "https://schema.org", "@type": "BlogPosting", headline: p.title, datePublished: p.publishedAt } });

- `public/robots.txt`, `public/llms.txt`, icons and `manifest.webmanifest` (templates in `assets/`). Ensure `angular.json` `assets` includes them (default `public/**` in 17+). - Sitemap: after `ng build`, run `python3 <skill-dir>/scripts/ge

- Sitemap: after `ng build`, run `python3 <skill-dir>/scripts/generate_sitemap.py dist/<app>/browser --base-url https://www.example.com` for prerendered output, or add a postbuild Node script that reads the same slug source used by `getPrer

python3 <skill-dir>/scripts/seo_audit.py dist/<app>/browser npm run serve:ssr:<app> &                      # SSR server, usually :4000 python3 <skill-dir>/scripts/seo_audit.py http://localhost:4000 --crawl 50

npm run serve:ssr:<app> &                      # SSR server, usually :4000 python3 <skill-dir>/scripts/seo_audit.py http://localhost:4000 --crawl 50 curl -s http://localhost:4000/pricing | grep -iE "<title>|canonical|og:title"

python3 <skill-dir>/scripts/seo_audit.py http://localhost:4000 --crawl 50 curl -s http://localhost:4000/pricing | grep -iE "<title>|canonical|og:title" curl -s -o /dev/null -w "%{http_code}\n" http://localhost:4000/nope   # 404

curl -s http://localhost:4000/pricing | grep -iE "<title>|canonical|og:title"

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:4000/nope   # 404

export default defineConfig({   site: process.env.SITE_URL ?? "https://www.example.com",

site: process.env.SITE_URL ?? "https://www.example.com",

const url = new URL(Astro.url.pathname, Astro.site); const jsonLd = {   "@context": "https://schema.org",

const jsonLd = {   "@context": "https://schema.org",   "@type": "BlogPosting",

"@context": "https://schema.org",

SITE_URL=https://www.example.com npx astro build

ls dist/sitemap-index.xml dist/robots.txt dist/og/ npx astro preview &   # :4321 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:4321/nope   # 404

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:4321/nope   # 404

Mostly UI configuration — put click-paths in the playbook: - Site settings → SEO: auto-generate sitemap on, robots.txt content, canonical tag URL (set to `https://www.example.com`), redirects (301 table).

- Site settings → SEO: auto-generate sitemap on, robots.txt content, canonical tag URL (set to `https://www.example.com`), redirects (301 table).

python3 <skill-dir>/scripts/seo_audit.py https://www.example.com --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py https://www.example.com/ curl -s https://www.example.com/robots.txt

python3 <skill-dir>/scripts/validate_jsonld.py https://www.example.com/ curl -s https://www.example.com/robots.txt curl -s https://www.example.com/sitemap.xml | head        # WP core: /wp-sitemap.xml ; Yoast/Rank Math: /sitemap_index.xml

curl -s https://www.example.com/robots.txt

curl -s https://www.example.com/sitemap.xml | head        # WP core: /wp-sitemap.xml ; Yoast/Rank Math: /sitemap_index.xml

curl -s https://www.example.com/ | grep -c 'og:title'     # expect 1

Shopify theme dev: `shopify theme dev` then audit `http://127.0.0.1:9292`. WordPress local (wp-env/LocalWP): audit the local URL.

titleTemplate: "%s | Acme",     description: "Acme helps small teams ship invoices in minutes.",     siteUrl: (process.env.SITE_URL || "https://www.example.com").replace(/\/$/, ""),

description: "Acme helps small teams ship invoices in minutes.",     siteUrl: (process.env.SITE_URL || "https://www.example.com").replace(/\/$/, ""),     image: "/og.png",

siteUrl: (process.env.SITE_URL || "https://www.example.com").replace(/\/$/, ""),

<Seo title={post.frontmatter!.title!} description={post.excerpt!} pathname={location.pathname} article>       <script type="application/ld+json">{JSON.stringify({         "@context": "https://schema.org",

<script type="application/ld+json">{JSON.stringify({         "@context": "https://schema.org",         "@type": "BlogPosting",

"@context": "https://schema.org",

SITE_URL=https://www.example.com npx gatsby build

ls public/sitemap-index.xml public/robots.txt public/manifest.webmanifest npx gatsby serve &   # :9000 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9000/nope   # 404

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9000/nope   # 404

export const siteConfig = {   name: "Acme",   url: (process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000").replace(/\/$/, ""),

name: "Acme",   url: (process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000").replace(/\/$/, ""),   description: "Acme helps small teams ship invoices in minutes.",

url: (process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000").replace(/\/$/, ""),

On Vercel, `VERCEL_PROJECT_PRODUCTION_URL` (no protocol) is available at build time; a common fallback is `process.env.NEXT_PUBLIC_SITE_URL ?? (process.env.VERCEL_PROJECT_PRODUCTION_URL ? \`https://${process.env.VERCEL_PROJECT_PRODUCTION_UR

- File-based images automatically emit `og:image`, `og:image:width/height/type/alt`, with absolute URLs via `metadataBase`. Add `twitter-image.tsx` or re-export: `export { default, alt, size, contentType } from "./opengraph-image";`. - Sato

- Satori supports flexbox and a CSS subset only; every multi-child `div` needs `display: "flex"`. Load custom fonts with `fetch(new URL("./Inter-Bold.ttf", import.meta.url)).then(r => r.arrayBuffer())` (edge) or `readFile` (node) and pass `

npm run build                       # metadata errors and missing metadataBase warnings appear here npm run start &                     # or: npx next start -p 3000 python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50

npm run start &                     # or: npx next start -p 3000 python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/

python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/robots.txt; curl -s http://localhost:3000/sitemap.xml | head -40

python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/robots.txt; curl -s http://localhost:3000/sitemap.xml | head -40 curl -sI http://localhost:3000/opengraph-image | head -5

curl -s http://localhost:3000/robots.txt; curl -s http://localhost:3000/sitemap.xml | head -40

curl -sI http://localhost:3000/opengraph-image | head -5

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/definitely-missing   # expect 404

export const siteConfig = {   name: "Acme",   url: (process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000").replace(/\/$/, ""),

name: "Acme",   url: (process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000").replace(/\/$/, ""),   description: "Acme helps small teams ship invoices in minutes.",

url: (process.env.NEXT_PUBLIC_SITE_URL ?? "http://localhost:3000").replace(/\/$/, ""),

<Seo title={post.title} description={post.excerpt} path={path} type="article" image={`/api/og?title=${encodeURIComponent(post.title)}`} publishedTime={post.publishedAt} modifiedTime={post.updatedAt} />       <JsonLd data={{         "@contex

<JsonLd data={{         "@context": "https://schema.org", "@type": "BlogPosting",         headline: post.title, description: post.excerpt, url: absoluteUrl(path),

"@context": "https://schema.org", "@type": "BlogPosting",

/** @type {import('next-sitemap').IConfig} */ module.exports = {   siteUrl: process.env.NEXT_PUBLIC_SITE_URL || "https://www.example.com",

module.exports = {   siteUrl: process.env.NEXT_PUBLIC_SITE_URL || "https://www.example.com",   generateRobotsTxt: true,

siteUrl: process.env.NEXT_PUBLIC_SITE_URL || "https://www.example.com",

];   const xml = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

const xml = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> ${urls.map((u) => `  <url><loc>${esc(siteConfig.url + u.loc)}</loc>${u.lastmod ? `<lastmod>${u.lastmod}</lastmod>` : ""}</url>`

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

npm run build && npm run start & python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50

python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/sitemap.xml | head -30; curl -s http://localhost:3000/robots.txt

python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/sitemap.xml | head -30; curl -s http://localhost:3000/robots.txt curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/blog/does-no

curl -s http://localhost:3000/sitemap.xml | head -30; curl -s http://localhost:3000/robots.txt

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/blog/does-not-exist   # 404

modules: ['@nuxtjs/seo'],   site: {     url: 'https://www.example.com', // overridden by NUXT_PUBLIC_SITE_URL / NUXT_SITE_URL

site: {     url: 'https://www.example.com', // overridden by NUXT_PUBLIC_SITE_URL / NUXT_SITE_URL     name: 'Example',

url: 'https://www.example.com', // overridden by NUXT_PUBLIC_SITE_URL / NUXT_SITE_URL

setHeader(event, 'content-type', 'application/xml; charset=utf-8')   return `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

return `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> ${urls.map((u) => `  <url><loc>${new URL(u.loc, site).href}</loc>${u.lastmod ? `<lastmod>${u.lastmod}</lastmod>` : ''}</url>`).join(

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

name: 'Example',     logo: '/logo.png',     sameAs: ['https://github.com/example'], // only real profiles

logo: '/logo.png',     sameAs: ['https://github.com/example'], // only real profiles   },

sameAs: ['https://github.com/example'], // only real profiles

npx nuxi build && node .output/server/index.mjs &   # or: npx nuxi generate && npx serve .output/public python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50

python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/robots.txt; curl -s http://localhost:3000/sitemap.xml | head -20

python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/robots.txt; curl -s http://localhost:3000/sitemap.xml | head -20 curl -s -o /dev/null -w '%{http_code}\n' http://localhost:3000/definitely-n

curl -s http://localhost:3000/robots.txt; curl -s http://localhost:3000/sitemap.xml | head -20

curl -s -o /dev/null -w '%{http_code}\n' http://localhost:3000/definitely-not-a-page   # expect 404

export const siteConfig = {   name: "Acme",   url: (process.env.SITE_URL ?? "http://localhost:5173").replace(/\/$/, ""),

name: "Acme",   url: (process.env.SITE_URL ?? "http://localhost:5173").replace(/\/$/, ""),   description: "Acme helps small teams ship invoices in minutes.",

url: (process.env.SITE_URL ?? "http://localhost:5173").replace(/\/$/, ""),

{       "script:ld+json": {         "@context": "https://schema.org",

"script:ld+json": {         "@context": "https://schema.org",         "@type": "BlogPosting",

"@context": "https://schema.org",

];   const body = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

const body = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> ${urls.map((u) => `  <url><loc>${esc(siteConfig.url + u.loc)}</loc>${u.lastmod ? `<lastmod>${u.lastmod}</lastmod>` : ""}</url>

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

npm run build && npm run start &     # react-router-serve ./build/server/index.js (port 3000) python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50

python3 <skill-dir>/scripts/seo_audit.py http://localhost:3000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/sitemap.xml | head -20

python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:3000/ curl -s http://localhost:3000/sitemap.xml | head -20 curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/does-not-exist   # 404

curl -s http://localhost:3000/sitemap.xml | head -20

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/does-not-exist   # 404

export const siteConfig = {   name: "Acme",   url: (import.meta.env.VITE_SITE_URL ?? "https://www.example.com").replace(/\/$/, ""),

name: "Acme",   url: (import.meta.env.VITE_SITE_URL ?? "https://www.example.com").replace(/\/$/, ""),   description: "Acme helps small teams ship invoices in minutes.",

url: (import.meta.env.VITE_SITE_URL ?? "https://www.example.com").replace(/\/$/, ""),

// scripts/generate-sitemap.mjs  — run after vite build: "build": "vite build && node scripts/generate-sitemap.mjs" import { writeFileSync } from "node:fs"; const SITE = (process.env.VITE_SITE_URL || "https://www.example.com").replace(/\/$/

import { writeFileSync } from "node:fs"; const SITE = (process.env.VITE_SITE_URL || "https://www.example.com").replace(/\/$/, ""); const routes = ["/", "/pricing", "/about", "/blog"]; // import from your routes/data if possible

const SITE = (process.env.VITE_SITE_URL || "https://www.example.com").replace(/\/$/, "");

// const posts = JSON.parse(readFileSync("src/content/posts.json", "utf8")); routes.push(...posts.map(p => `/blog/${p.slug}`)); const xml = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

const xml = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> ${routes.map((r) => `  <url><loc>${SITE}${r}</loc></url>`).join("\n")}

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

npm run build && npx vite preview --port 4173 & # Raw HTML is what scrapers see — this is the important check for SPAs: curl -s http://localhost:4173/pricing | grep -iE "<title>|og:title|canonical|<h1"

# Raw HTML is what scrapers see — this is the important check for SPAs: curl -s http://localhost:4173/pricing | grep -iE "<title>|og:title|canonical|<h1" python3 <skill-dir>/scripts/seo_audit.py dist                 # prerendered files

curl -s http://localhost:4173/pricing | grep -iE "<title>|og:title|canonical|<h1"

python3 <skill-dir>/scripts/seo_audit.py dist                 # prerendered files python3 <skill-dir>/scripts/seo_audit.py http://localhost:4173 --crawl 30 python3 <skill-dir>/scripts/validate_jsonld.py dist

python3 <skill-dir>/scripts/seo_audit.py http://localhost:4173 --crawl 30 python3 <skill-dir>/scripts/validate_jsonld.py dist curl -s -o /dev/null -w "%{http_code}\n" http://localhost:4173/nope   # vite preview returns 200 (SPA fallback) — 

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:4173/nope   # vite preview returns 200 (SPA fallback) — check host config separately

[Credential-related source omitted]

[Credential-related source omitted]

`config/application.rb`: `config.x.site_url = ENV.fetch("SITE_URL", "https://www.example.com")`, `config.x.site_name = "Example"`. Set `config.action_controller.asset_host`/`default_url_options[:host]` so `image_url` is absolute and correct

SitemapGenerator::Sitemap.default_host = ENV.fetch("SITE_URL")

# start the app locally (examples) python manage.py runserver 8000 | bin/rails s -p 3000 | php artisan serve | node server.js | go run . | dotnet run python3 <skill-dir>/scripts/seo_audit.py http://localhost:8000 --crawl 50

python manage.py runserver 8000 | bin/rails s -p 3000 | php artisan serve | node server.js | go run . | dotnet run python3 <skill-dir>/scripts/seo_audit.py http://localhost:8000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http

python3 <skill-dir>/scripts/seo_audit.py http://localhost:8000 --crawl 50 python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:8000/ curl -s http://localhost:8000/robots.txt; curl -s http://localhost:8000/sitemap.xml | head

python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:8000/ curl -s http://localhost:8000/robots.txt; curl -s http://localhost:8000/sitemap.xml | head curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8000/blog/does-not-ex

curl -s http://localhost:8000/robots.txt; curl -s http://localhost:8000/sitemap.xml | head

curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8000/blog/does-not-exist   # 404

- Canonicals built from `request.host` / `request.build_absolute_uri()` behind a proxy → `http://` or internal hostnames. Use the configured `SITE_URL`. - Debug/staging environments indexable: add `X-Robots-Tag: noindex` header (middleware)

<title>Handmade Oak Desks, Built to Order · Example Studio</title>   <meta name="description" content="Solid oak desks made to your measurements in Portland. Free design consult, 8-week build, lifetime joinery warranty.">   <link rel="canon

<link rel="canonical" href="https://www.example.com/desks/">

<meta property="og:title" content="Handmade Oak Desks, Built to Order">   <meta property="og:description" content="Solid oak desks made to your measurements in Portland.">   <meta property="og:url" content="https://www.example.com/desks/">

<meta property="og:description" content="Solid oak desks made to your measurements in Portland.">   <meta property="og:url" content="https://www.example.com/desks/">   <meta property="og:image" content="https://www.example.com/og/desks.png"

<meta property="og:url" content="https://www.example.com/desks/">

<meta property="og:image" content="https://www.example.com/og/desks.png">

<script type="application/ld+json">   {     "@context": "https://schema.org",

{     "@context": "https://schema.org",     "@type": "BreadcrumbList",

"@context": "https://schema.org",

"@type": "BreadcrumbList",     "itemListElement": [       { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },

"itemListElement": [       { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },       { "@type": "ListItem", "position": 2, "name": "Desks", "item": "https://www.example.com/desks/" }

{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },

{ "@type": "ListItem", "position": 2, "name": "Desks", "item": "https://www.example.com/desks/" }

Sitemap: https://www.example.com/sitemap.xml

python3 <skill-dir>/scripts/generate_sitemap.py . --base-url https://www.example.com --lastmod git

<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

<url><loc>https://www.example.com/</loc><lastmod>2026-10-01</lastmod></url>

<url><loc>https://www.example.com/desks/</loc><lastmod>2026-09-14</lastmod></url>

| Cloudflare Pages | `404.html` | `_redirects` file | | Apache | `ErrorDocument 404 /404.html` | `.htaccess` `Redirect 301 /old /new` or `RewriteRule` for host canonicalization | | Nginx | `error_page 404 /404.html;` | `return 301 https://w

| Nginx | `error_page 404 /404.html;` | `return 301 https://www.example.com$request_uri;` server block |

Home page: `Organization` (or `LocalBusiness`/`Person`) + `WebSite` from `assets/jsonld/`. Inner pages: `BreadcrumbList` + the page's type. Keep the `@id` of the organization stable (`https://www.example.com/#organization`) and reference it

python3 <skill-dir>/scripts/validate_jsonld.py . python3 -m http.server 8080 &  # then: curl -sI http://localhost:8080/robots.txt

curl -sI http://localhost:8080/robots.txt

After deploy: `curl -sI https://example.com/` should 301 to the canonical host; `curl -s -o /dev/null -w '%{http_code}' https://www.example.com/nope` → `404`.

baseURL = "https://www.example.com/"

# _config.yml url: "https://www.example.com"   # no trailing slash

url: "https://www.example.com"   # no trailing slash

name: Example   links:     - https://github.com/example

links:     - https://github.com/example plugins:

- https://github.com/example

// _data/site.js export default {   url: process.env.SITE_URL || 'https://www.example.com',

export default {   url: process.env.SITE_URL || 'https://www.example.com',   name: 'Example',

url: process.env.SITE_URL || 'https://www.example.com',

--- <?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> {%- for p in collections.all %}{% if not p.data.noindex and not p.data.eleventyExcludeFromCollections %}

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

// docusaurus.config.ts const config = {   url: 'https://docs.example.com',

const config = {   url: 'https://docs.example.com',   baseUrl: '/',

url: 'https://docs.example.com',

headTags: [     { tagName: 'script', attributes: { type: 'application/ld+json' },       innerHTML: JSON.stringify({ '@context': 'https://schema.org', '@type': 'Organization', name: 'Example', url: 'https://example.com', logo: 'https://docs.

{ tagName: 'script', attributes: { type: 'application/ld+json' },       innerHTML: JSON.stringify({ '@context': 'https://schema.org', '@type': 'Organization', name: 'Example', url: 'https://example.com', logo: 'https://docs.example.com/img/

innerHTML: JSON.stringify({ '@context': 'https://schema.org', '@type': 'Organization', name: 'Example', url: 'https://example.com', logo: 'https://docs.example.com/img/logo.png' }) },

// .vitepress/config.mts import { defineConfig } from 'vitepress' const SITE = 'https://docs.example.com'

const SITE = 'https://docs.example.com'

# mkdocs.yml site_name: Example Docs site_url: https://docs.example.com/     # required for sitemap + canonical

site_name: Example Docs site_url: https://docs.example.com/     # required for sitemap + canonical site_description: Default description, ~150 chars.

site_url: https://docs.example.com/     # required for sitemap + canonical

social:     - icon: fontawesome/brands/github       link: https://github.com/example

link: https://github.com/example

export const site = {   url: (PUBLIC_SITE_URL || 'https://www.example.com').replace(/\/$/, ''),

url: (PUBLIC_SITE_URL || 'https://www.example.com').replace(/\/$/, ''),

type="article"   jsonLd={{     '@context': 'https://schema.org',

jsonLd={{     '@context': 'https://schema.org',     '@type': 'BlogPosting',

'@context': 'https://schema.org',

];   const xml = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

const xml = `<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> ${urls.map((u) => `  <url><loc>${xmlEscape(u.loc)}</loc>${u.lastmod ? `<lastmod>${u.lastmod}</lastmod>` : ''}</url>`).join('\n'

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

npm run build && npm run preview -- --port 4173 & python3 <skill-dir>/scripts/seo_audit.py http://localhost:4173 --crawl 50

python3 <skill-dir>/scripts/seo_audit.py http://localhost:4173 --crawl 50

# adapter-static output: python3 <skill-dir>/scripts/seo_audit.py build python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:4173/

python3 <skill-dir>/scripts/seo_audit.py build python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:4173/ curl -s http://localhost:4173/robots.txt; curl -s http://localhost:4173/sitemap.xml | head

python3 <skill-dir>/scripts/validate_jsonld.py http://localhost:4173/ curl -s http://localhost:4173/robots.txt; curl -s http://localhost:4173/sitemap.xml | head curl -s -o /dev/null -w '%{http_code}\n' http://localhost:4173/nope   # expect 

curl -s http://localhost:4173/robots.txt; curl -s http://localhost:4173/sitemap.xml | head

curl -s -o /dev/null -w '%{http_code}\n' http://localhost:4173/nope   # expect 404

- Pick whether the default locale gets a prefix (`/en/`) or lives at root (`/`). Either works; be consistent and make `x-default` point at the right place. - Keep the locale segment first: `/de/produkte/...`, not `/produkte/de/...`. - Googl

- Google Search Console's International Targeting report was retired; geo-targeting comes from ccTLD, hreflang, local content signals (currency, address, language), and links. Verify against current docs: https://developers.google.com/searc

<link rel="alternate" hreflang="en" href="https://example.com/en/pricing" />

<link rel="alternate" hreflang="de" href="https://example.com/de/preise" />

<link rel="alternate" hreflang="fr" href="https://example.com/fr/tarifs" />

<link rel="alternate" hreflang="x-default" href="https://example.com/en/pricing" />

Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",

<https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"

xmlns:xhtml="http://www.w3.org/1999/xhtml">

<url>     <loc>https://example.com/en/pricing</loc>     <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing"/>

<loc>https://example.com/en/pricing</loc>

<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing"/>

<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise"/>

<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/pricing"/>

</url>   <url>     <loc>https://example.com/de/preise</loc>

<url>     <loc>https://example.com/de/preise</loc>     <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing"/>

<loc>https://example.com/de/preise</loc>

<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/pricing"/>

<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise"/>

<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/pricing"/>

Reference: https://developers.google.com/search/docs/specialty/international/localized-versions (verify against current docs).

- [ ] Redirects from any old URLs (see §8). - [ ] Unique titles/descriptions on key templates; OG images render (test with a social debugger). - [ ] Structured data validates (`validate_jsonld.py`, Rich Results Test https://search.google.co

- [ ] Unique titles/descriptions on key templates; OG images render (test with a social debugger). - [ ] Structured data validates (`validate_jsonld.py`, Rich Results Test https://search.google.com/test/rich-results, Schema Markup Validator

- [ ] Structured data validates (`validate_jsonld.py`, Rich Results Test https://search.google.com/test/rich-results, Schema Markup Validator https://validator.schema.org).

https://search.google.com/search-console

https://www.bing.com/webmasters

**IndexNow** (https://www.indexnow.org): a protocol to instantly notify participating search engines (Bing, Yandex, Seznam, Naver and others; Google does **not** participate as of this writing — verify against current docs) when URLs are ad

1. Generate a key; host it at `https://example.com/{key}.txt` containing the key.

curl -X POST "https://api.indexnow.org/indexnow" \

-d '{"host":"example.com","key":"YOUR_KEY","keyLocation":"https://example.com/YOUR_KEY.txt","urlList":["https://example.com/new-page"]}'

- **Errors**: Sentry or equivalent for client/server errors (broken rendering = broken SEO). - **Real-user performance**: CrUX (via PageSpeed Insights / GSC CWV report / CrUX dashboard), `web-vitals` library sending to analytics, Vercel Spe

- **Real-user performance**: CrUX (via PageSpeed Insights / GSC CWV report / CrUX dashboard), `web-vitals` library sending to analytics, Vercel Speed Insights, Cloudflare Web Analytics, DebugBear, SpeedCurve. - **Change detection for SEO-cr

- **Change detection for SEO-critical files**: alert if `robots.txt` changes or a `noindex` appears on key pages (ContentKing/Conductor Monitoring, Little Warden, or a simple CI/cron check: `curl -s https://example.com/robots.txt | grep -q 

- Revisit keyword map and roadmap; update ULTIMATE-SEO.md. - Review robots.txt AI-crawler policy against new bots/policies. - Check Google Search Central blog for core updates and policy changes: https://developers.google.com/search/blog an

- Check Google Search Central blog for core updates and policy changes: https://developers.google.com/search/blog and Google Search Status Dashboard https://status.search.google.com

Google's stated factors (verify against current docs: https://support.google.com/business/answer/7091):

Setup: 1. Claim/create at https://business.google.com. Verify (video, phone, email, or postcard — Google chooses).

1. Claim/create at https://business.google.com. Verify (video, phone, email, or postcard — Google chooses).

Use the most specific subtype of `LocalBusiness` (`Dentist`, `Restaurant`, `Plumber`, `AutoRepair`, `LegalService`, `MedicalClinic`, `HairSalon`, `RealEstateAgent`, etc. — see https://schema.org/LocalBusiness#subtypes). Place on the home pa

{   "@context": "https://schema.org",

"@context": "https://schema.org",

"@type": "Plumber",   "@id": "https://example.com/#business",   "name": "Example Plumbing Co.",

"@id": "https://example.com/#business",

"name": "Example Plumbing Co.",   "url": "https://example.com/",   "logo": "https://example.com/logo.png",

"url": "https://example.com/",

"logo": "https://example.com/logo.png",

"image": ["https://example.com/images/storefront.jpg"],

],   "sameAs": [     "https://www.facebook.com/exampleplumbing",

"sameAs": [     "https://www.facebook.com/exampleplumbing",     "https://www.yelp.com/biz/example-plumbing-austin"

"https://www.facebook.com/exampleplumbing",

"https://www.yelp.com/biz/example-plumbing-austin"

Reference: https://developers.google.com/search/docs/appearance/structured-data/local-business (verify against current docs).

- **Apple Business Connect** (https://businessconnect.apple.com): controls Apple Maps, Siri, and Spotlight results — important given iPhone share. Claim, verify, add photos/hours, "Showcases" for promos.

- **Bing Places** (https://www.bingplaces.com): import from GBP in a few clicks. Bing data also powers some AI assistants and other surfaces.

<title>Invoice Software for Freelancers | Acme</title>   <meta name="description" content="Send professional invoices in 60 seconds, get paid by card or bank transfer, and chase late payments automatically. Free for up to 5 clients.">   <li

<link rel="canonical" href="https://www.acme.com/invoicing">

<meta property="og:title" content="Invoice Software for Freelancers">   <meta property="og:description" content="Send professional invoices in 60 seconds and get paid faster.">   <meta property="og:url" content="https://www.acme.com/invoici

<meta property="og:description" content="Send professional invoices in 60 seconds and get paid faster.">   <meta property="og:url" content="https://www.acme.com/invoicing">   <meta property="og:image" content="https://www.acme.com/og/invoic

<meta property="og:url" content="https://www.acme.com/invoicing">

<meta property="og:image" content="https://www.acme.com/og/invoicing.png">

- One canonical per page. Frameworks plus plugins often emit two — check rendered HTML. - Cross-domain canonical is valid for syndicated content (point to the original). - HTTP header form for non-HTML (PDFs): `Link: <https://example.com/do

- HTTP header form for non-HTML (PDFs): `Link: <https://example.com/doc.pdf>; rel="canonical"`.

Google Search favicon: must be a multiple of 48×48 px (48, 96, 144…) or SVG, crawlable, stable URL, on the home page. Verify against current docs: https://developers.google.com/search/docs/appearance/favicon-in-search

Verify against current docs: https://web.dev/articles/vitals

- `fetchpriority="high"` on the LCP image (framework: Next.js `priority`/`preload`, Nuxt `<NuxtImg preload>`, Astro `<Image loading="eager" fetchpriority="high">`). - If it's a CSS background or discovered late: `<link rel="preload" as="ima

- Self-host or `preconnect` the LCP image's origin: `<link rel="preconnect" href="https://cdn.example.com" crossorigin>`.

{   "@context": "https://schema.org",

"@context": "https://schema.org",

{       "@type": "Organization",       "@id": "https://www.example.com/#organization",

"@type": "Organization",       "@id": "https://www.example.com/#organization",       "name": "Acme",

"@id": "https://www.example.com/#organization",

"name": "Acme",       "url": "https://www.example.com/",       "logo": { "@type": "ImageObject", "url": "https://www.example.com/logo-512.png", "width": 512, "height": 512 }

"url": "https://www.example.com/",

"logo": { "@type": "ImageObject", "url": "https://www.example.com/logo-512.png", "width": 512, "height": 512 }

{       "@type": "WebSite",       "@id": "https://www.example.com/#website",

"@type": "WebSite",       "@id": "https://www.example.com/#website",       "url": "https://www.example.com/",

"@id": "https://www.example.com/#website",

"url": "https://www.example.com/",

"name": "Acme",       "publisher": { "@id": "https://www.example.com/#organization" }     },

"publisher": { "@id": "https://www.example.com/#organization" }

{       "@type": "WebPage",       "@id": "https://www.example.com/pricing#webpage",

"@type": "WebPage",       "@id": "https://www.example.com/pricing#webpage",       "url": "https://www.example.com/pricing",

"@id": "https://www.example.com/pricing#webpage",

"url": "https://www.example.com/pricing",

"name": "Pricing | Acme",       "isPartOf": { "@id": "https://www.example.com/#website" },       "breadcrumb": { "@id": "https://www.example.com/pricing#breadcrumb" }

"isPartOf": { "@id": "https://www.example.com/#website" },

"breadcrumb": { "@id": "https://www.example.com/pricing#breadcrumb" }

{   "@type": "Organization",   "@id": "https://www.example.com/#organization",

"@type": "Organization",   "@id": "https://www.example.com/#organization",   "name": "Acme",

"@id": "https://www.example.com/#organization",

"name": "Acme",   "legalName": "Acme Software Ltd",   "url": "https://www.example.com/",

"legalName": "Acme Software Ltd",   "url": "https://www.example.com/",   "logo": "https://www.example.com/logo-512.png",

"url": "https://www.example.com/",

"logo": "https://www.example.com/logo-512.png",

"description": "Invoicing software for freelancers and small agencies.",   "sameAs": [     "https://www.linkedin.com/company/acme",

"sameAs": [     "https://www.linkedin.com/company/acme",     "https://github.com/acme",

"https://www.linkedin.com/company/acme",

"https://github.com/acme",

"https://x.com/acme",

"https://www.wikidata.org/wiki/Q000000"

{   "@type": "WebSite",   "@id": "https://www.example.com/#website",

"@type": "WebSite",   "@id": "https://www.example.com/#website",   "url": "https://www.example.com/",

"@id": "https://www.example.com/#website",

"url": "https://www.example.com/",

"name": "Acme",   "alternateName": ["Acme Invoicing", "acme.com"],   "publisher": { "@id": "https://www.example.com/#organization" },

"alternateName": ["Acme Invoicing", "acme.com"],   "publisher": { "@id": "https://www.example.com/#organization" },   "inLanguage": "en-US"

"publisher": { "@id": "https://www.example.com/#organization" },

{   "@type": "BreadcrumbList",   "@id": "https://www.example.com/blog/late-payment-email#breadcrumb",

"@type": "BreadcrumbList",   "@id": "https://www.example.com/blog/late-payment-email#breadcrumb",   "itemListElement": [

"@id": "https://www.example.com/blog/late-payment-email#breadcrumb",

"itemListElement": [     { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },     { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.example.com/blog" },

{ "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com/" },

{ "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.example.com/blog" },

{   "@type": "BlogPosting",   "@id": "https://www.example.com/blog/late-payment-email#article",

"@type": "BlogPosting",   "@id": "https://www.example.com/blog/late-payment-email#article",   "mainEntityOfPage": "https://www.example.com/blog/late-payment-email",

"@id": "https://www.example.com/blog/late-payment-email#article",

"mainEntityOfPage": "https://www.example.com/blog/late-payment-email",

"description": "Polite, firm and final-notice templates for chasing unpaid invoices.",   "image": [     "https://www.example.com/og/late-payment-email-16x9.png",

"image": [     "https://www.example.com/og/late-payment-email-16x9.png",     "https://www.example.com/og/late-payment-email-4x3.png",

"https://www.example.com/og/late-payment-email-16x9.png",

"https://www.example.com/og/late-payment-email-4x3.png",

"https://www.example.com/og/late-payment-email-1x1.png"

"datePublished": "2026-03-02T08:00:00+00:00",   "dateModified": "2026-09-14T10:15:00+00:00",   "author": [{ "@type": "Person", "name": "Jane Doe", "url": "https://www.example.com/authors/jane-doe" }],

"dateModified": "2026-09-14T10:15:00+00:00",   "author": [{ "@type": "Person", "name": "Jane Doe", "url": "https://www.example.com/authors/jane-doe" }],   "publisher": { "@id": "https://www.example.com/#organization" },

"author": [{ "@type": "Person", "name": "Jane Doe", "url": "https://www.example.com/authors/jane-doe" }],

"publisher": { "@id": "https://www.example.com/#organization" },

{   "@type": "Product",   "@id": "https://shop.example.com/p/trail-runner-2#product",

"@type": "Product",   "@id": "https://shop.example.com/p/trail-runner-2#product",   "name": "Trail Runner 2 – Men's Running Shoe",

"@id": "https://shop.example.com/p/trail-runner-2#product",

"name": "Trail Runner 2 – Men's Running Shoe",   "image": ["https://shop.example.com/img/trail-runner-2-1.jpg"],   "description": "Lightweight trail shoe with 6mm drop and Vibram outsole.",

"image": ["https://shop.example.com/img/trail-runner-2-1.jpg"],

"offers": {     "@type": "Offer",     "url": "https://shop.example.com/p/trail-runner-2",

"@type": "Offer",     "url": "https://shop.example.com/p/trail-runner-2",     "priceCurrency": "USD",

"url": "https://shop.example.com/p/trail-runner-2",

"price": "129.00",     "priceValidUntil": "2026-12-31",     "availability": "https://schema.org/InStock",

"priceValidUntil": "2026-12-31",     "availability": "https://schema.org/InStock",     "itemCondition": "https://schema.org/NewCondition",

"availability": "https://schema.org/InStock",

"itemCondition": "https://schema.org/NewCondition",

"@type": "MerchantReturnPolicy",       "applicableCountry": "US",       "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",

"applicableCountry": "US",       "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",       "merchantReturnDays": 30,

"returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",

"merchantReturnDays": 30,       "returnMethod": "https://schema.org/ReturnByMail",       "returnFees": "https://schema.org/FreeReturn"

"returnMethod": "https://schema.org/ReturnByMail",

"returnFees": "https://schema.org/FreeReturn"

- Variants: `ProductGroup` with `hasVariant` and `variesBy` (size, color), each variant a `Product` with its own `sku`/`offers`; `productGroupID`. - Price ranges: `AggregateOffer` with `lowPrice`/`highPrice`/`offerCount`. - Sale prices: `pr

- Price ranges: `AggregateOffer` with `lowPrice`/`highPrice`/`offerCount`. - Sale prices: `priceSpecification` with `UnitPriceSpecification` and `priceType: https://schema.org/StrikethroughPrice` for the original price. - Shipping and retur

- Sale prices: `priceSpecification` with `UnitPriceSpecification` and `priceType: https://schema.org/StrikethroughPrice` for the original price.

- Shipping and return policy can be defined once at the Organization level (`hasMerchantReturnPolicy`, `shippingDetails` via `OfferShippingDetails` on Organization — supported since 2024/2025) instead of per offer, or configured in Merchant

"operatingSystem": "Web, iOS, Android",   "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" },   "url": "https://www.example.com/"

"offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" },   "url": "https://www.example.com/" }

"url": "https://www.example.com/"

{   "@type": "Dentist",   "@id": "https://www.example.com/locations/leeds#localbusiness",

"@type": "Dentist",   "@id": "https://www.example.com/locations/leeds#localbusiness",   "name": "Bright Smile Dental Leeds",

"@id": "https://www.example.com/locations/leeds#localbusiness",

"name": "Bright Smile Dental Leeds",   "image": "https://www.example.com/img/leeds-clinic.jpg",   "url": "https://www.example.com/locations/leeds",

"image": "https://www.example.com/img/leeds-clinic.jpg",

"url": "https://www.example.com/locations/leeds",

{ "@type": "OpeningHoursSpecification", "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"], "opens": "08:30", "closes": "17:30" }   ],   "parentOrganization": { "@id": "https://www.example.com/#organization" }

],   "parentOrganization": { "@id": "https://www.example.com/#organization" } }

"parentOrganization": { "@id": "https://www.example.com/#organization" }

"startDate": "2026-11-20T18:00:00+00:00",   "endDate": "2026-11-20T21:00:00+00:00",   "eventStatus": "https://schema.org/EventScheduled",

"endDate": "2026-11-20T21:00:00+00:00",   "eventStatus": "https://schema.org/EventScheduled",   "eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",

"eventStatus": "https://schema.org/EventScheduled",

"eventAttendanceMode": "https://schema.org/OfflineEventAttendanceMode",

"address": { "@type": "PostalAddress", "streetAddress": "10 Example Rd", "addressLocality": "London", "postalCode": "E1 6AN", "addressCountry": "GB" }   },   "image": ["https://www.example.com/img/event.jpg"],

},   "image": ["https://www.example.com/img/event.jpg"],   "description": "An evening of talks on pricing, invoicing and tax for freelancers.",

"image": ["https://www.example.com/img/event.jpg"],

"description": "An evening of talks on pricing, invoicing and tax for freelancers.",   "organizer": { "@type": "Organization", "name": "Acme", "url": "https://www.example.com/" },   "offers": { "@type": "Offer", "url": "https://www.example.

"organizer": { "@type": "Organization", "name": "Acme", "url": "https://www.example.com/" },

"offers": { "@type": "Offer", "url": "https://www.example.com/events/ffl-2026", "price": "15.00", "priceCurrency": "GBP", "availability": "https://schema.org/InStock", "validFrom": "2026-09-01T00:00:00+00:00" }

"mainEntity": {     "@type": "Person",     "@id": "https://www.example.com/#person",

"@type": "Person",     "@id": "https://www.example.com/#person",     "name": "Jane Doe",

"@id": "https://www.example.com/#person",

"jobTitle": "Product Designer",     "description": "Product designer specialising in fintech onboarding.",     "image": "https://www.example.com/jane.jpg",

"description": "Product designer specialising in fintech onboarding.",     "image": "https://www.example.com/jane.jpg",     "url": "https://www.example.com/",

"image": "https://www.example.com/jane.jpg",

"url": "https://www.example.com/",

"sameAs": ["https://www.linkedin.com/in/janedoe", "https://github.com/janedoe"],

"name": "How to send your first invoice",   "description": "A 3-minute walkthrough of creating and sending an invoice in Acme.",   "thumbnailUrl": ["https://www.example.com/video/first-invoice.jpg"],

"description": "A 3-minute walkthrough of creating and sending an invoice in Acme.",   "thumbnailUrl": ["https://www.example.com/video/first-invoice.jpg"],   "uploadDate": "2026-05-01T09:00:00+00:00",

"thumbnailUrl": ["https://www.example.com/video/first-invoice.jpg"],

"uploadDate": "2026-05-01T09:00:00+00:00",   "duration": "PT3M12S",   "contentUrl": "https://cdn.example.com/video/first-invoice.mp4",

"duration": "PT3M12S",   "contentUrl": "https://cdn.example.com/video/first-invoice.mp4",   "embedUrl": "https://www.youtube.com/embed/XXXXXXXX"

"contentUrl": "https://cdn.example.com/video/first-invoice.mp4",

"embedUrl": "https://www.youtube.com/embed/XXXXXXXX"

"@type": "Recipe",   "name": "Classic Jollof Rice",   "image": ["https://www.example.com/img/jollof-16x9.jpg"],

"name": "Classic Jollof Rice",   "image": ["https://www.example.com/img/jollof-16x9.jpg"],   "author": { "@type": "Person", "name": "Jane Doe" },

"image": ["https://www.example.com/img/jollof-16x9.jpg"],

Google retired the **Course info** rich result in 2025; the **Course list** (carousel) feature for course providers may still apply. `Course` with `name`, `description`, `provider` remains valid schema and useful for entity understanding. V

- Server-side (`301`/`308`) only. Avoid JS redirects and `<meta refresh>` (followed by Google but slower, lossy elsewhere). - 301 vs 308: equivalent for SEO; 308 preserves method (POST). Frameworks often default to 307/308 — fine. - **One h

- 301 vs 308: equivalent for SEO; 308 preserves method (POST). Frameworks often default to 307/308 — fine. - **One hop**: `http://example.com/a` → `https://www.example.com/a` directly, not via two hops. Chains > 5 hops are abandoned by Goog

- **One hop**: `http://example.com/a` → `https://www.example.com/a` directly, not via two hops. Chains > 5 hops are abandoned by Googlebot.

Sitemap: https://www.example.com/sitemap.xml

Test: Search Console robots.txt report; `curl -A Googlebot https://site/robots.txt`.

<?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

<url>     <loc>https://www.example.com/blog/late-payment-email</loc>     <lastmod>2026-09-14</lastmod>

<loc>https://www.example.com/blog/late-payment-email</loc>

- Reference from robots.txt and submit in Search Console + Bing Webmaster Tools. - Extensions (separate namespaces):   - **Image**: `xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"`, `<image:image><image:loc>…</image:loc></ima

- Extensions (separate namespaces):   - **Image**: `xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"`, `<image:image><image:loc>…</image:loc></image:image>` — useful when images are lazy-loaded via JS or on CDN hosts.   - **Vid

- **Image**: `xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"`, `<image:image><image:loc>…</image:loc></image:image>` — useful when images are lazy-loaded via JS or on CDN hosts.

- **Video**: `xmlns:video="http://www.google.com/schemas/sitemap-video/1.1"`, requires `thumbnail_loc`, `title`, `description`, `content_loc` or `player_loc`.

- **News**: `xmlns:news="http://www.google.com/schemas/sitemap-news/0.9"`; only articles from last 2 days, ≤1000 URLs; publisher name + language + publication_date + title.

- **hreflang**: `xmlns:xhtml="http://www.w3.org/1999/xhtml"` with `<xhtml:link rel="alternate" hreflang="…" href="…"/>` — see `international.md`.

Verify against current docs: https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap

CSR pitfalls checklist: - Empty `<div id="root">` in raw HTML → nothing for non-rendering crawlers. Check with `curl -s URL | grep -c '<h1'`.

- Empty `<div id="root">` in raw HTML → nothing for non-rendering crawlers. Check with `curl -s URL | grep -c '<h1'`.

Launch: - [ ] Deploy 301s (one hop), test the full map with a script (`curl -sI` each, expect 301 → 200).

- [ ] Deploy 301s (one hop), test the full map with a script (`curl -sI` each, expect 301 → 200).

1. Generate a key (8–128 hex chars), host it at `https://example.com/{key}.txt` containing the key.

POST https://api.indexnow.org/indexnow

{"host":"www.example.com","key":"<key>","keyLocation":"https://www.example.com/<key>.txt","urlList":["https://www.example.com/blog/new-post"]}

Verify against current docs: https://www.indexnow.org/documentation

#!/usr/bin/env python3

#!/usr/bin/env python3

Examples:   generate_sitemap.py public --base-url https://example.com

generate_sitemap.py public --base-url https://example.com

generate_sitemap.py dist --base-url https://example.com --lastmod git --no-trailing-slash

generate_sitemap.py _site --base-url https://example.com --stdout

def render_urlset(urls: List[Tuple[str, Optional[str]]]) -> str:     lines = ['<?xml version="1.0" encoding="UTF-8"?>', '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">']

lines = ['<?xml version="1.0" encoding="UTF-8"?>', '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">']

def render_index(locs: List[str]) -> str:     lines = ['<?xml version="1.0" encoding="UTF-8"?>', '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">']

lines = ['<?xml version="1.0" encoding="UTF-8"?>', '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">']

ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)     ap.add_argument("root", help="directory containing the built HTML")     ap.add_argument("--base-url", required=True, help="productio

ap.add_argument("root", help="directory containing the built HTML")     ap.add_argument("--base-url", required=True, help="production origin, e.g. https://www.example.com")     ap.add_argument("--no-trailing-slash", action="store_true", hel

ap.add_argument("--base-url", required=True, help="production origin, e.g. https://www.example.com")

if not args.base_url.startswith(("http://", "https://")):         ap.error("--base-url must be absolute, e.g. https://www.example.com")

ap.error("--base-url must be absolute, e.g. https://www.example.com")

#!/usr/bin/env python3

Examples:   seo_audit.py dist                              # audit a static build   seo_audit.py http://localhost:3000 --crawl 50  # crawl a running dev server

seo_audit.py dist                              # audit a static build   seo_audit.py http://localhost:3000 --crawl 50  # crawl a running dev server   seo_audit.py https://example.com --json        # machine-readable output

seo_audit.py http://localhost:3000 --crawl 50  # crawl a running dev server

seo_audit.py https://example.com --json        # machine-readable output

seo_audit.py out --base-url https://example.com --fail-under 85   # CI gate

"description-duplicate": "Write unique descriptions per page, or generate them from page data.",     "canonical-missing": "Add a self-referencing absolute <link rel=\"canonical\">.",     "canonical-relative": "Canonical URLs must be absolut

"canonical-missing": "Add a self-referencing absolute <link rel=\"canonical\">.",     "canonical-relative": "Canonical URLs must be absolute (https://…), built from one site-origin config.",     "canonical-multiple": "Emit exactly one canon

"canonical-relative": "Canonical URLs must be absolute (https://…), built from one site-origin config.",

"robots-missing": "Add /robots.txt that allows crawling and references your sitemap.",     "robots-blocks-all": "robots.txt blocks the whole site for all crawlers. Remove `Disallow: /` before launch.",     "robots-no-sitemap": "Reference th

"robots-blocks-all": "robots.txt blocks the whole site for all crawlers. Remove `Disallow: /` before launch.",     "robots-no-sitemap": "Reference the sitemap in robots.txt: `Sitemap: https://…/sitemap.xml`.",     "robots-blocks-assets": "D

"robots-no-sitemap": "Reference the sitemap in robots.txt: `Sitemap: https://…/sitemap.xml`.",

continue         seen.add(key)         res = fetch(url, timeout)

seen.add(key)         res = fetch(url, timeout)         if res.status and "html" not in res.content_type.lower() and res.status < 400:

res = fetch(url, timeout)

extras: Dict[str, Optional[str]] = {}     for name in ("robots.txt", "sitemap.xml", "llms.txt"):         res = fetch(f"{origin}/{name}", timeout)

for name in ("robots.txt", "sitemap.xml", "llms.txt"):         res = fetch(f"{origin}/{name}", timeout)         extras[name] = res.body if res.status == 200 else None

res = fetch(f"{origin}/{name}", timeout)

if extras.get("sitemap.xml") is None and extras.get("robots.txt"):         for kind, value in parse_robots(extras["robots.txt"] or "").get("__sitemaps__", []):             res = fetch(value, timeout)

for kind, value in parse_robots(extras["robots.txt"] or "").get("__sitemaps__", []):             res = fetch(value, timeout)             if res.status == 200:

res = fetch(value, timeout)

ap.add_argument("target", help="URL, build directory, or single HTML file")     ap.add_argument("--crawl", type=int, default=25, help="max pages to crawl in URL mode (default 25)")     ap.add_argument("--base-url", help="production origin f

ap.add_argument("--crawl", type=int, default=25, help="max pages to crawl in URL mode (default 25)")     ap.add_argument("--base-url", help="production origin for directory/file mode, e.g. https://example.com")     ap.add_argument("--json",

ap.add_argument("--base-url", help="production origin for directory/file mode, e.g. https://example.com")

Executable file

def fetch(url: str, timeout: float = 15.0) -> FetchResult:

req = urllib.request.Request(url, headers={"User-Agent": USER_AGENT, "Accept": "text/html,*/*;q=0.8"})

try:         with urllib.request.urlopen(req, timeout=timeout) as resp:             raw = resp.read(5_000_000)

with urllib.request.urlopen(req, timeout=timeout) as resp:

#!/usr/bin/env python3

Examples:   validate_jsonld.py dist                      # every HTML file in a build   validate_jsonld.py https://example.com/post  # a live page

validate_jsonld.py dist                      # every HTML file in a build   validate_jsonld.py https://example.com/post  # a live page   validate_jsonld.py page.html schema.json     # files (.html or raw .json)

validate_jsonld.py https://example.com/post  # a live page

This is a fast offline linter, not a replacement for Google's Rich Results Test (https://search.google.com/test/rich-results). It catches the mistakes

Test (https://search.google.com/test/rich-results). It catches the mistakes

# type -> (required, recommended). "a|b" means at least one of them. # Based on Google Search Central structured data docs; re-check # https://developers.google.com/search/docs/appearance/structured-data/search-gallery when updating.

# https://developers.google.com/search/docs/appearance/structured-data/search-gallery when updating.

ctx = node.get("@context")         if ctx is None:             out.append(Finding("error", source, path, "Missing @context (use \"https://schema.org\")"))

if ctx is None:             out.append(Finding("error", source, path, "Missing @context (use \"https://schema.org\")"))         elif isinstance(ctx, str) and "schema.org" not in ctx:

out.append(Finding("error", source, path, "Missing @context (use \"https://schema.org\")"))

avail = node.get("availability")             if isinstance(avail, str) and not AVAILABILITY.match(avail):                 out.append(Finding("warning", source, here, f"availability should be a schema.org URL like https://schema.org/InStock:

if isinstance(avail, str) and not AVAILABILITY.match(avail):                 out.append(Finding("warning", source, here, f"availability should be a schema.org URL like https://schema.org/InStock: {avail!r}"))         if canon == "Breadcrumb

out.append(Finding("warning", source, here, f"availability should be a schema.org URL like https://schema.org/InStock: {avail!r}"))

for t in targets:         if is_url(t):             res = fetch(t)

if is_url(t):             res = fetch(t)             if res.error or res.status >= 400:

res = fetch(t)