Build Your First SEO Agent — 2-Week Workshop
Growth Architecture Studio · Workshop 0 · Starter

Build Your First
SEO Agent

No code. No prior automation experience. A running agent in 2 weeks.

Hybrid · Live + Async Beginner Friendly Claude Code GSC + Google Sheets ~8 hrs total build time
2
Weeks
3 weeks is too long for one agent Claude Code writes the code — you direct it You need: a website, GSC access, and curiosity

Your first agent detects decaying content before it costs you traffic.

Every website with more than 12 months of published content has the same invisible problem: pages that are quietly losing rankings, impressions, and clicks — and nobody's noticed yet. Fixing those pages is the highest-ROI SEO action most teams never take systematically, because finding them manually takes hours. This workshop solves that. In two focused weeks, you'll build a Content Freshness Agent — a real, running Python script that connects to your Google Search Console, detects decaying content automatically, scores each page by fix priority, and drops a ranked action list into Google Sheets every week. No manual checking. No spreadsheet archaeology. Just a clear list of what to fix, in what order, waiting for you on Monday morning.

Realistic Time Breakdown
Live sessions 4 × 90 min
API setup ~1.5 hrs
Build sessions ~4 hrs
Testing + tuning ~1 hr
Total build time ~8 hrs

A live Google Sheet, updated every Monday, with your decaying content ranked by fix priority. This is what you open on Monday morning instead of manually digging through GSC.

  Content Freshness Agent — Week of 17 Feb 2026
Page URL Impressions (90d) Clicks (90d) Position Decay Signal Priority Action
/blog/ai-seo-strategy 4,820 38 14.2 CTR collapse 9 / 10 Rewrite title + intro
/blog/content-audit-guide 3,100 61 8.7 Position drop 8 / 10 Update stats + examples
/blog/keyword-research-2023 2,240 14 22.1 Stale date signal 6 / 10 Republish + expand
/blog/seo-checklist 890 9 31.4 Traffic decline 3 / 10 Consolidate or redirect
↑ Sample output. Actual data pulled live from your GSC property. Decay signals and actions generated by Claude.
01
A Running Agent in Your Stack

A real Python script connected to your GSC, scoring your content, writing to Google Sheets — automatically, every week.

02
Your First Claude Code Workflow

You'll know how to direct Claude Code to build, debug, and extend agents. A transferable skill for every automation you build next.

03
A Weekly Action List, Forever

Every Monday: a prioritised list of content to fix, with decay signals and action recommendations — generated without you touching it.

The Content Freshness Agent

A scheduled Python script that runs every Monday, connects to your Google Search Console, analyses performance trends for every indexed page, uses Claude to detect decay patterns and generate fix recommendations, and writes a prioritised output to Google Sheets — all without you doing anything.

01
Pull GSC dataCompare last 30 days vs previous 60 days for every page: clicks, impressions, CTR, position.
02
Detect decay signalsFlag pages with: position drops, CTR collapse, impression decay, or stale date signals.
03
Score with ClaudeAI evaluates each flagged page: decay severity, fix effort, and business impact → priority score 1–10.
04
Write to Google SheetsRanked output with decay signal, priority score, and action recommendation. New tab each week.
05
Run on scheduleCron job or GitHub Actions fires every Monday at 8am. Zero manual input required.

The Two-Week Program

Week 01

Setup, Connect & First Run

FOUNDATION

Week 1 has one goal: get data flowing. By Friday, your agent is connected to your GSC, pulling real data, and producing its first (rough) output. The code doesn't need to be perfect — it needs to run.

Live
Kickoff: What We're Building & How Claude Code Works

Walkthrough of the agent architecture. Install Claude Code and Python environment together. Cover the core workflow: describe → generate → run → paste error → fix. No prior coding knowledge assumed.

Async
Google API Credentials Setup

Step-by-step guide (with video) to creating your Google Cloud project, enabling Search Console API + Sheets API, downloading credentials.json, and placing it correctly. Claude Code guides you through any errors.

Build
Build Session 1: GSC Connection + Data Pull

