boringcashcow
← The Playbook
A green robot pointing at a content plan: a hub article linked to three spoke articles, with a rising traffic line.
market Premium

seo-agent

Your repo in, SEO pull requests out.

you give
a product repo
you get
keywords, articles and fixes, as PRs
run time
one command a day
you need
Claude Code, DataForSEO key

seo-agent is a Claude Code plugin that runs SEO for one product, from inside that product's own repo. It finds keywords, writes new articles, refreshes old ones and fixes small on-page problems. Every piece of work arrives as a pull request. You merge what you like.

What it does

  • Sets itself up. One command reads your existing pages and drafts a strategy, a voice guide and a review checklist for you to edit. It also picks up your brand colours and fonts for article images.
  • Finds keywords. It proposes ranked keywords for each topic cluster, using DataForSEO data. You delete the ones you don't want.
  • Writes articles. One new article a week by default, in your site's own format, with on-brand images.
  • Refreshes old pages. With Search Console connected, it spots pages that are slipping or sitting just off page one, and updates them.
  • Fixes the small stuff. Titles, descriptions, alt text, broken links and missing links between hub and spoke pages. A quarterly crawl of the live site adds to the list.
  • Reviews its own work. A fresh session checks each pull request against the brief, your voice guide and the checklist, then marks it ready or sends it back with fixes.
  • Learns from you. Each month it records how merged articles performed and why you rejected others, and proposes changes to its own rules.

Your part

Run one command a day, /seo-agent:run, or schedule it on a Mac to run every weekday morning. It works out what the day needs: planning on Monday, a new article on Tuesday, refreshes midweek, fixes on Friday. Nothing is published without a pull request, and you do the merging and deploying. There is no server and no database. Its memory is a folder of files in your repo.

What you need

  • Claude Code, Node 18 or newer, git and the GitHub CLI.
  • A product site whose articles live in a GitHub repo.
  • A DataForSEO account, pay as you go. A keyword run costs about $0.50 to $1.00, and spend caps are built in.
  • Optional: Google Search Console access, for refreshes and the monthly results.
  • Optional: a Mac, for the hands-off morning schedule.

Members download this agent from this page.

See Premium