seo-ops

1# AI SEO Ops
2 
3## Preamble (runs on skill start)
4 
5```bash
6# Version check (silent if up to date)
7python3 telemetry/version_check.py 2>/dev/null || true
8 
9# Telemetry opt-in (first run only, then remembers your choice)
10python3 telemetry/telemetry_init.py 2>/dev/null || true
11```
12 
13> **Privacy:** This skill logs usage locally to `~/.ai-marketing-skills/analytics/`. Remote telemetry is opt-in only. No code, file paths, or repo content is ever collected. See `telemetry/README.md`.
14 
15---
16 
17AI-powered SEO operations: keyword intelligence, competitor gap analysis, GSC optimization, and trend detection.
18 
19## When to Use
20 
21- User asks for keyword research, content brief, or SEO analysis
22- User wants to find quick-win keywords from Google Search Console
23- User needs a competitor gap analysis
24- User wants to identify trending topics for content creation
25- User asks about decaying content or traffic drops
26- User wants a prioritized list of keywords to target
27 
28## Tools
29 
30### Content Attack Brief (`content_attack_brief.py`)
31 
32Full keyword intelligence pipeline. Requires `AHREFS_TOKEN` and GSC auth.
33 
34```bash
35# Run the full brief
36python content_attack_brief.py
37```
38 
39**What it produces:**
40- Topic fingerprint from your content library
41- BOFU money keywords ranked by Impact × Confidence
42- Trending keywords with sparkline visualizations
43- Competitor gap analysis (keywords they rank for, you don't)
44- Decaying page alerts (traffic drops >30%)
45- Execution pipeline (auto-create → semi-auto → team)
46…