Tutorial

How to Do SEO with Claude Code (End-to-End)

An r/ClaudeAI post asked: fire SEO vendor, use Claude? Walk-through of the full in-house workflow with Scavio MCP attached.

An r/ClaudeAI post asked the question: should I fire my SEO vendor and use Claude? The answer is 'sometimes yes, with these tools'. This walks the end-to-end in-house SEO workflow.

Prerequisites

  • Claude Code CLI
  • Scavio API key
  • (Optional) Ahrefs/Semrush export for keyword volumes

Walkthrough

Step 1: Attach Scavio MCP to Claude Code

One config line.

Bash
claude mcp add scavio https://mcp.scavio.dev/mcp --header 'x-api-key: $SCAVIO_API_KEY'

Step 2: Run a competitor scan

Ask Claude to check top-3 competitors' top-ranking pages.

Text
# Inside Claude Code:
# 'Use scavio search to pull the top-10 SERP for [target keyword]. List the domains and their meta descriptions.'

Step 3: Generate a keyword brief

Claude reads SERP + AI Overview citations + PAA box, drafts a brief.

Text
# 'Search [target keyword] with include_ai_overview: true. Pull the top-5 PAA questions. Draft a content brief covering all of them, with citations.'

Step 4: Write the article

Claude drafts the article using the brief.

Text
# 'Write the article from the brief. Include the [N] citation markers next to claims drawn from the SERP sources.'

Step 5: Track rank weekly

Re-run the search; compare positions over time.

Text
# Cron a weekly Scavio search; log organic_results[] positions per target URL.
# Plot in any chart tool (Streamlit / Grafana / Sheets).

Python Example

Python
# Optional Python wrapper for the cron rank-tracking step.

JavaScript Example

JavaScript
// Same — most of this is Claude Code interactions, not custom code.

Expected Output

JSON
End-to-end SEO workflow: research, briefing, drafting, rank tracking. Cost: Claude Pro $20 + Scavio $30 = $50/mo. Honest constraint: technical SEO (schema, Core Web Vitals, link building) still needs a human.

Related Tutorials

Frequently Asked Questions

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

Claude Code CLI. Scavio API key. (Optional) Ahrefs/Semrush export for keyword volumes. A Scavio API key gives you 500 free credits per month.

Yes. The free tier includes 500 credits per month, which is more than enough to complete this tutorial and prototype a working solution.

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Start Building

An r/ClaudeAI post asked: fire SEO vendor, use Claude? Walk-through of the full in-house workflow with Scavio MCP attached.