diff --git a/README.md b/README.md
index 3c02d82a..15fff6ec 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,7 @@
 </p>
 
 <p align="center">
+  <a href="#demo">Demo</a> ·
   <a href="#getting-started">Quick start</a> ·
   <a href="#seo-feedback-loop">Feedback loop</a> ·
   <a href="#features">Features</a> ·
@@ -54,6 +55,18 @@ Site Audit is a **developer-friendly SEO audit** tool: self-hosted, transparent,
 - **Closed-loop SEO workflow** — audit, report, feed data to IDE agents via MCP, fix in code, review and compare
 - Optional AI-assisted analysis over audit data via MCP-compatible tools
 
+## Demo
+
+<p align="center">
+  <a href="https://youtu.be/HwWw7_koj70">
+    <img src="https://markdown-videos.vercel.app/youtube/HwWw7_koj70" alt="Site Audit — Open Source SEO Crawl & Audit" width="920">
+  </a>
+</p>
+
+<p align="center">
+  <sub><a href="https://youtu.be/HwWw7_koj70">▶ Site Audit — Open Source SEO Crawl & Audit</a></sub>
+</p>
+
 ## SEO feedback loop
 
 Site Audit is built for a **continuous improve-and-verify cycle**, not one-off dashboard checks. Crawl your site, generate reports, expose audit data to AI agents in **Cursor, Claude Code, or Copilot** via [340 MCP tools](docs/MCP.md), fix issues in your repository, then **review** the next run to compare health scores and issue deltas.