ourdigital/our-claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix SEO skill 34 bugs, Korean labels, and transition Ahrefs refs to our-seo-agent (#2)

Browse Source
This commit is contained in:
Andrew Yim
2026-02-14 01:09:35 +09:00
committed by GitHub
parent d2d0a2d460
commit a28bfbf847
34 changed files with 265 additions and 262 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
custom-skills/27-seo-ai-visibility/code/CLAUDE.md
View File

@@ -2,7 +2,7 @@
## Overview
AI search visibility and brand radar tool for tracking how a brand appears in AI-generated search answers. Monitors AI answer citations, tracks share of voice in AI search vs competitors, analyzes cited domains and pages, and tracks impressions/mentions history. Uses Ahrefs Brand Radar APIs for comprehensive AI visibility monitoring.
AI search visibility and brand radar tool for tracking how a brand appears in AI-generated search answers. Monitors AI answer citations, tracks share of voice in AI search vs competitors, analyzes cited domains and pages, and tracks impressions/mentions history. Uses our-seo-agent CLI or pre-fetched data for comprehensive AI visibility monitoring.
## Quick Start
@@ -74,19 +74,13 @@ python scripts/ai_citation_analyzer.py --target example.com --responses --json
- Competitor citation comparison
- Recommendation generation for improving AI visibility
## Ahrefs MCP Tools Used
## Data Sources
| Tool | Purpose |
|------|---------|
| `brand-radar-ai-responses` | Get AI-generated responses mentioning brand |
| `brand-radar-cited-domains` | Domains cited in AI answers |
| `brand-radar-cited-pages` | Specific pages cited in AI answers |
| `brand-radar-impressions-history` | Brand impression trend over time |
| `brand-radar-impressions-overview` | Current impression metrics |
| `brand-radar-mentions-history` | Brand mention trend over time |
| `brand-radar-mentions-overview` | Current mention metrics |
| `brand-radar-sov-history` | Share of voice trend |
| `brand-radar-sov-overview` | Current share of voice |
| Source | Purpose |
|--------|---------|
| `our-seo-agent` CLI | Primary data source (future); use `--input` for pre-fetched JSON |
| WebSearch / WebFetch | Supplementary live data |
| Notion MCP | Save audit report to database |
## Output Format

26
custom-skills/27-seo-ai-visibility/desktop/SKILL.md
View File

@@ -2,14 +2,14 @@
name: seo-ai-visibility
description: |
AI search visibility and brand radar monitoring. Tracks how a brand appears
in AI-generated search answers using Ahrefs Brand Radar APIs.
in AI-generated search answers using our-seo-agent CLI or pre-fetched data.
Triggers: AI search, AI visibility, brand radar, AI citations,
share of voice, AI answers, AI mentions.
---
# SEO AI Visibility & Brand Radar
Monitor and analyze brand visibility in AI-generated search results. This skill uses Ahrefs Brand Radar APIs to track impressions, mentions, share of voice, cited domains, cited pages, and AI response content.
Monitor and analyze brand visibility in AI-generated search results. This skill uses our-seo-agent CLI or pre-fetched data to track impressions, mentions, share of voice, cited domains, cited pages, and AI response content.
## Capabilities
@@ -30,24 +30,18 @@ Monitor and analyze brand visibility in AI-generated search results. This skill
## Workflow
1. **Input**: User provides target domain and optional competitors
2. **Data Collection**: Fetch metrics from Ahrefs Brand Radar APIs
2. **Data Collection**: Fetch metrics from our-seo-agent CLI or pre-fetched JSON
3. **Analysis**: Calculate trends, compare competitors, analyze sentiment
4. **Recommendations**: Generate actionable Korean-language recommendations
5. **Output**: JSON report and Notion database entry
## Ahrefs MCP Tools
## Data Sources
| Tool | Purpose |
|------|---------|
| `brand-radar-ai-responses` | AI-generated responses mentioning brand |
| `brand-radar-cited-domains` | Domains cited in AI answers |
| `brand-radar-cited-pages` | Specific pages cited in AI answers |
| `brand-radar-impressions-history` | Impression trend over time |
| `brand-radar-impressions-overview` | Current impression metrics |
| `brand-radar-mentions-history` | Mention trend over time |
| `brand-radar-mentions-overview` | Current mention metrics |
| `brand-radar-sov-history` | Share of voice trend |
| `brand-radar-sov-overview` | Current share of voice |
| Source | Purpose |
|--------|---------|
| `our-seo-agent` CLI | Primary AI visibility data source (future); use `--input` for pre-fetched JSON |
| WebSearch / WebFetch | Supplementary AI search data |
| Notion MCP | Save audit report to database |
## Notion Output
@@ -100,7 +94,7 @@ All reports are saved to the OurDigital SEO Audit Log:
## Limitations
- Requires Ahrefs Brand Radar API access (not available in basic plans)
- Requires our-seo-agent CLI or pre-fetched AI visibility data
- AI search landscape changes rapidly; data may not reflect real-time state
- Share of Voice metrics are relative to tracked competitor set only
- Sentiment analysis based on AI-generated text, not user perception