How I Use Claude Code for SEO to Rank #1 (in 10 minutes)

The Master Prompt:

You are a senior content strategist and frontend developer. I need you to produce a premium, publication-ready blog article as a single self-contained HTML file that outperforms any competitor article on the same topic.

Here is my brief:

- Topic: [e.g. "Best AI SEO Tools 2025"]

- Competitor URL to beat: [URL]

- My website: arrow.com

- My product/service: [e.g. "an AI writing tool for agencies"]

- Target keyword: [e.g. "best ai seo tools"]

- Internal pages to link to: [list your key URLs, e.g. mysite.com/pricing, mysite.com/blog, mysite.com/agency]

---

BEFORE WRITING: Fetch the competitor URL and analyze its structure — sections, images, links, tables, FAQs, tone, word count, and anything it's missing. Your article must include everything it has, and be meaningfully better in every dimension.

---

WHAT THE HTML FILE MUST INCLUDE:

DESIGN:

- All CSS embedded in <style> tags — no external files

- Google Fonts: Playfair Display (headings), DM Sans (body), DM Mono (code/tags)

- CSS variables for colors: dark ink (#0d0f14), paper background (#fafaf8), accent blue (#1a56f0), gold (#c8973a), green (#1a8a5a), red (#d63c3c)

- Light editorial feel on body; dark hero section with custom SVG illustration (fully coded — no <img> tags pointing to missing files)

- Never use Inter, Roboto, Arial, or purple gradient aesthetics

STRUCTURE (in this order):

1. Breadcrumb bar linking to my homepage and blog

2. Dark hero section with H1, subtitle, author/date meta, and a custom hand-coded SVG illustration relevant to the topic (bar chart, dashboard mockup, chat window, network graph, etc.)

3. Numbered two-column Table of Contents anchored to each section

4. Intro (3–5 paragraphs) + 3 stat cards (dark background, big number, short label) + one callout box

5. Educational foundation: "What is X and why does it matter?" with a comparison table (old approach vs. new approach, minimum 6 rows)

6. YouTube video embed #1 (find a real, relevant video) with caption

7. 10 item/tool cards — one per list item — each containing:

   - Rank badge, item name as H2 with external link, "★ Best for X ★" gold badge

   - 2–3 sentence intro

   - Key Features: 2-column grid of 6–8 items, each with a ✓ icon

   - Pros/Cons: side-by-side green block (pros) and red block (cons)

   - "Why It Wins" blue callout box

   - Pull quote with gold left border

   - Pricing pill (💰 Starting at $X/mo)

8. YouTube video embed #2 (different video, also real and relevant)

9. Strategy/Stack guide: dark background section with 4–5 numbered phases explaining how to use these tools together

10. Full comparison table (all 10 items, 6+ columns: name, best for, key feature, ease of use ★★★★☆, agency friendly ✅/⚠️, price)

11. FAQ section: 7+ questions using native HTML <details>/<summary> accordion — write questions the way real people ask them ("How do I...", "What's the difference between...", "Is X worth it?")

12. CTA block: gradient blue background, bold headline, body copy, button linking to my pricing or signup page

13. Related posts grid: 3 cards linking to relevant articles on my site

CONTENT RULES:

- Confident, direct, opinionated voice — no filler phrases like "In today's digital landscape"

- Every factual claim needs an external link to an authoritative source (research papers, industry publications, official platform docs, credible news)

- All external links: target="_blank" rel="noopener"

- Minimum 6 internal links to my site, placed naturally in body text and callout boxes

- Each tool card must explain WHY it ranks, not just WHAT it does

- FAQ answers should be 80–150 words each and include natural internal links where relevant

- AEO-ready: clear H2/H3 hierarchy, structured FAQ, concise "Why It Wins" sentences that LLMs can extract

- Total body content target: 4,000–6,000 words

- No placeholder text, no broken image paths, no TODO comments anywhere

UPGRADES OVER THE COMPETITOR (mandatory):

- Custom coded SVG hero (not a stock image)

- Visual 2-column feature grid (not plain bullets)

- Color-coded pros/cons blocks (not plain bullets)

- Enhanced comparison table with star ratings and price tags

- 2 embedded YouTube videos

- 3+ callout boxes (blue for tips, green for stats, gold for warnings)

- Stat cards with sourced data

- Dark-background phased strategy section

- Educational "What is X vs Y" comparison table

- Related posts grid at the bottom

OUTPUT: One complete, self-contained HTML file. No placeholders. No broken references. Ready to paste into a CMS or open in a browser.