# Discussion: DataForSEO Integration & First Keyword Research

**Date:** December 26, 2025
**Duration:** ~1 hour
**Participants:** Oleg, @men
**Type:** Problem-Solving + Research Session

---

## Контекст сессии

Oleg предложил интегрировать DataForSEO для content-system (multi-agent система для создания контента). Цель — заменить "fake keywords" на реальные SEO данные.

---

## Ключевые решения

### 1. DataForSEO MCP Server — интегрирован ✅

**Конфигурация:**
- Установлен через npx: `dataforseo-mcp-server`
- Credentials: API username + password
- Подключен к Claude Code (`.mcp.json`)

**Доступные API:**
- Keywords Data API (search volume, CPC, KD)
- SERP API (топ результаты Google)
- DataForSEO Labs API (ranked keywords конкурентов)

**Стоимость:** ~$0.14 за full research session

### 2. Research Protocol для агентов — разработан ✅

**Принцип:** Категории keywords задаём жёстко, конкретные keywords выбирает агент.

**Workflow:**
```
1. Seed keywords по категориям (3-5 на категорию)
2. Search volume → Related keywords → Фильтр (KD < 50)
3. SERP analysis для финалистов
4. Content gap analysis
5. Рекомендации
```

**Budget:** $0.50 max на сессию, продолжение по запросу пользователя

### 3. Первый keyword research — выполнен ✅

**Найдена золотая ниша:** "placeholder images" кластер

- 14,800 searches/month
- Конкуренция средняя (KD 32)
- В топ-10 НЕТ AI-решений
- Banatie может занять нишу

**Детали:** см. `research/seo-keyword-research-placeholder-images.md`

---

## Инсайты сессии

### Что работает

1. **DataForSEO через MCP** — seamless интеграция, Claude Code умеет использовать
2. **Drill-down подход** — один seed keyword → 5+ контент-идей
3. **SERP analysis** — показывает реальные gaps в контенте

### Что узнали

1. **Problem-aware keywords часто нулевые** — люди не ищут "my pain is X", они ищут решения короткими фразами
2. **Related keywords ценнее seed** — DataForSEO находит варианты которые мы бы не придумали
3. **Brand keywords бесполезны** — "openai image api" = люди уже выбрали OpenAI, конвертить дорого

### Расширение scope

Keyword research применим не только к блогу, но и к:
- Landing pages сайта (SEO entry points)
- Use-case pages
- Documentation structure
- Product positioning

Content-system нужно расширить чтобы покрывала весь сайт.

---

## Action Items

### 🥇 Высокий приоритет

| Задача | Owner | Deadline | Success Criteria |
|--------|-------|----------|------------------|
| Создать `/placeholder-images` landing page | Oleg | Jan 2025 | Страница live, оптимизирована под keyword |
| Написать "Placeholder Images API" tutorial | Content System | Jan 2025 | Опубликовано на dev.to + blog |
| Интегрировать DataForSEO в @spy и @strategist агентов | Oleg | Jan 2025 | Агенты используют реальные данные |

### 🥈 Средний приоритет

| Задача | Owner | Deadline |
|--------|-------|----------|
| Research других кластеров (use-case, tech stack) | @men/@spy | Feb 2025 |
| Listicle "Best Placeholder Generators 2025" | Content System | Feb 2025 |
| Расширить content-system на website pages | Oleg + @men | Feb 2025 |

---

## Парковка (обсудить позже)

- Как структурировать research outputs для переиспользования между агентами
- Нужен ли отдельный агент для keyword research или встроить в @spy/@strategist
- Автоматизация research → content pipeline

---

## Связанные документы

- **Создан:** `research/seo-keyword-research-placeholder-images.md`
- **Обновить:** `ROADMAP.md` — добавить SEO actions в Content Marketing Sprint
- **Связан с:** Content-system multi-agent architecture

---

**Session rating:** ⭐⭐⭐⭐⭐ (высокопродуктивная, конкретные находки)
**Next session:** Research других keyword кластеров