# seranking/seo-skills architecture

> Architecture diagram of the GitHub repository seranking/seo-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/seranking/seo-skills
- Repository: https://github.com/seranking/seo-skills

## Overview

Claude SEO Skills is a Claude-agent SEO toolkit: a user selects a skill, which guides research and turns SEO data into a finished deliverable. The README describes SE Ranking’s remote MCP as the primary data integration and documents a broad skill catalogue, including audits, keyword research, competitive analysis, reporting, and planning. The local `seo-google` scripts provide a separate Google-data capability, with shared credential handling and report generation. Edges are limited to relationships stated in the README or visible in excerpts; most individual skill internals were not sampled.

Main entry points: [`skills/seo-google/SKILL.md`](https://github.com/seranking/seo-skills/blob/main/skills/seo-google/SKILL.md) (Google SEO tools), [`scripts/gsc_query.py`](https://github.com/seranking/seo-skills/blob/main/scripts/gsc_query.py) (Google API scripts), [`skills/seo-keyword-cluster/SKILL.md`](https://github.com/seranking/seo-skills/blob/main/skills/seo-keyword-cluster/SKILL.md) (Keyword research), [`skills/seo-keyword-niche/SKILL.md`](https://github.com/seranking/seo-skills/blob/main/skills/seo-keyword-niche/SKILL.md) (Niche research)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_research["Research &amp; Discovery"]
  node_keyword["Keyword research<br/>[SKILL.md]"]
  node_niche["Niche research<br/>[SKILL.md]"]
  node_ads["Paid search<br/>[SKILL.md]"]
  node_backlinks["Backlink research<br/>[SKILL.md]"]
  node_competitors["Competitor research<br/>[SKILL.md]"]
end

subgraph group_analysis["Analysis &amp; Audits"]
  node_page["Page intelligence<br/>[SKILL.md]"]
  node_technical["Technical audit<br/>[SKILL.md]"]
  node_contentaudit["Content audit<br/>[SKILL.md]"]
  node_drift["Drift monitoring<br/>[SKILL.md]"]
  node_sxo["SXO diagnostics<br/>[SKILL.md]"]
  node_ai_visibility["AI visibility<br/>[SKILL.md]"]
end

subgraph group_strategy["Strategy &amp; Content"]
  node_contentbrief["Content briefs<br/>[SKILL.md]"]
  node_planning["SEO planning<br/>[SKILL.md]"]
  node_geo["Generative SEO<br/>[SKILL.md]"]
  node_local["Local SEO<br/>[SKILL.md]"]
  node_schema["Structured data<br/>[SKILL.md]"]
end

subgraph group_integrations["Data Integrations"]
  node_google_skills["Google SEO tools<br/>[SKILL.md]"]
  node_google_scripts["Google API scripts<br/>[gsc_query.py]"]
  node_google_auth["Google credentials<br/>[google_auth.py]"]
  node_google_report["Google reports<br/>[google_report.py]"]
end

node_user(("SEO practitioner"))
node_seranking{{"SE Ranking MCP"}}

node_user -->|"selects skill"| node_keyword
node_user -->|"selects skill"| node_niche
node_user -->|"selects skill"| node_ads
node_user -->|"selects skill"| node_backlinks
node_user -->|"selects skill"| node_competitors
node_user -->|"selects skill"| node_page
node_user -->|"selects skill"| node_technical
node_user -->|"selects skill"| node_contentaudit
node_user -->|"selects skill"| node_drift
node_user -->|"selects skill"| node_sxo
node_user -->|"selects skill"| node_ai_visibility
node_user -->|"selects skill"| node_contentbrief
node_user -->|"selects skill"| node_planning
node_user -->|"selects skill"| node_geo
node_user -->|"selects skill"| node_local
node_user -->|"selects skill"| node_schema
node_user -->|"selects skill"| node_google_skills
node_seranking -->|"supplies SEO data"| node_keyword
node_seranking -->|"supplies SEO data"| node_niche
node_seranking -->|"supplies SEO data"| node_ads
node_seranking -->|"supplies SEO data"| node_backlinks
node_seranking -->|"supplies SEO data"| node_competitors
node_seranking -->|"supplies SEO data"| node_page
node_seranking -->|"supplies SEO data"| node_technical
node_seranking -->|"supplies SEO data"| node_contentaudit
node_seranking -->|"supplies SEO data"| node_drift
node_seranking -->|"supplies SEO data"| node_sxo
node_seranking -->|"supplies SEO data"| node_ai_visibility
node_seranking -->|"supplies SEO data"| node_contentbrief
node_seranking -->|"supplies SEO data"| node_planning
node_google_skills -->|"uses scripts"| node_google_scripts
node_google_scripts -->|"loads credentials"| node_google_auth
node_google_skills -.->|"generates reports"| node_google_report

click node_keyword "https://github.com/seranking/seo-skills/blob/main/skills/seo-keyword-cluster/SKILL.md"
click node_niche "https://github.com/seranking/seo-skills/blob/main/skills/seo-keyword-niche/SKILL.md"
click node_ads "https://github.com/seranking/seo-skills/blob/main/skills/seo-ads/SKILL.md"
click node_backlinks "https://github.com/seranking/seo-skills/blob/main/skills/seo-backlink-gap/SKILL.md"
click node_competitors "https://github.com/seranking/seo-skills/blob/main/skills/seo-competitor-gap-analysis/SKILL.md"
click node_page "https://github.com/seranking/seo-skills/blob/main/skills/seo-page/SKILL.md"
click node_technical "https://github.com/seranking/seo-skills/blob/main/skills/seo-technical-audit/SKILL.md"
click node_contentaudit "https://github.com/seranking/seo-skills/blob/main/skills/seo-content-audit/SKILL.md"
click node_drift "https://github.com/seranking/seo-skills/blob/main/skills/seo-drift/SKILL.md"
click node_sxo "https://github.com/seranking/seo-skills/blob/main/skills/seo-sxo/SKILL.md"
click node_ai_visibility "https://github.com/seranking/seo-skills/blob/main/skills/seo-ai-search-share-of-voice/SKILL.md"
click node_contentbrief "https://github.com/seranking/seo-skills/blob/main/skills/seo-content-brief/SKILL.md"
click node_planning "https://github.com/seranking/seo-skills/blob/main/skills/seo-plan/SKILL.md"
click node_geo "https://github.com/seranking/seo-skills/blob/main/skills/seo-geo/SKILL.md"
click node_local "https://github.com/seranking/seo-skills/blob/main/skills/seo-local/SKILL.md"
click node_schema "https://github.com/seranking/seo-skills/blob/main/skills/seo-schema/SKILL.md"
click node_google_skills "https://github.com/seranking/seo-skills/blob/main/skills/seo-google/SKILL.md"
click node_google_scripts "https://github.com/seranking/seo-skills/blob/main/scripts/gsc_query.py"
click node_google_auth "https://github.com/seranking/seo-skills/blob/main/scripts/google_auth.py"
click node_google_report "https://github.com/seranking/seo-skills/blob/main/scripts/google_report.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_keyword,node_niche,node_ads,node_backlinks,node_competitors toneBlue
class node_page,node_technical,node_contentaudit,node_drift,node_sxo,node_ai_visibility toneAmber
class node_contentbrief,node_planning,node_geo,node_local,node_schema toneMint
class node_google_skills,node_google_scripts,node_google_auth,node_google_report toneRose
class node_user,node_seranking toneIndigo
```

## Components

### Research & Discovery

- [Keyword research](https://github.com/seranking/seo-skills/blob/main/skills/seo-keyword-cluster/SKILL.md): `skills/seo-keyword-cluster/SKILL.md`
- [Niche research](https://github.com/seranking/seo-skills/blob/main/skills/seo-keyword-niche/SKILL.md): `skills/seo-keyword-niche/SKILL.md`
- [Paid search](https://github.com/seranking/seo-skills/blob/main/skills/seo-ads/SKILL.md): `skills/seo-ads/SKILL.md`
- [Backlink research](https://github.com/seranking/seo-skills/blob/main/skills/seo-backlink-gap/SKILL.md): `skills/seo-backlink-gap/SKILL.md`
- [Competitor research](https://github.com/seranking/seo-skills/blob/main/skills/seo-competitor-gap-analysis/SKILL.md): `skills/seo-competitor-gap-analysis/SKILL.md`

### Analysis & Audits

- [Page intelligence](https://github.com/seranking/seo-skills/blob/main/skills/seo-page/SKILL.md): `skills/seo-page/SKILL.md`
- [Technical audit](https://github.com/seranking/seo-skills/blob/main/skills/seo-technical-audit/SKILL.md): `skills/seo-technical-audit/SKILL.md`
- [Content audit](https://github.com/seranking/seo-skills/blob/main/skills/seo-content-audit/SKILL.md): `skills/seo-content-audit/SKILL.md`
- [Drift monitoring](https://github.com/seranking/seo-skills/blob/main/skills/seo-drift/SKILL.md): `skills/seo-drift/SKILL.md`
- [SXO diagnostics](https://github.com/seranking/seo-skills/blob/main/skills/seo-sxo/SKILL.md): `skills/seo-sxo/SKILL.md`
- [AI visibility](https://github.com/seranking/seo-skills/blob/main/skills/seo-ai-search-share-of-voice/SKILL.md): `skills/seo-ai-search-share-of-voice/SKILL.md`

### Strategy & Content

- [Content briefs](https://github.com/seranking/seo-skills/blob/main/skills/seo-content-brief/SKILL.md): `skills/seo-content-brief/SKILL.md`
- [SEO planning](https://github.com/seranking/seo-skills/blob/main/skills/seo-plan/SKILL.md): `skills/seo-plan/SKILL.md`
- [Generative SEO](https://github.com/seranking/seo-skills/blob/main/skills/seo-geo/SKILL.md): `skills/seo-geo/SKILL.md`
- [Local SEO](https://github.com/seranking/seo-skills/blob/main/skills/seo-local/SKILL.md): `skills/seo-local/SKILL.md`
- [Structured data](https://github.com/seranking/seo-skills/blob/main/skills/seo-schema/SKILL.md): `skills/seo-schema/SKILL.md`

### Data Integrations

- [Google SEO tools](https://github.com/seranking/seo-skills/blob/main/skills/seo-google/SKILL.md): `skills/seo-google/SKILL.md`
- [Google API scripts](https://github.com/seranking/seo-skills/blob/main/scripts/gsc_query.py): `scripts/gsc_query.py`
- [Google credentials](https://github.com/seranking/seo-skills/blob/main/scripts/google_auth.py): `scripts/google_auth.py`
- [Google reports](https://github.com/seranking/seo-skills/blob/main/scripts/google_report.py): `scripts/google_report.py`

### Other components

- **SEO practitioner**
- **SE Ranking MCP**

## Connections

- SEO practitioner → Keyword research: selects skill (evidence: `README.md`)
- SEO practitioner → Niche research: selects skill (evidence: `README.md`)
- SEO practitioner → Paid search: selects skill (evidence: `README.md`)
- SEO practitioner → Backlink research: selects skill (evidence: `README.md`)
- SEO practitioner → Competitor research: selects skill (evidence: `README.md`)
- SEO practitioner → Page intelligence: selects skill (evidence: `README.md`)
- SEO practitioner → Technical audit: selects skill (evidence: `README.md`)
- SEO practitioner → Content audit: selects skill (evidence: `README.md`)
- SEO practitioner → Drift monitoring: selects skill (evidence: `README.md`)
- SEO practitioner → SXO diagnostics: selects skill (evidence: `README.md`)
- SEO practitioner → AI visibility: selects skill (evidence: `README.md`)
- SEO practitioner → Content briefs: selects skill (evidence: `README.md`)
- SEO practitioner → SEO planning: selects skill (evidence: `README.md`)
- SEO practitioner → Generative SEO: selects skill (evidence: `README.md`)
- SEO practitioner → Local SEO: selects skill (evidence: `README.md`)
- SEO practitioner → Structured data: selects skill (evidence: `README.md`)
- SEO practitioner → Google SEO tools: selects skill (evidence: `README.md`)
- SE Ranking MCP → Keyword research: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Niche research: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Paid search: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Backlink research: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Competitor research: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Page intelligence: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Technical audit: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Content audit: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Drift monitoring: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → SXO diagnostics: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → AI visibility: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → Content briefs: supplies SEO data (evidence: `README.md`)
- SE Ranking MCP → SEO planning: supplies SEO data (evidence: `README.md`)
- Google SEO tools → Google API scripts: uses scripts (evidence: `README.md`)
- Google API scripts → Google credentials: loads credentials (evidence: `scripts/gsc_query.py`)
- Google SEO tools → Google reports: generates reports