Using Claude Code prompts provided in the workshop guide, build the authentication module and the GSC data ingestion script. Goal: print your first 10 rows of real GSC data in the terminal. Paste errors back in and fix together.

Live
Week 1 Check-In: Debug Together

Group troubleshooting session. Everyone shares their terminal output — working or not. Common errors diagnosed live. By end of session, every participant has GSC data flowing. No one left behind.

GSC Data Flowing in Terminal

Your script connects to GSC and prints live performance data for your site. Foundation for everything in Week 2.

Week 02

Score, Output & Automate

COMPLETE

Week 2 turns raw data into intelligence. You'll add the decay detection logic, the Claude scoring layer, the Google Sheets output, and finally the scheduler — so the agent runs without you every week from here on.

Build
Build Session 2: Decay Detection + Claude Scoring

Prompt Claude Code to write the decay detection logic (position drops, CTR collapse, impression decline) and the Claude API scoring module. The agent now flags and scores every decaying page with a priority 1–10 and a plain-English action recommendation.

Async
Tune Your Scoring Logic

The default scoring prompt is a starting point — not the final word. This async session shows you how to customise the scoring criteria for your specific site and business: what decay patterns matter most, what pages to deprioritise, how to weight impact vs. effort.

Build
Build Session 3: Google Sheets Output + Scheduler

Prompt Claude Code to write the Sheets output module (new tab per week, conditional colour formatting on priority scores) and the main orchestration script. Set up the cron job or GitHub Actions workflow to run every Monday at 8am automatically.

Demo
Final Session: Live Agent Demos + What's Next

Every participant runs their agent live and shares their Google Sheet output. Group review of results and scoring quality. Introduction to what the next workshop builds on top of this foundation — and how to extend the agent yourself.

Your Content Freshness Agent — Live & Scheduled

A real Python agent running every Monday: pulling GSC data, detecting decay, scoring with Claude, and writing a prioritised fix list to Google Sheets.

Where Code Gets Written
Claude Code

You describe what you want. Claude Code writes it. No blank file, no manual debugging — you direct, it builds.

Data Source
Google Search Console

Free, official, and already connected to your site. The GSC API gives clicks, impressions, CTR, and position by page.

Scoring Intelligence
Claude API

Evaluates each decaying page, determines severity and fix type, and writes the action recommendation in plain English.

Output Destination
Google Sheets

A new tab every Monday. Priority-colour-coded. Shared with your team or used solo. No dashboard setup required.

Runtime Environment
Python / Google Colab

Run locally or in Google Colab (free, browser-based, no install). Colab is recommended for absolute beginners.

Scheduling
Cron / GitHub Actions

Mac/Linux cron for local runs. GitHub Actions for cloud-based scheduling — free tier is sufficient for weekly runs.

This workshop is the entry point. It stands alone — but it's also the foundation everything else builds on.

You are here · Workshop 0
Build Your First SEO Agent

One agent. Two weeks. Running in your stack.

Next · Workshop 1
Design Your SEO System Blueprint

Strategy, architecture, and AI-assisted workflows.

Advanced · Workshop 2
Build Your AI-Powered SEO Engine

Full infrastructure. Self-improving feedback loop.

What You Need

  • A website with Google Search Console connected
  • A Google account (for Sheets + Cloud setup)
  • Claude.ai account (any paid plan for API access)
  • A laptop — Mac, Windows, or Linux all work
  • Curiosity — no technical background required

What You Don't Need

  • Any coding or programming experience
  • n8n, Make, Zapier, or any automation tool
  • A paid SEO tool subscription
  • A developer or technical co-founder
  • More than ~8 hours across two weeks
Live Sessions
2 × per week
Duration
90 min each
Cohort Size
Max 10 people
Support
Slack + async
Workshop 0 · Build Your First SEO Agent
$250
per person · one-time
  • 4 live sessions (2 × per week, 90 min each)
  • Async build sessions + step-by-step guides
  • All code prompts + workshop materials
  • Private Slack support for 2 weeks
  • Cohort limited to 10 participants
  • Lifetime access to session recordings
Reserve Your Spot →

Cohort size capped at 10 · Spots fill fast · No refunds after build session 1