# AI SEO Agent Pipeline

> Программатическая SEO-фабрика: сотни страниц под длинный хвост через n8n+Perplexity. Триггеры: «программатический SEO». НЕ статья→seo-machine-ru.

- Skill: `jhamidun/ai-seo-agent-pipeline` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jhamidun/ai-seo-agent-pipeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jhamidun/ai-seo-agent-pipeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: JHamidun (https://skillmd.com/u/jhamidun)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jhamidun/ai-seo-agent-pipeline

---


# AI SEO Agent Pipeline — программатическая фабрика SEO-страниц

Playbook по построению **AI SEO агента** — low-code конвейера на n8n, который массово генерирует
ультра-персонализированные SEO-страницы под микро-запросы длинного хвоста.

Это **не редакционный пайплайн** (одна статья → один час качества). Это **программатическая
фабрика**: «1 ключевой запрос = 1 статья = 1 страница», сотни-тысячи страниц/мес, автоперелинковка,
автопубликация в CMS. Цель — не «лучший текст для человека», а **покрытие, масштаб и связность**,
чтобы стать источником для AI-ответов.

> Граница со `seo-machine-ru`: для русскоязычного SEO-контента под Яндекс, семантического ядра,
> кластеризации, написания и оптимизации **одной** качественной статьи, GEO/AEO одной страницы —
> используй `seo-machine-ru` (там Python-пайплайн качества + Яндекс/Tilda стек + роли-чеклисты).
> **Этот скилл** — про массовую программатическую генерацию через n8n, когда статей сотни.
> Связка: `seo-machine-ru` даёт стратегию и семантику → этот скилл штампует страницы по ним.

---

## Кризис SEO 2025-2026 (зачем это всё)

Контекст, без которого метод не имеет смысла. Это аргументация перед клиентом/руководством.

- **Органический трафик падает у всех.** Эталонный публичный кейс: **HubSpot — с ~10-13.5 млн до
  <1 млн визитов/мес** (−70…−80%). Не выброс, а системный сдвиг.
- **Причина** — AI-ответы Google (AI Overviews) + ChatGPT / Gemini / Perplexity. Пользователь
  получает ответ, **не переходя на сайт**.
- **Итог: Google = канал импрессий, а не кликов.** Классическая модель «статья → клик» умирает.
  Zero-click: 60% запросов в 2024 → **80-83%** на запросах с AI Overviews в 2026.
- **Контент больше не пост. Контент = инфраструктура для AI и discovery.** Веб превратился в
  огромную базу знаний, которую сканируют боты LLM.
- **70%+ контента в интернете — AI-generated** (или Human + AI).
- **Побеждает не лучший текст, а покрытие + масштаб + связность.** Раньше: 1 статья / 1 пост /
  1 канал. Сейчас: сотни-тысячи единиц контента под конкретные запросы и related questions.
- **Сдвиг мышления:** «Мы больше не делаем контент. Мы строим системы генерации трафика.»
- **ROI системы** (заявленный практиками метода): **−30% маркетингового бюджета + ×2-3 рост
  производительности + сотни тысяч органического трафика** + независимость от алгоритмов, одного
  канала и ручного труда.

Подробно с цифрами (recency ×3.2, brand mentions vs backlinks 3:1, schema-деплой 0→14% citation
share) — `references/programmatic-strategy.md`.

---

## Когда использовать этот скилл

- Нужно покрыть **длинный хвост** из 100-1000+ микро-запросов с низкой конкуренцией.
- Есть **семантика парами**: «from-to» (откуда-куда), «service-city» (услуга-город),
  «role-industry» (роль-отрасль) — где меняется не заголовок, а **весь контент страницы**.
- Нужен **конвейер** «seed-фраза → готовая опубликованная страница» без ручного копирайтинга.
- Нужна **автоперелинковка** при масштабе (когда статей сотни и руками связать нельзя).
- Нужно собрать **n8n workflow** (или Gumloop/Relevance) под генерацию контента.
- Нужно **citation-mining через Perplexity** — понять, какие источники цитирует AI, чтобы туда
  попасть.

### Когда НЕ использовать (важно)

- Одна качественная статья под высокочастотный запрос → `seo-machine-ru` (flagship-режим).
- SEO под Яндекс, Wordstat, семантическое ядро, кластеризация → `seo-machine-ru` + `yandex`.
- **YMYL-ниши** (медицина, финансы, право) — там нельзя массово AI-генерить, нужны E-A-T,
  карточки экспертов, ручная экспертиза → `seo-machine-ru` (E-A-T режим), `schema-markup-ru`.
- GEO/AEO **одной** страницы под Нейро/Alice/GigaChat → `seo-machine-ru` (`references/aeo-geo.md`).
- Посты в соцсети/Telegram → `tg-post`, `content-engine`.

> **Главное ограничение метода:** «Полная автоматизация невозможна — исследование ключей требует
> экспертизы, кластеризация не полностью автоматизируется, выбор стратегии зависит от рынка. AI —
> инструмент, но стратегию формирует эксперт.»
> **Сначала — стратегия и keyword research. Затем — автоматизация генерации и публикации.**

---

## Стратегия программатической генерации (TL;DR)

Полная версия — `references/programmatic-strategy.md`. Суть:

1. **Таргетинг на длинный хвост 100-300 запросов/мес.** Низкая конкуренция → быстро в топ →
   быстро в AI-выдачу. Чем выше трафик, тем выше конкуренция — на старте не лезть в high-volume.
2. **Ультра-персонализированные страницы.** Меняется **весь** контент, не только H1. Каждая
   страница: локальная информация + стоимость + маршруты/детали + FAQ + related queries
   (cost of living, best options, etc.).
   - Пример: `Movers from San Francisco → Los Angeles`, `Transfer Geneva → Méribel`.
   - Свойство: **плохо читаются людьми, отлично читаются ботами**, стабильно попадают в LLM-выдачу.
3. **Кластеры страниц** под структуру спроса. Пример (transfer/travel ниша):
   - **Resort pages** (страницы курортов/направлений),
   - **Route pages** (страницы маршрутов «откуда-куда»),
   - **Airport pages** (страницы аэропортов/хабов).
   - У каждого кластера — собственные ключевые группы.
4. **Принцип «1 запрос = 1 статья = 1 страница».** Один URL под один интент.
5. **Размещение** — на своём сайте И/ИЛИ на внешних площадках, которые ранжируются (Quora, Reddit,
   и т.п.). Условие: ключ имеет спрос + площадка ранжируется по нему.
6. **Логика одинакова** для англоязычного и русскоязычного сегментов.

RU-паттерны (адаптация): `услуга × город`, `продукт × отрасль`, `курс × роль`,
`SaaS use-case × индустрия` — см. `references/programmatic-strategy.md`.

---

## Архитектура AI SEO агента (главное)

Low-code workflow на **n8n** (можно Gumloop / Relevance.ai). В продакшене агенты пишут кодом, но
для прототипа/теста/небольшой нагрузки low-code удобнее и быстрее (5-10 минут до первой статьи).

### Конвейер (happy path)

```
[Форма / Trigger]  seed-фраза (ключевой запрос)
        │
        ▼
[Perplexity]  (или любая LLM с браузингом)
   • анализирует поисковую выдачу
   • собирает ссылки (citations)
   • парсит контент источников
   • формирует summary
        │
        ▼
[Извлечение текстов из ссылок]  →  собранный материал
        │
        ▼
[Копирайтер-агент (OpenAI/Claude)]  по строгому промпту:
   роль · география · продукт · структура · ключи · форматирование
   →  SEO-статья 1500-2000 слов
       H2 с ключом · FAQ · Key Takeaways · Estimated Reading Time ·
       internal links · bold/italic/lists
        │
        ▼
[Оформление в HTML]  +  [генерация изображений LLM + alt-тексты]
        │
        ├──▶ [Google Docs]  (статья приходит на email — базовый режим)
        │
        ▼
[Преобразование в JSON]  (смысл не меняется, текст не дополняется)
        │
        ▼
[CMS API]  WordPress / Webflow / Tilda Feeds
   →  автосоздание поста в нужной категории
        │
        ▼
[Supabase]  БД опубликованных статей
   →  поиск релевантных старых статей
   →  автоматическая вставка internal links
   →  ускорение SEO-индексации
```

### Два варианта реализации

- **Вариант A (быстрый старт, 5-10 мин):** форма → Perplexity → копирайтер → Google Docs → статья
  на email. Без CMS. Для теста и прототипа.
- **Вариант B (полный конвейер):** + ТЗ-генератор (Google Doc с intent/keywords/meta/structure) +
  парсинг ТЗ → JSON → CMS API → автопубликация + Supabase-перелинковка.

Детальный разбор узлов n8n, последовательности, структуры готового workflow-файла и инструкция
воспроизведения — `references/n8n-pipeline.md`.

### Параметры генерации (фиксируются в промпте)

| Параметр | Значение |
|----------|----------|
| Объём | 1500-2000 слов |
| Ключевой запрос | обязательно в одном из H2 |
| FAQ | секция обязательна |
| Key Takeaways | блок обязателен |
| Estimated Reading Time | указывается |
| Internal links | да (из Supabase в полном режиме) |
| Форматирование | bold / italic / списки, фиксированная структура блоков |
| Изображения | генерация через LLM + alt-тексты |
| Output | строго JSON (без артефактов) для CMS |

Шаблоны промптов (копирайтер-агент + Perplexity research + ТЗ-генератор) — `references/prompts.md`.

---

## Стек (что нужно подключить)

| Компонент | Роль | Cross-link скилл |
|-----------|------|------------------|
| **Perplexity API** | анализ выдачи + citations + summary (research-агент). Биллинг + ключ. Заменяема любой LLM с браузингом | `perplexity` |
| **OpenAI API + Claude** | копирайтер-агент (генерация статьи), ТЗ-парсер | `claude-api` |
| **Google Docs API + Gmail API** | промежуточное ТЗ + доставка статей на email | `gdocs`, `gmail` |
| **n8n** (осн.) / Gumloop / Relevance.ai | оркестрация low-code workflow | `n8n` |
| **Supabase** | БД опубликованных статей + автоперелинковка | — (REST/SQL) |
| **CMS:** WordPress / Webflow / **Tilda Feeds** | публикация через JSON API; Tilda — для RU-кейсов | `tilda` (RU) |
| Семантика / Wordstat / кластеризация | стратегия (НЕ автоматизируется) | `seo-machine-ru`, `yandex` |
| Анти-AI-слоп / чистка текста | качество выхода | `seo-machine-ru` (`content_scrubber.py`) |
| Schema (Service / AreaServed / FAQ) | разметка programmatic-страниц | `schema-markup-ru` |

> GEO/AEO (попасть в ответы AI) живёт в `seo-machine-ru` → `references/aeo-geo.md`
> (Яндекс Нейро / Alice / GigaChat / ChatGPT / Perplexity). Отдельного скилла `geo-aeo-ru` пока нет —
> если появится, перелинковать сюда.

---

## Воспроизведение workflow (быстрый старт)

Шаги для сборки минимального агента (Вариант A) — детали в `references/n8n-pipeline.md`:

1. **Подготовь стратегию ПЕРВОЙ** (это не автоматизируется):
   - найди ключи → проверь volume → оцени конкуренцию → сгруппируй по кластерам → собери таблицу
     ключей. Таргет: 100-300 запросов/мес, низкая конкуренция.
   - Используй `seo-machine-ru` (`research`, `cluster`) + `yandex` (Wordstat) для RU.
2. **n8n:** добавь Trigger (Form / Webhook), принимающий `seed` (ключевую фразу).
3. **Perplexity node:** промпт research-агента (`references/prompts.md` → Perplexity research) →
   получи выдачу + citations + summary. Сохрани citations отдельно (пригодятся для AEO).
4. **HTTP/Code node:** извлеки тексты из citation-ссылок (fetch + strip HTML) → собери материал.
5. **OpenAI/Claude node:** промпт копирайтера-агента (`references/prompts.md` → копирайтер) с
   параметрами (1500-2000 слов, H2 с ключом, FAQ, Key Takeaways, ETR, internal links, JSON output).
6. **Format node:** оформи в HTML, сгенерь изображение (LLM) + alt-тексты.
7. **Google Docs node + Gmail node:** создай документ, отправь на email. **Готово — Вариант A.**
8. **Для Варианта B (полный конвейер):** добавь ТЗ-генератор (Google Doc → JSON-парсер), CMS-узел
   (WordPress/Webflow/**Tilda Feeds** для RU), Supabase-узел (insert статьи + query для
   internal links). См. `references/n8n-pipeline.md`.

**Готовый импорт:** воспроизведённую структуру workflow-файла для импорта в n8n см. в
`references/n8n-pipeline.md` (раздел «Структура AI SEO Writer workflow»). Если у тебя есть готовый
`.json` — импортируй его напрямую через n8n → Import from File.

---

## Метрики и проверка качества

- **Объём:** 1500-2000 слов на страницу.
- **Покрытие FAQ:** есть ли FAQ-секция и сколько вопросов (минимум 3-5 related queries).
- **Internal links density:** ≥2-3 ссылки на релевантные страницы (через Supabase).
- **Estimated Reading Time** проставлен.
- **Анти-слоп:** прогнать через `seo-machine-ru/scripts/content_scrubber.py` (чистка невидимых
  Unicode + типографика) — иначе массовый AI-текст палится и режется фильтрами.
- **JSON валиден** для CMS (без артефактов, строгая структура).
- **Индексация:** мониторить через Google Search Console (Запад) / Яндекс.Вебмастер (`yandex`, RU).

---

## References (читать по необходимости)

| Файл | Когда |
|------|-------|
| `references/n8n-pipeline.md` | детальная архитектура n8n workflow: узлы, последовательность, структура workflow-файла, инструкция воспроизведения, Supabase schema, CMS-узлы |
| `references/prompts.md` | промпт копирайтера-агента + Perplexity research промпт + ТЗ-генератор + параметры генерации |
| `references/programmatic-strategy.md` | стратегия программатического SEO: микро-запросы, кластеры (Resort/Route/Airport + RU-адаптация), Supabase-перелинковка, длинный хвост 100-300, кризис SEO с цифрами, citation-mining |

---

## Связанные скиллы (cross-links)

- **`seo-machine-ru`** — общая SEO/GEO/AEO контент-машина под Яндекс (Python-пайплайн качества,
  семантика, кластеризация, написание/оптимизация одной статьи, AEO под Нейро/Alice/GigaChat). **Для
  русскоязычного SEO-контента под Яндекс и общей SEO-стратегии — туда.** Этот скилл — про массовую
  программатическую генерацию через n8n.
- **`n8n`** — движок оркестрации workflow (узлы, триггеры, импорт/экспорт JSON).
- **`perplexity`** — research-агент конвейера (анализ выдачи + citations).
- **`claude-api`** — копирайтер-агент / LLM-генерация (альтернатива/дополнение OpenAI).
- **`tilda`** — Feeds API для массового создания страниц в RU-кейсах (вместо WordPress/Webflow).
- **`yandex`** — Wordstat для семантики длинного хвоста под RU.
- **`schema-markup-ru`** — Service / AreaServed / FAQ / Person разметка для programmatic-страниц.
- **`geo-aeo-ru`** — отдельный GEO/AEO-скилл; пока GEO/AEO в `seo-machine-ru`.

