System Documentation

What problem does it solve?

AI SEO Ops replaces manual keyword research, competitor gap analysis, GSC-based optimization, and trend monitoring with an automated workflow that produces ranked, ready-to-execute SEO opportunities.

Core Features & Use Cases

  • Content Attack Brief Generator: Builds a weekly prioritized keyword brief using your 30-day content fingerprint plus Ahrefs keyword data, GSC performance, competitor gaps, and decaying-page alerts.
  • GSC Keyword Optimizer & Analytics: Finds “striking distance” keywords (queries ranking around positions 4–20), identifies quick-win opportunities, and supports multiple GSC query modes (top queries/pages, devices, countries, trends).
  • Trend Scout: Detects fast-rising topics across Google Trends, Hacker News, Reddit, and X/Twitter (via Brave Search) and suggests content angles aligned to your configured content verticals.

Quick Start

Run content_attack_brief.py after setting your Google Search Console OAuth credentials and filling in the required environment variables in .env.

Dependency Matrix

Required Modules

requestsgoogle-api-python-clientgoogle-authgoogle-auth-httplib2

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: AI SEO Ops
Download link: https://github.com/ericosiu/ai-marketing-skills/archive/main.zip#ai-seo-ops

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.