// 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.
| name | seo-agent |
| description | 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. |
| metadata | {"openclaw":{"emoji":"🔄","user-invocable":true,"homepage":"https://bigplayers.co","requires":{"env":["DATAFORSEO_LOGIN","DATAFORSEO_PASSWORD"],"tools":["curl","jq"]}}} |
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."
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.
Positions 5–20 are where SEO leverage lives.
The Agent focuses energy here by default.
All scripts live in ~/clawd/skills/seo-agent/scripts/. All use bash + curl + jq. No Python. No npm.
./seo-discover.sh --site sc-domain:example.com [--seeds "keyword1,keyword2"] [--limit 20]
What it does:
Output fields: keyword, current_position, search_volume, competition, opportunity_score
Add --json for raw machine-readable output. Default is a human-readable table.
./seo-monitor.sh --site sc-domain:example.com [--days 28]
What it does:
~/clawd/workspace/seo-agent/snapshots/Snapshots stored at: ~/clawd/workspace/seo-agent/snapshots/SITE-YYYY-MM-DD.json
./seo-compete.sh --site example.com --competitor competitor.com [--limit 30]
What it does:
This feeds directly back into DISCOVER as a seed list.
On first use, create ~/clawd/workspace/seo-agent/config.yaml:
site: "sc-domain:example.com"
competitors:
- competitor1.com
- competitor2.com
content_directory: "./content"
monitor_frequency: "weekly"
target_positions: [5, 20] # the strike zone
min_search_volume: 100
Scripts read this config automatically. Override any setting with CLI flags.
export DATAFORSEO_LOGIN=your@email.com
export DATAFORSEO_PASSWORD=yourpassword
Same auth as gsc-report. If you've set that up, you're ready.
Options:
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.jsongcloud auth application-default loginexport GOOGLE_ACCESS_TOKEN=ya29.xxxFind your exact property URL in Search Console. It's either:
https://example.com (URL prefix property)sc-domain:example.com (domain property — broader, recommended)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.
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
When you run the SEO Agent loop, Claude:
workspace/brand/learnings.md with what's working| 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
| 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 |
Most people do SEO once and forget it. They publish and pray.
The SEO Agent turns SEO into a system. Every week you know:
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.
Matt Berman's custom SEO content engine. Learns your brand through a smart interview, then creates content that ranks AND converts using Puppet Strings, Scroll Traps, and Care To Click psychology. Anti-AI-Overview by design. DataForSEO integrated. The content your competitors can't copy because it requires real experience.
Generate premium SEO article images using Nano Banana 2. Six locked-in visual styles with cinema-grade JSON prompts. No stock photo slop.
SEO technical checklist and publishing reference. Meta tags, schema markup, llms.txt, topical authority, internal linking rules, Core Web Vitals targets, and image optimization. The agent uses this when publishing content. You can use it to audit existing pages.
Technical SEO monitoring. Weekly PageSpeed audits, Core Web Vitals tracking, crawl health checks, image optimization, and mobile usability. Catches problems before they tank your rankings.
Backlink acquisition engine. Mines competitor backlinks, finds unlinked brand mentions, discovers broken link opportunities, audits internal linking, and prospects resource pages. Turns link building from guesswork into a repeatable system.