К основному содержанию
скилл CX Codex

seo-traffic-diagnosis — скилл для Claude Code: установка и обзор

Скилл seo-traffic-diagnosis для Claude Code пошагово расследует падение, стагнацию или аномальный рост органического трафика с помощью Ahrefs MCP и Search Console.

MIT 290 установок ★ 1 107 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rampstackco/claude-skills --skill seo-traffic-diagnosis -a claude-code
Открыть на GitHub

Что делает seo-traffic-diagnosis

Скилл разбирает аномалии органического поиска по пяти последовательным уровням. Сначала отсекает ошибки трекинга, праздники и сезонность, сопоставляя клики из Search Console с сессиями аналитики. Дальше локализует просадку по странам, типам устройств, брендовому или небрендовому спросу и конкретным разделам сайта.

Затем переходит к страницам и технической части: проверяет историю позиций в Ahrefs, сдвиги в блоках выдачи, изменения в robots.txt, канонические теги, редиректы и недавние релизы. Без подключённого Ahrefs MCP и доступа к Google Search Console и аналитике провести полноценную диагностику не получится.

Финальный этап сверяет дату просадки с апдейтами алгоритмов поисковиков и динамикой конкурентов. На выходе формируется гипотеза в одно предложение и перечень конкретных технических правок.

Какие задачи решает

  • Локализовать причину внезапного падения органического трафика
  • Разобраться в стагнации поисковых переходов после внедрения контента
  • Проверить сайт после смены домена, миграции или выкатки релиза
  • Оценить потери после обновления алгоритмов поисковых систем

Примеры запросов агенту

  • Трафик из поиска просел на сорок процентов после вчерашнего деплоя, проверь технические причины и позиции страниц
  • Органика стагнирует уже три месяца, сравни данные Search Console и Ahrefs по небрендовым запросам
  • Руководство требует объяснить потерю позиций в блоге за последнюю неделю, локализуй проблему

Как установить seo-traffic-diagnosis

1Через Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill seo-traffic-diagnosis -a claude-code

2Вручную: положить файлы

~/.claude/skills/seo-traffic-diagnosis/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/seo-traffic-diagnosis/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о seo-traffic-diagnosis

Как установить seo-traffic-diagnosis в Claude Code?

Выполните команду npx skills add rampstackco/claude-skills --skill seo-traffic-diagnosis -a claude-code. Файл инструкции разместится по пути ~/.claude/skills/seo-traffic-diagnosis/SKILL.md.

Что делает скилл seo-traffic-diagnosis?

Он проводит аудит трафика через пятиуровневый анализ: валидирует данные, сегментирует сегменты спада, проверяет страницы, ищет технические баги после деплоев и сверяет внешние апдейты алгоритмов.

Когда этот скилл использовать не стоит?

Он не предназначен для плановых отчётов, превентивного поиска контентных пробелов, изолированного анализа ссылочной массы или починки сбоев разметки событий аналитики.

Исходный текст

SKILL.md · MIT
---
name: seo-traffic-diagnosis
description: "Diagnose organic traffic changes (drops, stalls, or unexpected wins) using Ahrefs MCP plus Search Console data. Use this skill when traffic suddenly dropped, has been flat despite investment, after an algorithm update, after a migration or deploy, or when a competitor seems to be taking share. Triggers on traffic dropped, traffic decline, traffic stalled, organic decline, lost rankings, why is traffic down, algorithm update, post-migration traffic loss, traffic diagnosis. Also triggers when stakeholders are panicking about an organic traffic number they cannot explain. A panic about tracking, event, or dashboard setup is a measurement problem, not a traffic problem: route those to `analytics-strategy`."
category: seo-audit-suite
catalog_summary: "Diagnose drops, stalls, or wins via 5-layer root cause analysis"
display_order: 5
---

# SEO Traffic Diagnosis

Diagnose why organic traffic moved (down, flat, or unexpectedly up) using Ahrefs MCP combined with Search Console and analytics data. Stack-agnostic. Produces a root-cause diagnosis and an action plan.

---

## When to use

- Organic traffic dropped sharply
- Organic traffic has been flat for months despite content investment
- After a known Google algorithm update
- After a migration, replatform, or domain change
- After a deploy that touched routing, redirects, or rendering
- When a competitor is visibly taking organic share
- When a single page dropped from a ranked position
- When stakeholders need an explanation, fast

## When NOT to use

- Routine performance reporting (use `analytics-strategy`)
- Pre-emptive content planning (use `seo-content-gap-audit`)
- Backlink-only investigations (use `seo-backlink-audit`)
- Technical issue triage outside of traffic concerns (use `seo-site-health-audit`)

---

## Required inputs

