About this template
An SEO agent that runs your Monday for you — and gets your pages into Google
You already know what good SEO looks like.
What you do not have is 90 minutes every Monday to pull Search Console, open DataForSEO, write the diagnosis and stage the fixes — nor a daily habit of checking which pages Google still hasn't indexed. This template is that Monday on a loop plus a daily index-coverage sweep, inside your own Hermes VM.
What the SEO agent does each week
- Measure — Google Search Console for your clicks, impressions, CTR and position. DataForSEO for who outranks you, volume and SERP features.
- Prioritize — striking-distance keywords at positions 4–20, high-impression low-CTR pages, cannibalization, decay.
- Stage — exact titles, metas, sections and internal links. Not a vague "write more content" list.
- Verify — next week it opens last week's report and checks what actually moved.
Step 4 is the whole point. An agent that only recommends is a report generator with better manners.
New — daily index coverage (get pages into Google fast)
Publishing a page is not the same as Google indexing it. The seo-index-coverage skill runs every day:
- Reads your
sitemap.xml— the set of pages that should be indexed. - Checks each against the GSC URL Inspection API (concurrently) to find the ones Google has not indexed.
- Submits those to Google's Indexing API — capped to the daily quota, with a per-URL cooldown so nothing is spammed, and only ever your own on-property URLs.
- Writes a dated receipt and emails you the summary (submitted / already-indexed / failures) — the same delivery as the weekly report.
It fails closed and only cries "revoked permission" on an actual 403, so a quiet run means it worked. One-time setup: make your service account an Owner of the property and enable the Web Search Indexing API.
Every run — weekly or daily — writes a receipt, including the runs that fail. A scheduled agent that finishes quietly is indistinguishable from one that never fired; the receipt is what tells those two apart.
What you get on fork
- An agency SOUL holding the doctrine: measure, stage, verify — and index.
- SEO + marketing skills —
seo-rank-loop,seo-workspace, and the newseo-index-coverage, plusseo-audit,ai-seo,schema,site-architecture,content-strategy,programmatic-seo,marketing-loops,competitors,copy-editing,analytics. - Read-only Search Console helpers (service-account JWT scripts) + the indexing engine (
gsc_index.py, pure stdlib). - A DataForSEO helper over REST, with optional MCP for the competitive layer.
The ~/seo/ workspace is scaffolded for you on fork. Weekly artifacts land in ~/seo/runs/YYYY-MM-DD/; daily index receipts land in ~/seo/index-runs/YYYY-MM-DD/.
What you supply
| Env | What it is |
|---|---|
OPENROUTER_API_KEY | your Hermes model key |
GSC_CREDENTIALS_JSON | Google service-account JSON, one line |
GSC_PROPERTY | e.g. sc-domain:yoursite.com |
DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD | DataForSEO credentials |
NOTIFY_FROM / NOTIFY_TO | optional — to email yourself the daily/weekly receipts |
For the weekly rank loop, add the service-account email to Search Console as a Restricted user. For the daily indexing, it needs Owner (the Indexing API requires it) and the Web Search Indexing API enabled in your GCP project. DataForSEO fees and model usage are billed to you, by them.
Your first hour
- Fork it and open the Hermes session.
- Put the keys above in
~/.hermes/.env. - Fill
~/seo/client-profile.md. - Run the weekly loop once, stage-only; run the index-coverage skill once.
- Schedule the rank loop for Monday 09:00 and index-coverage daily.
Then leave it alone.
Honest limits
- It will not guarantee a #1 ranking, and the Indexing API is a request to crawl, not a promise to index.
- It will not auto-merge to your default branch.
- It will not invent rankings when GSC or DataForSEO is down. It tells you the data is missing.
- It only ever submits your own on-property URLs, and never a redirected or dead one.
- Google officially scopes the Indexing API to job-posting/livestream pages; it works for ordinary pages in practice, and the daily receipt surfaces any 403 immediately.
- Hermes only. Principles match Atom Eve's SEO Improver — GSC primary, DataForSEO competitive, weekly loop — but there is no Eve install here.
Fork it and run one loop stage-only before you trust it with a title tag. Your first jurniti purchase carries a 30-day money-back guarantee.