← All runbooks
gooseworks-ai / playbooks-seo-content-engine

SEO Content Engine

Build a compounding SEO content engine for a client by auditing the current search footprint, identifying competitive and funnel gaps, building keyword architecture, creating a prioriti

agent codexmodel gpt-5.5snapshot python312-uveval programmatic9 stepsv1.0.0

Deploy SEO Content Engine to your jetty.io

One-click installs this runbook into a collection on your Jetty account. You can run it from the Spot dashboard, schedule it, or pipe inputs in via the API.

Deploy on jetty.io →View source
The shape of the run

9 steps · start to finish.

  1. 1
    Step 1

    Environment Setup

    ▶
    1. Resolve all parameters and create results_dir if it does not exist.
    2. Verify client_website_url starts with http:// or https://.
    3. Verify client_context_path exists and is readable.
    4. Normalize competitors into a newline-delimited list.
    5. Initialize a validation report with stages for setup, audit, gaps, keyword architecture, calendar, drafting, internal linking, monitoring, and final verification.

    If a required input is missing, write validation_report.json with overall_passed=false, write summary.md describing the missing input, and stop.

  2. 2
    Step 2

    Audit Current State

    ▶

    Run the equivalent of `seo-content-audit` to establish the current search baseline. Combine a site content catalog, domain and ranking analysis, competitive gap matrix, and brand voice extraction.

  3. 3
    Step 3

    Identify Content Gaps

    ▶

    Analyze the audit and classify gaps into competitive, funnel, topic, and comparison opportunities.

  4. 4
    Step 4

    Build Keyword Architecture

    ▶

    Map keyword clusters across funnel stages:

  5. 5
    Step 5

    Create Content Calendar

    ▶

    Build an 8-week calendar ordered by business urgency and ranking opportunity:

  6. 6
    Step 6

    Draft Content Briefs

    ▶

    For each approved priority piece, draft a content brief rather than final-publishing copy unless the operator explicitly requests finished drafts.

  7. 7
    Step 7

    Build Internal Linking Architecture

    ▶

    Design the link structure so awareness pages move readers toward evaluation and decision content:

  8. 8
    Step 8

    Publish and Monitor

    ▶

    Create a monitoring plan that tracks organic traffic by page and cluster, rankings by target keyword, assisted conversions, content-to-signup conversion, and pages requiring refresh.

  9. 9
    Step 9

    Iterate on Errors (max 3 rounds)

    ▶

    If validation fails or a human checkpoint rejects a section, perform up to max 3 rounds of targeted revision. Each round should identify the failed stage, adjust only the affected output files, and re-run validation before continuing.