- Description of the symptom (what changed, when, magnitude)
- Date the change started (best estimate)
- Recent SEO history: deploys, migrations, content changes, link campaigns
- Access to Ahrefs MCP, Search Console, and analytics
- Confirmation the change is real (not a tracking artifact)

---

## The framework: 5 layers of diagnosis

A traffic change has one or more root causes. Move through the layers in order. Stop when you have enough evidence.

### Layer 1: Confirm the change is real

Before diagnosing, rule out:

- Tracking gaps (analytics outages, tag manager issues)
- Bot traffic changes
- Reporting comparison errors (different date ranges, wrong segment)
- Seasonality (compare year-over-year, not just month-over-month)
- Holiday or weekday effects

Cross-check Search Console clicks against analytics organic sessions. Significant divergence often points to a tracking issue, not a real traffic change.

### Layer 2: Localize the change

Where is the change happening?

Segment by:

- Country and language
- Device (mobile, desktop, tablet)
- Page or section (homepage, blog, product, category)
- Query type (branded vs non-branded)
- Landing page

A change in one segment requires different diagnosis than a change everywhere.

| Pattern | Likely cause |
| --- | --- |
| One country dropped | Local algorithm update, hreflang issue, geo redirect issue |
| Mobile dropped, desktop flat | Mobile usability or page speed regression |
| One section dropped | Topical algorithm update or section-specific quality issue |
| Branded queries dropped | Brand-level issue: site outage, reputation, manual action |
| Non-branded dropped | Algorithmic ranking issue |
| Single page dropped | Page-level issue: content, technical, or competitive |
| Sitewide dropped | Sitewide issue: penalty, technical, migration, or algorithm |

### Layer 3: Page-level analysis

For affected pages, audit:

- Position changes per ranked keyword (Ahrefs Rank Tracker history)
- SERP composition changes (more ads, AI overviews, featured snippets, video)
- Click-through rate changes
- Index status (Search Console coverage)
- Crawl errors and accessibility
- Recent content changes
- Internal link changes
- Backlink changes (lost links, redirect chains)

A page can lose traffic without losing rank if SERP composition changed.

### Layer 4: Technical analysis

Did anything break technically?

Check:

- Robots.txt changes
- Canonical tag changes
- Meta robots changes (accidental noindex)
- Redirect chains and loops
- Render issues (especially for JS-heavy frameworks)
- Site speed regressions
- Hreflang errors
- Sitemap freshness
- HTTP status codes (4xx, 5xx spikes)
- Server log evidence of crawl behavior changes

Recent deploys are the prime suspect. Compare deploy dates to traffic change dates.

### Layer 5: External analysis

If layers 1-4 do not explain the change, look outward.

- Algorithm update calendar (cross-reference timing)
- Competitor moves (new content, new SERP features they captured)
- Industry trend (declining search demand for the topic)
- Manual action (Search Console security and manual actions)
- Negative SEO (sudden link velocity changes)

External-factor diagnosis benefits from competitive context: did your traffic drop while competitors held steady (suggests an algorithm-specific issue), or did the entire vertical lose ground (suggests a user-behavior shift)? Similarweb shows competitor traffic trends; Ahrefs shows competitor SERP movement; pairing both surfaces whether the issue is yours alone or the category's.

---

## Workflow

1. **Confirm the symptom.** Get exact dates, magnitude, segment if known.
2. **Validate the data.** Layer 1 checks. Rule out tracking and seasonality.
3. **Localize.** Layer 2. Segment until the pattern is clear.
4. **Page-level dive.** Layer 3 on the most affected pages.
5. **Technical check.** Layer 4. Recent deploys, robots, canonicals, redirects.
6. **External check.** Layer 5. Algorithm updates, competitors, industry.
7. **Build the hypothesis.** State the cause as a single sentence.
8. **Validate the hypothesis.** Find the evidence that confirms or refutes it. See [`references/diagnosis-checklist.md`](references/diagnosis-checklist.md).
9. **Action plan.** Specific fixes mapped to specific evidence.
10. **Communicate.** Write up the diagnosis. Stakeholders want clarity, not exhaustive analysis.

---

## Failure patterns

