SEO Automation

Enterprise Tier Automated SEO operations — content briefs, keyword scanning, and performance reports, all on autopilot inside your Hermes agent.

Three autonomous features:

ON-DEMAND Type /seo brief [topic] to get a structured content brief from live SERP analysis.
WEEKLY CRON Keyword scanner finds quick-win opportunities from GSC positions 4-10 every Monday.
WEEKLY CRON Performance report tracks clicks, impressions, CTR, and flags anomalies every Sunday.

What It Does

1. Content Brief Generator

Type /seo brief [topic] and Hermes researches the SERP, analyzes top-ranking pages, identifies content gaps, and delivers a structured brief for your human writers.

Brief Section	What It Contains
Target keyword & search intent	Commercial, informational, navigational, or transactional classification
SERP landscape	Top 5 ranking pages compared: titles, headings, word count, format
Content gaps	Topics competitors are missing — your differentiation opportunity
Recommended headings	H1-H3 outline optimized for the SERP features detected
Writing prompts	Section-by-section AI-generated suggestions (writer must verify)
Related keywords	Semantic variations to include for topical coverage
Sources	URLs used for SERP analysis — full transparency

2. Keyword Opportunity Scanner

Every Monday at 6AM, the skill queries Google Search Console for keywords in positions 4-10 with high impressions and low CTR — your biggest quick-wins.

Metric	How It's Used
Impressions (28-day)	Filters for meaningful volume (>500 impressions)
Position	Keywords in positions 4-10 (close enough to improve)
CTR	Low CTR (<2%) = high optimization potential
Opportunity score	`(impressions x (0.10 - CTR) x (10 - position)) / 100`

3. Weekly Performance Report

Every Sunday at 10PM, a complete SEO performance digest comparing the current week against the previous week.

Section	What's in it
Executive summary	2-3 sentence overview: clicks, impressions, CTR, position trends
Performance table	Side-by-side: current week vs previous week, % change, trend indicators
Top gainers	Keywords with biggest click increases (with position changes)
Top losers	Keywords with biggest click decreases
Anomaly flags	>50% click drop + >3 position drop = critical alert
Recommendations	What to investigate, what to double down on

What It Does NOT Do

No auto-publishing. Content briefs are for your human writers to execute. This skill does not connect to WordPress, Netlify, or any CMS.
No daily AI blog generation. Cron jobs run weekly only. Daily AI-generated content violates Google's scaled content abuse policy.
No ranking guarantees. This skill analyzes data and generates briefs. SEO outcomes depend on content quality, domain authority, and competition.

Setup

1. Configure GSC Credentials

# Create a Google Cloud service account with Search Console API access
# Add the service account email as a verified owner in GSC

echo "GOOGLE_APPLICATION_CREDENTIALS=$HOME/.hermes/gsc-key.json" >> ~/.hermes/.env
echo "GSC_SITE_URL=sc_domain:yourdomain.com" >> ~/.hermes/.env

2. (Optional) Add DataForSEO for Richer SERP Data

echo "DATAFORSEO_LOGIN=your@email.com" >> ~/.hermes/.env
echo "DATAFORSEO_PASSWORD=your_password" >> ~/.hermes/.env

3. Schedule the Weekly Cron Jobs

# Keyword Scanner — Monday 6AM
hermes cron create \
  "0 6 * * 1" \
  --name "seo-keyword-scanner" \
  --skills "seo-automation" \
  --model "deepseek/deepseek-v4-flash" \
  --provider "openrouter"

# Weekly Performance Report — Sunday 10PM
hermes cron create \
  "0 22 * * 0" \
  --name "seo-weekly-report" \
  --skills "seo-automation" \
  --model "deepseek/deepseek-v4-flash" \
  --provider "openrouter"

Example Commands

All commands work via Telegram or CLI:

/seo brief enterprise AI agents — Generate a content brief with full SERP analysis
/seo serp AI agent consulting — Quick SERP overview for any keyword
/seo scan — Run the keyword opportunity scanner now
/seo report — Generate a weekly performance report now
/seo status — Check GSC connection and cron job status
/seo setup — Interactive setup wizard
help SEO — List all available commands

Requirements

hermes tools enable web
hermes tools enable terminal
hermes tools enable file

Google Search Console access is required for Features 2 (Keyword Scanner) and 3 (Weekly Report). Without GSC, only Feature 1 (Content Briefs) is available via web search.

GSC data is 2-3 days behind real-time. Reports always show "data as of 3 days ago." This is normal and documented in every report.

Production Test Results

PASSED — Tested 2026-05-11 with live SERP data

Test	Result
Content brief generation (live SERP)	PASS 15 results, 5 gaps identified, 140-line brief
GSC query error handling (no credentials)	PASS Graceful failure with clear fix message
Keyword scoring algorithm	PASS 5 keywords ranked correctly with quick-win actions
Weekly report simulation	PASS Executive summary, gainers/losers, anomaly detection
Anomaly thresholds	PASS >50% click drop correctly flagged as warning
Python script compilation	PASS gsc-query.py + dataforseo-serp.py compile clean
No auto-publish language	PASS Verified across all 12 files
PII leak check	PASS All /home/catta/ paths replaced with $HOME