Skip to content
Back to search

seo-kit

AI agent that finds keywords, writes content, monitors rankings, and self-improves. Two OpenClaw skills that chain into a compounding SEO loop.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/themattberman--seo-kit/badge.svg)](/listings/themattberman--seo-kit)

HTML

<a href="/listings/themattberman--seo-kit"><img src="/api/listings/themattberman--seo-kit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- [OpenClaw](https://github.com/openclaw/openclaw) installed and running - Google Search Console access for your site - (Optional) [DataForSEO](https://dataforseo.com) API account (~$50/month)

1. Clone and install

git clone https://github.com/TheMattBerman/seo-kit.git
cp -r seo-kit/skills/* ~/clawd/skills/

2. Set up auth

See [SETUP.md](./SETUP.md) for Google Search Console OAuth and DataForSEO credentials.

3. Run the health check

bash skills/seo-agent/scripts/seo-check.sh
bash skills/seo-health/scripts/health-speed.sh https://yoursite.com --both

4. Let the agent interview you

Tell your OpenClaw agent: *"Run the SEO Forge brand interview"*

8 questions. 5 minutes. Every article after this sounds like you.

5. Set it on a schedule

Monday:    seo-discover + seo-monitor + health checks
Tuesday:   Write content targeting top opportunities
Wednesday: link-internal (add cross-links to new content)
Thursday:  link-mine + link-mentions (find backlink targets)
Friday:    seo-compete on one competitor + link-prospect

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 321 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # SEO Kit for OpenClaw
  2. An AI agent that finds keywords, writes content, builds backlinks, monitors rankings, and self-improves. Four skills that chain into a compounding loop.
  3. **Built by [Matt Berman](https://x.com/TheMattBerman) / [Big Players](https://bigplayers.co)**
  4. ---
  5. ## What This Does
  6. Most people know what to do for SEO. Nobody does it consistently.
  7. This agent does:
  8. 1. **Discovers** keyword opportunities from your actual Google Search Console data
  9. 2. **Writes** psychology-driven content in your brand voice (not generic AI slop)
  10. 3. **Builds links** through competitor mining, unlinked mentions, and broken link outreach
  11. 4. **Monitors** rankings weekly and flags what's climbing or dropping
  12. 5. **Checks health** with PageSpeed audits, crawl checks, and image optimization
  13. 6. **Repeats** automatically, getting smarter about your brand every week
  14. The loop is the point. Each cycle feeds the next one.
  15. ---
  16. ## The Four Skills
  17. ### skills/seo-agent — Discovery + Monitoring
  18. The brain that finds opportunities and tracks progress.
  19. | Script | What It Does |
  20. |--------|-------------|
  21. | `seo-discover.sh` | Finds strike zone keywords (positions 5-20) from GSC + DataForSEO |
  22. | `seo-monitor.sh` | Weekly ranking snapshots, flags climbers and droppers |
  23. | `seo-compete.sh` | Competitor gap analysis: keywords they rank for that you don't |
  24. ### skills/seo-forge — Content Engine
  25. The writer that sounds like you, not like ChatGPT.
  26. | Script | What It Does |
  27. |--------|-------------|
  28. | `seo-interview.sh` | 8 questions that build your brand voice and positioning |
  29. | `seo-research.sh` | SERP analysis, People Also Ask, search intent classification |
  30. | `seo-check.sh` | Validates your GSC and DataForSEO connections |
  31. **What makes it different:** Interview mode learns your voice. Weekly refinement keeps it current. Psychology frameworks make content convert, not just rank. Anti-AI-Overview strategy bakes in real experience markers.
  32. ### skills/seo-links — Backlink Acquisition
  33. Content without links is a prayer. This skill finds link opportunities.
  34. | Script | What It Does |
  35. |--------|-------------|
  36. | `link-mine.sh` | Mines competitor backlink profiles for targets |
  37. | `link-mentions.sh` | Finds unlinked brand mentions (easiest links to get) |
  38. | `link-broken.sh` | Finds broken links on resource pages, pitches your content |
  39. | `link-internal.sh` | Audits internal linking, finds orphan pages |
  40. | `link-prospect.sh` | Finds "best tools" and resource pages to get listed on |
  41. ### skills/seo-images — AI Image Generation
  42. Publication-quality images for your SEO content. No stock photos.
  43. | Style | What It Produces |
  44. |-------|-----------------|
  45. | `founder_editorial` | Cinematic portraits — Leica M11, A24 aesthetic, magazine quality |
  46. | `dark_data` | Dashboard stat cards — Bloomberg meets Stripe, bold metrics |
  47. | `product_lifestyle` | Editorial product photography — Phase One quality |
  48. | `social_card` | Typography-forward share cards — scroll-stopping at thumbnail |
  49. | `warm_lifestyle` | Bright aspirational lifestyle — Portra 400 film stock |
  50. | `cinematic_scene` | Movie-still narratives — ARRI Alexa, director references |
  51. **21 presets** across 6 styles. **6 vertical routing maps** (SaaS, DTC, newsletter, agency, AI/tech, finance) that auto-select the right style for your content.
  52. Integrates with SEO Forge — after writing an article, it offers to generate hero images, inline visuals, and social share cards matched to your content's vertical.
  53. ```bash
  54. # Quick generate
  55. bash skills/seo-images/scripts/generate.sh --style dark_data --preset revenue_card \
  56. --headline '"$200M/Year"' --ratio 16:9 --output hero.png
  57. # Dry run (no API needed)
  58. bash skills/seo-images/scripts/generate.sh --style cinematic_scene --preset late_night_office \
  59. --context "Founder building AI agents" --ratio 21:9 --dry-run
  60. # List all styles and presets
  61. bash skills/seo-images/scripts/generate.sh --list-styles
  62. ```
  63. Requires: `REPLICATE_API_TOKEN` (or `GOOGLE_AI_API_KEY` for Google AI Studio). See skill SKILL.md for setup.
  64. ### skills/seo-health — Technical SEO Monitoring
  65. Rankings depend on a solid technical foundation.
  66. | Script | What It Does |
  67. |--------|-------------|
  68. | `health-speed.sh` | PageSpeed + Core Web Vitals (LCP, INP, CLS) |
  69. | `health-crawl.sh` | Broken links, missing meta tags, redirect chains, mixed content |
  70. | `health-images.sh` | Oversized images, missing alt text, wrong formats |
  71. ### skills/seo-checklist — Reference
  72. Technical SEO reference covering meta tags, schema markup (Article, FAQ, HowTo), llms.txt, topical authority (hub-and-spoke), and Core Web Vitals thresholds.
  73. ---
  74. ## Quick Start
  75. ### Prerequisites
  76. - [OpenClaw](https://github.com/openclaw/openclaw) installed and running
  77. - Google Search Console access for your site
  78. - (Optional) [DataForSEO](https://dataforseo.com) API account (~$50/month)
  79. ### 1. Clone and install
  80. ```bash
  81. git clone https://github.com/TheMattBerman/seo-kit.git
  82. cp -r seo-kit/skills/* ~/clawd/skills/
  83. ```
  84. ### 2. Set up auth
  85. See [SETUP.md](./SETUP.md) for Google Search Console OAuth and DataForSEO credentials.
  86. ### 3. Run the health check
  87. ```bash
  88. bash skills/seo-agent/scripts/seo-check.sh
  89. bash skills/seo-health/scripts/health-speed.sh https://yoursite.com --both
  90. ```
  91. ### 4. Let the agent interview you
  92. Tell your OpenClaw agent: *"Run the SEO Forge brand interview"*
  93. 8 questions. 5 minutes. Every article after this sounds like you.
  94. ### 5. Set it on a schedule
  95. ```
  96. Monday: seo-discover + seo-monitor + health checks
  97. Tuesday: Write content targeting top opportunities
  98. Wednesday: link-internal (add cross-links to new content)
  99. Thursday: link-mine + link-mentions (find backlink targets)
  100. Friday: seo-compete on one competitor + link-prospect
  101. ```
  102. ---
  103. ## The Complete Loop
  104. ```
  105. Week 1: Discover keywords → Write 3 articles → Add internal links
  106. Run health check → Fix any technical issues
  107. Week 2: Monitor rankings → Write supporting content for climbers
  108. Mine competitor backlinks → Send outreach
  109. Week 3: Competitor gap analysis → Find 8 new keywords
  110. Find unlinked mentions → Easy outreach wins
  111. Week 4: Articles hitting page 1 → Organic traffic up
  112. Agent is already 3 weeks ahead of you
  113. Repeat forever.
  114. ```
  115. ---
  116. ## API Keys and What's Free
  117. Every script works without paid APIs. Some get better with them. Here's the breakdown:
  118. ### Free (no API key needed)
  119. | Script | What It Uses |
  120. |--------|-------------|
  121. | `seo-monitor` | Google Search Console (OAuth) |
  122. | `seo-discover` (GSC-only mode) | Google Search Console |
  123. | `seo-check` | Google Search Console |
  124. | `seo-interview` | Your brain |
  125. | `health-speed` | Google PageSpeed Insights API (free, rate-limited) |
  126. | `health-crawl` | Direct HTTP crawl |
  127. | `health-images` | Direct HTTP crawl |
  128. | `link-internal` | Your sitemap + direct crawl |
  129. | All link scripts (fallback) | Web search queries (manual or via agent) |
  130. ### Google Search Console (free, requires OAuth setup)
  131. Required for: `seo-discover`, `seo-monitor`, `seo-compete`
  132. This is where your real ranking data comes from. Not estimates. Your actual positions, clicks, and impressions from Google. Setup takes 5 minutes. See [SETUP.md](./SETUP.md).
  133. ### DataForSEO (~$50/month, optional)
  134. Required for full features of: `seo-discover`, `seo-compete`, `link-mine`, `link-mentions`, `link-broken`, `link-prospect`
  135. DataForSEO is the API behind most SEO tools. Direct access costs a fraction of what Ahrefs or Semrush charge. It adds:
  136. - **Search volumes** for discovered keywords
  137. - **Keyword expansion** (suggestions + related keywords)
  138. - **Competitor keyword gaps** (what they rank for, you don't)
  139. - **SERP data** for link prospecting and mention discovery
  140. - **Backlinks data** (separate subscription within DataForSEO)
  141. Without it, `seo-discover` still works using GSC data alone (scored by impressions instead of search volume). Link scripts fall back to web search queries you can run manually.
  142. Sign up at [dataforseo.com](https://dataforseo.com). Set `DATAFORSEO_LOGIN` and `DATAFORSEO_PASSWORD` in your environment.
  143. ### PageSpeed Insights API Key (free, optional)
  144. Recommended for: `health-speed`
  145. Without a key: rate-limited (a few requests per minute). With a free API key: 25,000 queries/day.
  146. Get one at [Google Cloud Console](https://console.cloud.google.com/apis/credentials) and enable the PageSpeed Insights API. Set `PAGESPEED_API_KEY` in your environment.
  147. ### Replicate API (image generation, optional)
  148. Required for: `seo-images`
  149. Nano Banana 2 (Google Gemini 3.1 Flash Image) runs on Replicate. ~$0.02-0.05 per image at 1K, ~$0.08-0.12 at 2K.
  150. Sign up at [replicate.com](https://replicate.com). Set `REPLICATE_API_TOKEN` in your environment.
  151. **Alternative:** Use Google AI Studio (`GOOGLE_AI_API_KEY`) for free-tier access, or fal.ai (`FAL_KEY`). The skill generates structured prompts — pipe them to any provider.
  152. ### What You Actually Need
  153. | Level | APIs | Monthly Cost | What Works |
  154. |-------|------|-------------|------------|
  155. | **Starter** | GSC only | $0 | Discovery (GSC mode), monitoring, health checks, internal links |
  156. | **Starter + Images** | GSC + Replicate | ~$5 | Above + AI-generated article images |
  157. | **Full** | GSC + DataForSEO | ~$50 | Everything: volumes, expansion, competitor gaps, SERP-based link prospecting |
  158. | **Full + Images** | GSC + DataForSEO + Replicate | ~$55 | Everything + publication-quality images |
  159. | **Full + Backlinks** | GSC + DataForSEO + Backlinks addon | ~$100 | Everything + competitor backlink mining |
  160. Start at $0. Add DataForSEO when you want search volumes and competitor analysis.
  161. ---
  162. ## Cost Comparison
  163. | The Old Way | The Agent Way |
  164. |-------------|--------------|
  165. | Semrush: $200/mo | DataForSEO: $50/mo (or $0) |
  166. | Ahrefs: $200/mo | GSC: free |
  167. | Surfer: $89/mo | PageSpeed API: free |
  168. | Jasper: $80/mo | OpenClaw: free |
  169. | SEO freelancer: $5k/mo | SEO Kit: free |
  170. | **Total: $5,569/mo** | **Total: $0-50/mo** |
  171. ---
  172. ## File Structure
  173. ```
  174. seo-kit/
  175. skills/
  176. seo-agent/ # Discovery + monitoring
  177. SKILL.md
  178. scripts/
  179. seo-discover.sh
  180. seo-monitor.sh
  181. seo-compete.sh
  182. seo-forge/ # Content engine
  183. SKILL.md
  184. scripts/
  185. seo-interview.sh
  186. seo-research.sh
  187. seo-check.sh
  188. seo-links/ # Backlink acquisition
  189. SKILL.md
  190. scripts/
  191. link-mine.sh
  192. link-mentions.sh
  193. link-broken.sh
  194. link-internal.sh
  195. link-prospect.sh
  196. seo-images/ # AI image generation
  197. SKILL.md
  198. scripts/
  199. generate.sh
  200. styles/
  201. founder_editorial.json
  202. dark_data.json
  203. product_lifestyle.json
  204. social_card.json
  205. warm_lifestyle.json
  206. cinematic_scene.json
  207. verticals.json
  208. references/ # Gold-standard reference images (add your own)
  209. seo-health/ # Technical monitoring
  210. SKILL.md
  211. scripts/
  212. health-speed.sh
  213. health-crawl.sh
  214. health-images.sh
  215. seo-checklist/ # Reference docs
  216. CHECKLIST.md
  217. SOUL.md
  218. AGENTS.md
  219. SETUP.md
  220. README.md
  221. ```
  222. ---
  223. ## More OpenClaw Kits
  224. - [meta-ads-kit](https://github.com/TheMattBerman/meta-ads-kit) — AI agent that runs your Meta ads
  225. - [first-1000-kit](https://github.com/TheMattBerman/first-1000-kit) — AI agent that finds your first 1000 customers
  226. ---
  227. ## License
  228. MIT. Do whatever you want with it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.