seo-content-brief

SEO Content Brief превращает исследование поискового спроса в готовый бриф, с которым автор может начинать работу над материалом. Навык рассчитан на запросы о content brief, плане статьи, редакторском задании и поиске органических возможностей. Его результат — не набор общих советов по SEO, а структурированный документ с темой, вариантами заголовка, планом H1/H2/H3, пробелами в материалах конкурентов, внутренними ссылками, AI Search-углом и оценкой потенциала трафика. Перед запуском нужны подключённый SE Ranking MCP server, доступный WebFetch для разбора страниц и данные от пользователя: целевой домен, рынок или страна и, при желании, исходная тема или поисковый интент. Если тема не передана, её сначала находят среди keyword gaps. Рынок по умолчанию — us, поэтому для другого региона его нужно задать явно. Навык не должен подменять отсутствующие входные данные догадками: без домена, рынка или доступного источника фактов бриф нельзя считать готовым. Рабочий цикл начинается с domain overview и набора ключевых слов домена. Из ответа получают органический трафик, основные страны и до ста верхних органических запросов в выбранном рынке, после чего сохраняют исходные данные и краткое резюме. Затем запрашивается полный список конкурентов по пересечению ключевых слов. API не поддерживает limit и offset, поэтому ответ может быть большим, примерно 60 КБ для популярного домена; его нужно сохранить, разобрать как JSON с полем data, отсортировать по common_keywords и выбрать пять наиболее релевантных конкурентов. Следующий этап — keyword gap: берутся запросы, по которым конкуренты видны, а целевой домен нет. Для отбора используются информационный интент, объём больше 1 000 запросов в месяц и keyword difficulty меньше 40. Из подходящих кластеров выбирается одна тема. Обоснование должно связывать потенциальный трафик, сложность и соответствие продукта домену; если endpoint вернул неизвестное значение, его оставляют неизвестным и не придумывают цифру. После выбора тема проверяется через SERP top-10, связанные и похожие запросы, вопросы, People Also Ask, AI Overview и leaderboard цитирования. Разбор трёх лучших страниц выполняется через WebFetch всегда. Из них извлекаются H1/H2/H3, объём, общие подтемы, пропущенные конкурентами аспекты и заметные приёмы оформления. Firecrawl — дополнительная проверка, а не обязательная зависимость: он может получить точный title и meta description, Open Graph, twitter card, JSON-LD, hero image, byline, таблицы и code blocks, но стоит три кредита за три страницы. Если Firecrawl недоступен или передан no-firecrawl, бриф всё равно создаётся, а on-page benchmark помечается пропущенным. Классификация шаблона выбирается из ultimate-guide, how-to, listicle, explainer, comparison, review, best-of и landing-page; смешанную выдачу нужно явно отметить как MIXED, а не насильно сводить к одному типу. Внутренний linking plan строится по существующим страницам домена: для каждого источника предлагается anchor text и раздел нового материала. Финальный каталог складывается в папку с датой: BRIEF.md находится на верхнем уровне и остаётся самодостаточным, а шесть файлов evidence сохраняют domain overview, конкурентов, keyword gaps, SERP и keywords, content analysis и internal links. В брифе должны быть target keyword, title options, meta description, структура, подтверждённые gaps, AI Search angle, deliverables, word-count target, tone, assets, traffic potential и ссылки на evidence. Практические ограничения обязательны. SE Ranking Data API нельзя штурмовать параллельными запросами: источник требует соблюдать лимит 10 запросов в секунду и идти последовательно. Не следует выдавать keyword volume, difficulty, traffic potential или цитирование LLM за факт, если endpoint их не вернул. Навык готовит редакционное задание, но не пишет саму статью и не гарантирует позицию в выдаче; итоговые решения должны опираться на сохранённые ответы API и проверяемые страницы конкурентов.