- **Jumping to algorithm update.** "It must be the algorithm" is the lazy answer. Eliminate technical and page-level causes first.
- **Solving the wrong problem.** A drop diagnosed as "content quality" when the real cause was an accidental noindex on a deploy. Validate the hypothesis before fixing.
- **No baseline for "normal."** Without a baseline, every fluctuation looks alarming. Establish what normal noise looks like before reacting.
- **Treating one page as the site.** Site-wide and page-level diagnoses are different. Confirm scope first.
- **Ignoring branded vs non-branded.** A drop in branded queries means a brand-level problem. A drop in non-branded means an SEO problem. Different teams own them.
- **Comparing wrong date ranges.** Comparing 28 days to the previous 28 days during a holiday distorts the picture. Use year-over-year for seasonal businesses.
- **Stopping at correlation.** A deploy and a drop on the same day is a strong correlation, not proof. Find the mechanism.
- **Single-source diagnosis.** Ahrefs sees position. Search Console sees clicks and queries. Analytics sees behavior. Logs see crawl. Use them together.
- **Premature reassurance.** Telling stakeholders "it is just an algorithm update, will recover" without evidence sets up a worse conversation later.

---

## Output format

A diagnosis document with:

1. **Summary.** What changed, when, magnitude, root cause in one paragraph.
2. **The symptom.** Charts and segment breakdowns.
3. **Layer-by-layer findings.** What each layer ruled in or out.
4. **Root cause hypothesis.** Single statement with evidence.
5. **Action plan.** Ordered fixes with owners and timelines.
6. **Recovery forecast.** Realistic expectations on timeline and ceiling.
7. **Monitoring plan.** What to watch for confirmation of recovery.

Length: 4-10 pages. Stakeholders read this fast.

---

## If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.

---

## Reference files

- [`references/diagnosis-checklist.md`](references/diagnosis-checklist.md) - Layer-by-layer diagnostic checklist with the specific data to pull at each layer and how to interpret each signal.

© rampstackco · MIT · rampstackco/claude-skills

Похожие скиллы

Все скиллы по теме «SEO и GEO» →
seo-audit Cogny AI Скилл seo-audit проводит технический и контентный аудит сайта. Работает сразу по открытым данным страницы, а при подключении Cogny MCP подтягивает отчёты Search Console и Bing. CX Codex +1 ★ 116звёзд репо similarweb-traffic OpenClaudia Скилл similarweb-traffic собирает оценки трафика домена из SimilarWeb: визиты за месяц, каналы, страны и ключевые слова без платного API-ключа. CX Codex +1 227установок blog-decay AgriciDaniel Скилл blog-decay для Claude Code сравнивает два экспорта Google Search Console и находит страницы с падением кликов или показов. Проверяет контент на затухание. CX Codex +1 279установок traffic-acquisition vivy-yi Скилл traffic-acquisition для Claude Code и пяти других платформ, который помогает выстроить систему привлечения внешнего трафика на аккаунт Xiaohongshu. Охватывает органику, SEO, кросс-платформенное продвижение и платные каналы. CX Codex +1 348установок filtering-bot-traffic PostHog Скилл filtering-bot-traffic учит агента отделять в PostHog людей от ботов и AI-краулеров: чистит метрики или показывает, какая доля трафика пришла от роботов. CX Codex +1 208установок traffic-analysis kostja94 Скилл traffic-analysis перенаправляет агента на инструкции по анализу источников, UTM-меток и прямого трафика в репозитории Open Analytics. CX Codex +1 1 300установок

Из того же набора102

Весь набор →
content-brief-authoring Скилл content-brief-authoring для Claude Code помогает составить бриф одной статьи: задать поисковый интент, аудиторию, структуру и критерии успеха. CX Codex +1 292установок jtbd-framing Скилл jtbd-framing для Claude Code применяет метод Jobs-to-be-Done к продуктовым решениям. Он подключается при разборе JTBD, смене приоритетов или позиционировании продукта. CX Codex +1 291установок email-sequences Скилл email-sequences помогает планировать и писать email-кампании: онбординг, рассылки, транзакционные письма и цепочки возврата пользователей. CX Codex +1 291установок seo-site-health-audit Скилл seo-site-health-audit для Claude Code сортирует результаты краулера по влиянию на ранжирование. Помогает выбрать, какие технические проблемы исправлять в первую очередь, когда времени мало. CX Codex +1 291установок lead-magnet-design Скилл lead-magnet-design для Claude Code задаёт методологию проектирования лид-магнитов, чеклистов и шаблонов для сбора базы подписчиков и квалификации лидов. CX Codex +1 289установок programmatic-seo Скилл programmatic-seo проектирует системы генерации страниц из баз данных, защищая проект от санкций за тонкий контент. CX Codex +1 289установок seo-backlink-audit Скилл seo-backlink-audit для Claude Code проверяет качество входящих ссылок через Ahrefs MCP: оценивает профиль, выявляет токсичные и потерянные ссылки и сравнивает его с конкурентами. CX Codex +1 288установок seo-audit-orchestration Скилл seo-audit-orchestration оркестрирует полный SEO-аудит через Ahrefs MCP: собирает данные, запускает дочерние проверки и сводит выводы в единый отчёт. CX Codex +1 287установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой