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