The SEO/GEO Engine Playbook

The autonomous layer — trend discovery, LLM classification, auto-authored pages, tracking.

SEO-GEO-ENGINE-PLAYBOOK.md · 16 sections · 5,518 words · 42 KB · markdown

Topical Authority builds the page surface by hand. This builds the machine that grows it on its own: twice-daily trend discovery, LLM classification of what's worth writing, fact-checked auto-authoring committed via CI, and a discovery + analytics console so you approve rather than write.

What's inside

//Twice-daily trend discovery with cross-run dedupe
//LLM classification + scoring of candidate topics
//Auto-authoring via CI, fact-checked and committed as a PR
//GSC / Bing / IndexNow submission and rank tracking
//An admin Discovery console (approve, reject, permanently ignore)
//The immutability rule that stops rejected topics resurfacing

When to use it

After the page surface and admin console exist.

Build these first

Topical Authority, Admin Console

Straight from the file

This is the operational engine that sits on top of TOPICAL-AUTHORITY-PLAYBOOK. Topical-Authority defines the page strategy (5-layer model, collections, schema discipline). This playbook is the machine that keeps that surface growing on its own: it watches the web for fresh entities (new AI tools, competitor moves, topics), classifies each into the right page-types, dispatches an AI writer to author + fact-check + publish real pages, and tracks their grades + Google/Bing traction + index status — all from an admin console, twice a day, with zero human touch once enabled.

Table of contents

0. Use this spec
1. The model (read this first)
2. Architecture (file tree)
3. Data model
4. Discovery worker (poll-trends.ts)
5. The source catalog (trend-sources.ts) — the knobs
6. Auto-author: dispatcher + the GitHub Action + callback loop
7. How authored pages render
8. The repo layer (src/lib/repo/seo-engine.ts)
9. Analytics: grades + traction + index (3 layers)
10. The admin console UI
11. Environment variables (the matrix that bites)
12. Build sequence (vertical slices — pause after each)
13. Gotchas & lab notes (portable lessons)
14. Per-app customization checklist
15. Kickoff prompt ("run this template")

How to run it

Drop SEO-GEO-ENGINE-PLAYBOOK.md into your repo, then tell Claude Code: “Read SEO-GEO-ENGINE-PLAYBOOK.md and implement it in this codebase.” It's written for an agent to execute end to end. Search the file for angle-bracket placeholders and swap in your own project names, domains, and keys before the first run.

↓ Download the playbook

More growth & seo playbooks

S-tier

← All 28 Claude templates

The SEO/GEO Engine Playbook

Topical Authority

Customer Analytics

Pre-Sale Chatbot