# geo-analysis

Скилл geo-analysis для Claude Code запускает GEO/SEO-анализ домена через API Enception и скачивает PDF-отчёт о видимости бренда в ИИ, рынке и конкурентах. Используется для клиентских аудитов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 135 установок · ★ 750 у репозитория
- Автор: OpenClaudia
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/geo-analysis/SKILL.md
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/geo-analysis

## Что делает

Скилл принимает домен, запускает анализ через внешний API Enception и забирает готовый PDF. В отчёте видно, рекомендуют ли бренд ChatGPT и Google AI, плюс исследование рынка и конкуренты. Операций три: `start`, `status` и `report`.

Для старта нужны `website_url`, `primary_region` и `core_goals`. Если вы ничего не уточнили, подставятся `us` и `traffic`; конкурентов можно задать вручную, до 5 штук. Анализ идёт примерно 20–45 минут, потому что долго работает глубокое исследование рынка, так что статус стоит опрашивать с интервалом в минуты. Отчёт скачивается без авторизации, поэтому любой, у кого есть id, откроет его.

Без ключа `ENCEPTION_ANALYSIS_API_KEY` ничего не запустится, а сам API платный. Бесплатный ключ даёт 2 анализа в месяц, лимит запросов 10 в минуту. Если в отчёте нулевая видимость, а ChatGPT бренд рекомендует, поможет `update-brand`: он берёт настоящее название с псевдонимами и пересчитывает видимость по уже сохранённым ответам, без новых запросов.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/geo-analysis/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/geo-analysis/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/geo-analysis/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/geo-analysis/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenClaudia/openclaudia-skills skills/geo-analysis
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/geo-analysis/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/geo-analysis
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/geo-analysis/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/geo-analysis/SKILL.md

## Когда брать
- запустить GEO-анализ клиентского сайта одной фразой
- проверить, рекомендуют ли бренд ChatGPT и Google AI
- получить PDF с исследованием рынка и списком конкурентов
- узнать, дошёл ли запущенный анализ до статуса `succeeded`
- исправить нулевую видимость, указав настоящее название бренда и псевдонимы

## Примеры запросов агенту
- Запусти клиентский анализ для example.com, регион us, цель traffic
- Проверь статус анализа и, когда он завершится, скачай PDF-отчёт
- В отчёте видимость нулевая, хотя ChatGPT бренд рекомендует. Поставь название Pudu Robotics и псевдонимы Pudu и PuduBot

## Похожие
- [rank-tracker](https://affpapa.org/nevibecode/skills/aaron-he-zhu-rank-tracker.md) — скилл · 1500 установок
- [ai-visibility](https://affpapa.org/nevibecode/skills/ai-visibility.md) — скилл · ★ 80 у репозитория
- [seo-geo](https://affpapa.org/nevibecode/skills/seo-geo.md) — скилл · 57400 установок
- [Cite42](https://affpapa.org/nevibecode/mcp/cite42.md) — MCP-сервер · ★ 1 у репозитория
- [geo-content-optimizer](https://affpapa.org/nevibecode/skills/aaron-he-zhu-geo-content-optimizer.md) — скилл · 1900 установок
- [geo](https://affpapa.org/nevibecode/skills/geo.md) — скилл · 1100 установок

Из того же набора: [openclaudia/openclaudia-skills](https://affpapa.org/nevibecode/by/openclaudia/openclaudia-skills.md) — 73 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
