geo-analysis — скилл для Claude Code: что делает и как установить
Скилл geo-analysis для Claude Code запускает GEO/SEO-анализ домена через API Enception и скачивает PDF-отчёт о видимости бренда в ИИ, рынке и конкурентах. Используется для клиентских аудитов.
MIT 135 установок ★ 750 обновлён 2026-10-21
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a claude-codeЧто делает 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: он берёт настоящее название с псевдонимами и пересчитывает видимость по уже сохранённым ответам, без новых запросов.
Какие задачи решает
- запустить GEO-анализ клиентского сайта одной фразой
- проверить, рекомендуют ли бренд ChatGPT и Google AI
- получить PDF с исследованием рынка и списком конкурентов
- узнать, дошёл ли запущенный анализ до статуса
succeeded - исправить нулевую видимость, указав настоящее название бренда и псевдонимы
Примеры запросов агенту
- Запусти клиентский анализ для example.com, регион us, цель traffic
- Проверь статус анализа и, когда он завершится, скачай PDF-отчёт
- В отчёте видимость нулевая, хотя ChatGPT бренд рекомендует. Поставь название Pudu Robotics и псевдонимы Pudu и PuduBot
Как установить geo-analysis
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a claude-code2Вручную: положить файлы
~/.claude/skills/geo-analysis/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/geo-analysis/
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a codex2Вручную: положить файлы
.agents/skills/geo-analysis/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a cursor2Вручную: положить файлы
.cursor/skills/geo-analysis/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install OpenClaudia/openclaudia-skills skills/geo-analysis2Вручную: положить файлы
.github/skills/geo-analysis/SKILL.md1Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a gemini-cli2Командой платформы
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/geo-analysisВручную: положить файлы
.devin/skills/geo-analysis/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о geo-analysis
Как установить geo-analysis в Claude Code?
Выполните npx skills add OpenClaudia/openclaudia-skills --skill geo-analysis -a claude-code. Скилл живёт в файле ~/.claude/skills/geo-analysis/SKILL.md.
Что делает geo-analysis?
Запускает анализ домена через API Enception, следит за статусом и скачивает PDF. В отчёте видно, рекомендуют ли бренд ChatGPT и Google AI, а ещё рынок и конкуренты.
Что нужно для работы geo-analysis и сколько ждать отчёт?
Нужен ключ ENCEPTION_ANALYSIS_API_KEY, API платный. Бесплатный ключ даёт 2 анализа в месяц. Один запуск занимает примерно 20–45 минут.
Исходный текст
SKILL.md · MIT
---
name: geo-analysis
description: "Run a full GEO/SEO client analysis for a domain via the Enception external API — start the analysis, poll its status, and download the PDF report covering AI visibility, market research, and competitors. Use when the user says 'run a client analysis', 'analyze <domain> for GEO', 'GEO analysis for <domain>', or 'check analysis status'."
---
# GEO Analysis
Run a full GEO/SEO analysis for a domain and get a client-ready PDF report: AI visibility (is the brand recommended by ChatGPT / Google AI), deep market research, and competitor landscape.
Thin wrapper over the Enception client-analysis API. Three operations: **start**, **status**, **report** (plus an optional brand-name correction).
**Disclosure:** contributed by Enception AI and calls Enception's **paid** external API. Docs: https://www.enception.ai/doc/api-client-analysis
## Requirements
- `ENCEPTION_ANALYSIS_API_KEY` — sent as the `x-api-key` header. Self-serve: sign up at https://www.enception.ai, then generate a free-tier key under Account → API Key (2 analyses/month free; contact the team for higher limits). Rate limit: 10 requests/minute.
## 1. Start
`POST https://www.enception.ai/api/external/client-analysis/start`
Required: `website_url`, `primary_region`, `core_goals`. Sensible defaults: `primary_region=us`, `core_goals=traffic`, `output_language=en`, `competitors=[]`. The API normalizes URLs to a bare domain and rejects IPs. Returns `{ id, message }` — **save the `id`**.
Pick `output_language` from an explicit request first, then the user's conversation language, then the domain TLD (`.cn` → `zh`; otherwise `en`).
```bash
curl -s -X POST "https://www.enception.ai/api/external/client-analysis/start" \
-H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
-d '{"website_url":"https://example.com/","primary_region":"us","competitors":[],"core_goals":"traffic","output_language":"en"}'
```
Only override `primary_region` / `core_goals` / `competitors` if the user specifies. `core_goals` is free text (e.g. `traffic`, `ranking`). Competitors: `[{"name":"X","domain":"x.com"}, ...]` (max 5). For multiple domains, fire one POST each and collect the ids.
## 2. Status
`POST https://www.enception.ai/api/external/client-analysis/status` with body `{ "id": "<id>" }` and the same `x-api-key` header. Returns `{ status: 'pending' | 'failed' | 'succeeded', progress_percent?, pdf_url? }`.
A full run takes **~20–45 minutes** — the bottleneck is the deep market-research step. Poll on a long interval (minutes, not seconds). `succeeded` ⇒ ready to fetch the report. If a run fails or stalls indefinitely, report that to the user rather than inventing results.
## 3. Report
`GET https://www.enception.ai/api/external/client-analysis/report/<id>` — public, no auth; shareable by id. Works once status is `succeeded` (also serves partial runs).
```bash
curl -s -o geo-analysis-example.pdf \
"https://www.enception.ai/api/external/client-analysis/report/<id>"
```
Confirm it's a real PDF (`file geo-analysis-example.pdf`), then give the user the file and/or the public URL.
## 4. Fix "zero visibility" (brand-name correction)
`POST https://www.enception.ai/api/external/client-analysis/update-brand` with body `{ "id", "brand_name"?, "alternative_names": [...] }` and the `x-api-key` header.
When a report shows zero/low AI visibility but the brand IS recommended by ChatGPT/Google, it's almost always because the brand is only known by its fused domain label (e.g. `pudurobotics`) while AI engines say "Pudu Robotics". Supply the real name + aliases and the route recomputes visibility from the already-stored answers (no re-query — fast), then re-fetch the report.
```bash
curl -s -X POST "https://www.enception.ai/api/external/client-analysis/update-brand" \
-H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
-d '{"id":"<id>","brand_name":"Pudu Robotics","alternative_names":["Pudu","PuduBot"]}'
```
Returns `{ success, mention_rate, overall_score, average_position, analysis_regenerated }`. New analyses resolve the brand name automatically; this is the manual correction path for existing reports.
© OpenClaudia · MIT · OpenClaudia/openclaudia-skills