Self-improving SEO system. Finds keywords via DataForSEO, writes content that ranks, monitors GSC for what's climbing, then writes MORE content to push winners higher. A feedback loop, not a one-shot tool.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Self-improving SEO system. Finds keywords via DataForSEO, writes content that ranks, monitors GSC for what's climbing, then writes MORE content to push winners higher. A feedback loop, not a one-shot tool.
Most SEO tools do one thing. Discover keywords. Write content. Check rankings. Done.
This isn't that.
The SEO Agent is a feedback loop — a system that finds opportunities, acts on them, watches what happens, and feeds those results back into the next round of work. Every cycle makes the next cycle smarter. Rankings climb. The content library grows. And you're always pushing the keywords that are already moving instead of starting from scratch.
"Don't just rank. Rank, learn, and rank higher."
The Loop
DISCOVER → WRITE → MONITOR → OPTIMIZE → REPEAT
1. DISCOVER (seo-discover.sh)
Pull your current GSC rankings. Find what's in the strike zone (positions 5-20). Hit DataForSEO for related keywords you're missing. Score opportunities by volume, competition, and current position. Output a prioritized hit list.
2. WRITE (You + Claude)
Take the top opportunity from discovery. Generate publication-ready SEO content — outline, draft, optimized headers, FAQs, schema markup. Brand voice from workspace/brand/voice-profile.md baked in.
3. MONITOR (seo-monitor.sh)
Run weekly. Pull current GSC data. Compare to last snapshot. Flag what's climbing, what's dropping, what just cracked the strike zone. This is your radar.
4. OPTIMIZE (seo-compete.sh + Claude)
Take the winners from monitoring — content climbing from 15 → 8. Write supporting articles that link to them. Add internal links from existing content. Push the climbers over the finish line.
5. REPEAT
Discovery now has more context. Monitor has more history. Every loop compounds.
The Strike Zone
Positions 5–20 are where SEO leverage lives.
Position 1–4: Already winning. Defend.
Position 5–20: ⚡ THE STRIKE ZONE — close enough to move, not yet getting the clicks. A supporting article, better internal links, or a refreshed page can jump these 5–10 spots. That's the difference between 2% CTR and 8% CTR.
Position 21+: Too far out. Needs a full content build.
The Agent focuses energy here by default.
Scripts
All scripts live in ~/clawd/skills/seo-agent/scripts/. All use bash + curl + jq. No Python. No npm.
Drop your brand voice profile at ~/clawd/workspace/brand/voice-profile.md. The agent reads this when generating content briefs and drafts. Run the brand-voice skill first if you haven't.
Running the Full Loop
Week 1 — Discovery
Run: seo-discover.sh --site your-site --limit 20
Output: Prioritized keyword hit list
Action: Pick top 3 opportunities → generate content with Claude
Week 2+ — Monitor + Optimize
Run: seo-monitor.sh --site your-site
Output: What moved, what's in strike zone
Action: Find climbers → write supporting content → add internal links
Ongoing — Compete
Run: seo-compete.sh --site your-site --competitor their-site
Output: Their keywords, your gaps
Action: Feed gaps back into discovery as seeds
How Claude Uses This
When you run the SEO Agent loop, Claude:
Reads discovery output → selects the best opportunity based on your goals
Generates a full content brief: target keyword, secondary keywords, outline, angle, word count, FAQ section, schema markup suggestions
Drafts the article (or hands off outline for your writer)
Reads monitor output → identifies what to optimize next
Writes supporting articles with internal link strategy built in
Updatesworkspace/brand/learnings.md with what's working
DataForSEO Endpoints Used
Purpose
Endpoint
Keyword volume
POST /v3/keywords_data/google_ads/search_volume/live
Related keywords
POST /v3/keywords_data/google_ads/keywords_for_keywords/live
Keyword expansion
POST /v3/dataforseo_labs/google/keyword_suggestions/live
SERP check
POST /v3/serp/google/organic/live/advanced
Competitor keywords
POST /v3/dataforseo_labs/google/competitors_domain/live
Keyword gaps
POST /v3/dataforseo_labs/google/domain_intersection/live
API base: https://api.dataforseo.com
Auth: HTTP Basic — $DATAFORSEO_LOGIN:$DATAFORSEO_PASSWORD
Output Files
Path
Contents
workspace/seo-agent/snapshots/SITE-DATE.json
Weekly ranking snapshots
workspace/seo-agent/config.yaml
Your site config
workspace/brand/learnings.md
Ranking insights (appended)
workspace/brand/keyword-plan.md
Active keyword targets
Why This Works
Most people do SEO once and forget it. They publish and pray.
The SEO Agent turns SEO into a system. Every week you know:
What moved
Why it moved
What to do next
Compound that for 6 months and you've got a content moat competitors can't buy their way out of.
The scripts are the engine. You (and Claude) are the brain. Together, that's the loop.
