Документация

Руководство

Всё, что нужно знать о GEO Scout

01 · 17 разделов

AI-агент как стратег команды

Встроенный ассистент и MCP: анализ видимости, работа с конкурентами и промптами, подготовка фактов, проверка точности и сохранение задач с черновиками.

1.1

Встроенный агент: чат поверх ваших данных

Откройте «Агент» в сайдбаре: ассистент работает с данными выбранного бренда без отдельного подключения. Он читает ответы AI, сравнивает метрики и конкурентов, разбирает источники и помогает выбрать следующие действия. В том же диалоге можно согласовать изменения промптов, кластеров и конкурентов, подготовить факты о компании или сохранить задачу с текстом в Командном центре. MCP нужен, если вы хотите работать с этими данными из своего приложения с ИИ.

  • Ноль настройки: переключатель «Дашборд / Агент» в левом верхнем углу сайдбара — и чат открыт. Доступ к данным ровно тот же, что у вас в интерфейсе
  • Готовые сценарии помогают начать разбор видимости, восприятия, оговорок и точности ответов. В разделе конкурентов доступны «Найти нерелевантных конкурентов» и «Найти дубли конкурентов».
  • Данные под рукой: охват и доля голоса, конкуренты, цитируемые страницы, восприятие бренда и качество присутствия, промпты с полными текстами ответов AI, задачи Командного центра и контент-планы
  • Агент умеет менять данные: сначала показывает предлагаемые изменения и ждёт подтверждения. Прямая просьба сохранить задачу или готовый текст позволяет сохранить их сразу. Доступные операции зависят от ваших прав.
  • В ответах — ссылки на нужные страницы дашборда: увидели вывод, перешли, проверили цифры руками
  • Чаты сохраняются в сайдбаре и группируются по дням, к прошлому разбору можно вернуться. Суточный лимит ответов считается на бренд и общий для всей команды, его размер зависит от тарифа
Совет

Начните с конкретной задачи: «Сравни последние 7 дней с предыдущими, покажи примеры ответов и отдели наблюдения от гипотез». Проверяйте даты, выборку и ссылки. Разница в метриках сама по себе не доказывает её причину; при нехватке данных ассистент должен обозначить ограничение.

1.2

Проверить и привести в порядок конкурентов

Попросите ассистента проверить список по профилю бренда, сайтам, вариантам названий и примерам реальных ответов. Это доступно во встроенном чате и через MCP с разрешением записи.

  • «Найди нерелевантных конкурентов и дубли. Покажи основания и список изменений, пока ничего не меняй». Ассистент должен указать, сколько записей проверил.
  • После согласования можно включить или отключить конкурентов, исправить или убрать официальный сайт и объединить дубли с переносом упоминаний.
  • Если запись — ваш собственный бренд, владелец может перенести её исторические упоминания в бренд. Запись конкурента при этом удаляется; это отдельная операция, а не обычное слияние дублей.
  • Мало упоминаний или отсутствие сайта сами по себе не делают конкурента нерелевантным. Похожие названия и общий домен тоже не доказывают, что записи нужно объединить.
Совет

Изменение состава конкурентов и перенос упоминаний могут изменить метрики прошлых периодов. Это исправление учёта, а не рост видимости в новых ответах AI.

1.3

Сохранить задачу и подготовленный текст

Результат разбора можно сохранить в Командном центре вместе с идеей, статьёй, брифом или предложенными правками. Возможность доступна во встроенном ассистенте и через MCP с разрешением записи.

  • «Создай задачу по исправлению этой неточности. Укажи страницу, спорную цитату и предложенную формулировку».
  • «Подготовь статью по этому пробелу и сохрани её черновик в задаче Командного центра». Текст пишет ассистент; сохранение готового текста не запускает отдельную генерацию и не списывает кредиты.
  • «Сохрани этот бриф в существующую задачу». Ассистент может добавить или обновить черновик, который затем открывается в карточке задачи.
  • После сохранения проверьте карточку: описание, ссылки на основания и сам текст. Сохранение задачи не публикует материал и не меняет страницы сайта.
Совет

Для сохранения прямо попросите об этом. Обычный запрос на анализ не означает, что нужно создавать задачи. Запись в Студию контента и запуск её генератора из этого чата недоступны.

1.4

Подготовить факты и проверить точность ответов

Ассистент и MCP помогают настроить раздел «Точность»: подготовить факты о компании, выбрать существующие промпты и разобрать найденные противоречия.

  • «Подготовь факты о компании по этим ссылкам. Покажи формулировки и источники перед сохранением». Проверьте каждое утверждение; в проверке может участвовать до 50 активных фактов.
  • После согласования сохраните факты и выберите существующие промпты мониторинга. Проверка использует уже собранные ответы; отдельный брендовый кластер для неё не нужен.
  • Для платного запуска сначала получите предпросмотр: какие факты, промпты и ответы будут проверены и сколько кредитов потребуется. Подтвердите конкретный расчёт следующим сообщением.
  • Попросите показать результаты, спорную цитату и исходный ответ. Можно разобрать отдельное утверждение, исправить его оценку или отменить доступное задание проверки.
Совет

Доступ и порядок запуска зависят от тарифа и ваших прав. Подробности — в руководстве по точности.

1.5

Работа в привычном приложении с ИИ через MCP

Встроенный агент живёт в дашборде, MCP выносит те же данные в ваше приложение с ИИ — Codex, Claude Desktop, Cursor, Claude Code. Выигрыш в контексте, которого в дашборде нет: рядом ваш репозиторий и лендинги, черновики статей, задачи в трекере, другие подключённые сервисы. Стратег читает ответы AI целиком, прорабатывает каждый источник цитирования, сравнивает с конкурентами, проверяет гипотезы — и складывает результат сразу в техническое задание, правки проекта или задачу. Спрашиваете «почему AI отвечает именно так», «как должна выглядеть статья, чтобы попасть в этот промпт», «соберём план публикаций на квартал» — и получаете полноценный аналитический разбор, а не пересказ цифр из дашборда. Технически MCP (Model Context Protocol) — это стандарт, который и обеспечивает агенту такой доступ.

  • В роли стратега — Codex, Claude Desktop, Cursor, Claude Code или любой другой MCP-совместимый клиент. ChatGPT возможен только через ChatGPT Apps / developer mode, если он доступен в вашем аккаунте
  • Подключение через OAuth или личный токен (PAT). Доступ привязан к аккаунту; после подключения попросите показать доступные бренды и выбрать нужный.
  • Права подключения определяют доступ: чтение аналитики и, при разрешении записи, работа с промптами, кластерами, конкурентами, фактами и задачами. Отдельные действия требуют прав владельца или партнёрского аккаунта.
  • Токен привязан к аккаунту, а не к бренду: активный бренд агент переключает сам — удобно, когда вы ведёте несколько брендов или работаете как агентство
  • На руках у стратега — всё, что есть в дашборде, плюс полные тексты ответов AI: метрики, источники, конкуренты, промпты, цитаты, действия, контент-планы и настройки мониторинга
Совет

Встроенный ассистент помогает разбирать данные GEO Scout и выбирать следующие действия. Через MCP вы можете работать в привычном приложении с ИИ, используя также свои файлы и другие подключённые сервисы.

1.6

Codex

Codex поддерживает streamable HTTP MCP-серверы в CLI, IDE extension и приложении. Настройки MCP общие: сервер можно добавить через интерфейс Codex или через `~/.codex/config.toml`.

  • Откройте Codex → Settings → MCP servers → Add server (как на скриншоте) или файл `~/.codex/config.toml`
  • Добавьте сервер `geoscout` с URL `https://geoscout.pro/api/mcp`
  • Для OAuth-подключения запустите авторизацию из интерфейса или выполните `codex mcp login geoscout`
  • На экране согласия GEO Scout выберите бренд и подтвердите доступ
  • Для PAT-подключения используйте `bearer_token_env_var = "GEOSCOUT_MCP_TOKEN"` и задайте переменную окружения `GEOSCOUT_MCP_TOKEN=gs_<ваш-токен>` перед запуском Codex
1.7

Claude Desktop

Claude Desktop работает по stdio-протоколу, поэтому подключается к HTTP MCP через мост mcp-remote (npm-пакет). npx устанавливает его автоматически — нужен только Node.js 18+ на машине.

  • Откройте файл `claude_desktop_config.json` (на macOS: `~/Library/Application Support/Claude/`, на Windows: `%APPDATA%\Claude\`). Если файла нет — создайте его
  • Добавьте блок `mcpServers` с командой `npx -y mcp-remote https://geoscout.pro/api/mcp` (точный JSON есть на странице /mcp в дашборде, в разделе Claude Desktop)
  • Сохраните файл и полностью перезапустите Claude Desktop. При первом запуске npx скачает mcp-remote и откроет браузер для OAuth-авторизации
  • На экране согласия GEO Scout подтвердите доступ к аккаунту. После подключения попросите агента показать доступные бренды и выбрать нужный; активный бренд сохраняется для этого подключения.
  • В Claude Desktop появится индикатор подключённого MCP-сервера в нижней части окна чата — значит подключение готово
Совет

Для подключения по личному токену (PAT) добавьте к args флаг `--header "Authorization: Bearer gs_<ваш-токен>"`. На Windows из-за бага с экранированием пробелов лучше задать токен через переменную окружения `AUTH_HEADER` (значение `Bearer gs_...`) и подставить её в args как `Authorization:$AUTH_HEADER` — точные сниппеты есть на странице /mcp.

1.8

ChatGPT Apps / developer mode

Обычный пользовательский экран ChatGPT Connectors не является надёжным универсальным способом подключить произвольный внешний MCP-сервер. Для ChatGPT актуальный путь — ChatGPT Apps SDK: приложение предоставляет MCP-сервер, а тестирование проходит в developer mode. Используйте этот вариант только если у вас есть доступ к разработке ChatGPT Apps.

  • Для повседневной работы используйте Codex, Claude Desktop, Claude Code или Cursor — эти клиенты напрямую поддерживают MCP-подключение GEO Scout
  • Если у вас включён ChatGPT Apps developer mode, регистрируйте GEO Scout как MCP backend приложения по документации OpenAI Apps SDK
  • OAuth-согласие GEO Scout всё равно проходит на стороне GEO Scout: пользователь выбирает бренд и подтверждает scope
  • Не используйте этот раздел как инструкцию для обычного ChatGPT Connectors UI: доступность и сценарий зависят от аккаунта и режима разработки
1.9

Cursor

Cursor подключает MCP-серверы через UI-форму «Connect to a custom MCP» — никакие JSON-файлы редактировать не нужно. Подходит как глобальное подключение, так и project-only.

  • Откройте Cursor → Settings → MCP servers → «+ Add server»
  • В диалоге заполните: Name = `geoscout`, Transport = `Streamable HTTP`, URL = `https://geoscout.pro/api/mcp`
  • Сохраните — Cursor откроет браузер для OAuth-авторизации, выберите бренд на экране согласия GEO Scout
  • Для PAT-подключения вместо OAuth: в блоке Headers нажмите «+ Add header», Key = `Authorization`, Value = `Bearer gs_<ваш-токен>`
  • После сохранения сервер появится в списке MCP servers — иконка инструментов будет доступна в Composer и Chat
Совет

Чтобы подключить сервер только для одного проекта, создайте файл `.cursor/mcp.json` в корне репозитория с тем же конфигом — Cursor подхватит его автоматически и подключение не «утечёт» в другие проекты.

1.10

Claude Code CLI

Claude Code — однострочное подключение через `claude mcp add`. OAuth flow проходит автоматически в браузере, конфиг сохраняется в проекте.

  • В терминале в корне проекта выполните: `claude mcp add --transport http geoscout https://geoscout.pro/api/mcp`
  • Claude Code автоматически откроет браузер для OAuth-подтверждения. Флаг `--transport http` обязателен для streamable HTTP MCP
  • На экране согласия GEO Scout подтвердите доступ к аккаунту. После подключения попросите агента показать доступные бренды и выбрать нужный; активный бренд сохраняется для этого подключения.
  • Подключение сохранится в `.claude/` папке проекта. Для PAT добавьте `--header "Authorization: Bearer gs_<токен>"`
1.11

Браузерный агент (WebMCP)

Тот же стратег, но без единого конфига. Если в браузере есть поддержка WebMCP (черновой стандарт W3C на базе API navigator.modelContext), GEO Scout сам отдаёт инструменты только для чтения AI-агенту, который работает прямо во вкладке. Не нужен ни токен, ни OAuth — агент действует от вашей сессии и видит данные текущего бренда. Это самый короткий путь к разбору: открыли дашборд — и спрашиваете «почему мы выпали из этого промпта» там же, где смотрите цифры.

  • Ноль настройки — инструменты текущего бренда отдаются браузерному агенту автоматически при заходе на дашборд
  • Только чтение: видимость, доля голоса, цитирования, конкуренты, источники, контент-планы. Запись (промпты, кластеры) остаётся за OAuth/PAT
  • Авторизация по сессии браузера — отдельный токен не нужен, доступ ровно к тем брендам, что и в интерфейсе
  • Сегодня доступно в Chrome 146+ Canary с флагом «WebMCP for testing»; стандарт ещё ранний, поддержка браузеров будет расширяться
Совет

WebMCP не заменяет OAuth/PAT, а дополняет их. Для записи, скриптов и внешних клиентов (Claude Desktop, Cursor) используйте подключение по токену; WebMCP — это помощник с доступом только на чтение в том же окне, где вы и так работаете.

1.12

С чего начать: где бренд уже виден

Запрос к агенту: «Покажи видимость текущего бренда за последние 7 дней отдельно по нейросетям. Укажи даты, число полученных ответов, охват и долю голоса. Объясни, где нас рекомендуют, а где просто упоминают».

  • Начните с проверки проекта: агент должен назвать активный бренд, период анализа и дату последних данных. Если мониторинга ещё нет, сначала нужен запуск, а не выводы о видимости.
  • Попросите показать охват вместе с основанием расчёта: сколько ответов содержат бренд и сколько ответов всего получено. Так вы увидите разницу между отсутствием бренда и отсутствием данных.
  • Сравните платформы отдельно. Общий показатель может скрывать ситуацию, когда бренд заметен в одной нейросети и почти отсутствует в другой.
  • Полезный результат: краткая сводка по движкам и несколько конкретных ответов с датами, промптами и ссылками на их разбор. Отдельно — упоминание, рекомендация и оговорки о бренде.
Совет

Охват отвечает на вопрос «как часто нас называют», доля голоса — «какая часть упоминаний брендов приходится на нас». Эти показатели могут меняться в разные стороны.

1.13

Где нейросети выбирают конкурентов вместо вас

Запрос к агенту: «За последние 30 дней найди 5 запросов, в ответах на которые называют конкурентов, а наш бренд отсутствует. Для каждого покажи вопрос, нейросеть, дату ответа, названные бренды и процитированные URL».

  • Начните с реальных вопросов из мониторинга: «Какой сервис выбрать?», «Где заказать услугу?», «Что подойдёт под мои условия?». Не подменяйте их вопросом, в котором ваш бренд уже назван.
  • Выберите один пробел и попросите открыть полные ответы. Уточните: «Что именно рекомендуют у конкурента — продукт, цену, доставку, опыт в отрасли или конкретную функцию?»
  • Разделите два наблюдения: какие бренды названы в тексте и какие страницы использованы как источники. Упоминание конкурента не означает, что AI цитирует его сайт.
  • Попросите обосновать выводы короткими цитатами из ответов и, если доступны, сохранённых страниц. Если данных недостаточно, агент должен явно отметить гипотезу.
  • Полезный результат: список конкретных запросов, по которым вы теряете присутствие, с примерами ответов и следующим действием для каждого: проверить факты, доработать страницу или изучить внешнюю площадку.
Совет

Сначала выбирайте пробелы по важным для бизнеса сценариям. Большое число упоминаний конкурента само по себе не говорит о спросе на запрос или о его ценности для ваших продаж.

1.14

На каких страницах стоит добиваться упоминания

Запрос к агенту: «Для найденных запросов без нашего бренда покажи страницы, которые нейросети цитируют чаще всего. Раздели наш сайт, сайты конкурентов и сторонние площадки. Найди страницы, где подтверждено упоминание нашего бренда, и страницы, которые ещё нужно проверить».

  • Смотрите на конкретные URL и вопросы, для которых они цитируются. Один домен может содержать и подходящий обзор вашей категории, и материал, не связанный с продуктом.
  • На внешних площадках ищите релевантный формат: сравнение решений, подборку поставщиков, разбор задачи или отраслевой кейс. Решение о размещении принимайте по содержанию страницы.
  • Если сохранённая копия доступна, попросите прочитать её: какие бренды там названы, по каким критериям их сравнивают, какие факты и ссылки приводят. Уточните дату сохранения.
  • Не считайте любую цитируемую страницу упоминанием бренда. Проверка может подтвердить присутствие, не найти его или не дать однозначного результата; непроверенный URL требует отдельной проверки.
  • Полезный результат: короткий список страниц для работы с объяснением «какой вопрос закрывает», «кого AI берёт из неё сейчас» и «что агентству или PR-команде стоит проверить перед обращением».
Совет

Цитируемая площадка — кандидат для изучения, а не гарантия попадания в ответы. Упоминание на странице и последующее цитирование этой страницы нейросетью проверяйте отдельно.

1.15

Разбери оговорки о бренде

Запрос к агенту: «Разбери оговорки о нашем бренде за последние 30 дней: что мешает нейросетям рекомендовать нас уверенно, в каких ситуациях они предпочитают конкурентов и чем это подтверждается в ответах».

  • Попросите собрать формулировки оговорок и открыть полные ответы с датой, нейросетью и исходным промптом. Оговорка может быть частью в целом положительного ответа — смотреть только негативную тональность недостаточно.
  • Сгруппируйте их по смыслу: ограничения продукта, условия покупки, отсутствие нужной функции, непонятное позиционирование или преимущество конкурента. Для каждой группы нужны примеры из данных, а не общие предположения.
  • Уточните: «Кому AI отдаёт предпочтение в этих ответах и почему? Покажи конкретные цитаты». Отделите реальное ограничение продукта от устаревшего или неподтверждённого утверждения.
  • По каждой важной оговорке попросите найти подтверждение в доступных цитируемых страницах. Сам факт цитирования URL не доказывает, что именно эта страница стала причиной оговорки.
  • Полезный результат: оговорка → пример ответа → кого предпочли → что проверить или исправить. Например, уточнить условия на сайте, подтвердить факт, обновить описание функции или признать, что сценарий действительно не подходит продукту.
Совет

Если данные об оговорках ещё не извлечены или выборка мала, агент должен это указать. Пустой список не всегда означает, что у нейросетей нет сомнений о бренде.

1.16

Какие страницы цитируют у конкурентов, а у нас — нет

Запрос к агенту: «За последние 30 дней сравни страницы, которые нейросети цитируют у конкурентов и у нас по одинаковым вопросам. Изучи sitemap нашего бренда с доступными title и покажи, каким страницам конкурентов у нас есть соответствие, а каких материалов действительно не хватает».

  • Начните с точных URL цитируемых страниц конкурентов и нашего сайта. Сравнивайте один период, одинаковые нейросети и вопросы: ссылка на главную, карточка продукта и инструкция решают разные задачи.
  • Попросите прочитать sitemap бренда постранично, включая доступные HTML title. Агент должен показать дату инвентаризации, полноту списка и URL, для которых заголовок не удалось получить.
  • Для каждой релевантной страницы конкурента найдите у нас страницу на ту же тему. Title и URL помогают выбрать кандидата, но соответствие нужно подтвердить чтением содержимого; похожего названия недостаточно.
  • Разделите случаи: наша страница цитируется; была найдена среди источников, но не вошла в ответ; есть в sitemap, но цитирование не наблюдается; подходящий материал не найден в доступном инвентаре. Последнее ещё не доказывает отсутствие страницы на сайте.
  • Полезный результат: URL конкурента → что в нём отвечает на вопрос → наш URL и его статус цитирования → подтверждённые различия → действие. Сначала доработайте подходящие существующие страницы; новые предлагайте там, где соответствие не найдено после проверки.
Совет

Отсутствие цитирований в выборке не означает, что страница не индексируется или неизвестна нейросети. При неполном sitemap или недоступном содержимом фиксируйте, что именно осталось непроверенным.

1.17

Какие данные доступны агенту

Ассистент получает через MCP данные для анализа, а при разрешении записи может выполнять отдельные изменения. Опишите задачу обычными словами — он сам выберет нужные инструменты.

  • Метрики: охват, доля голоса, доля цитирований и частота упоминания страниц — за выбранный период, по нейросетям и кластерам запросов, со сравнением периодов.
  • Источники: домены и URL, категории, сравнение с конкурентами и сохранённое содержимое страниц, если оно доступно. Сохранённая версия помогает изучить контекст, но может отличаться от текущей страницы.
  • Конкуренты: активные и отключённые записи, сайты, варианты названий, сравнения и конкурентные пробелы. Общий счётчик упоминаний в списке — за всю историю, а не за выбранный период.
  • Запросы и ответы: где бренд уступает конкурентам, полные тексты ответов нейросетей, тональность, позиция бренда, цитируемые источники и упомянутые конкуренты.
  • Действия и контент-планы: просмотр задач и планов, создание задач в Командном центре и сохранение подготовленных ассистентом идей, статей или правок в карточке задачи.
  • Точность ответов: факты о компании, выбранные для проверки запросы, результаты проверок, спорные утверждения и ссылки на источники.
  • Карта сайта бренда: URL из sitemap, настоящие HTML title, даты обновления и полнота инвентаризации. Большие списки выдаются постранично; недоступный заголовок остаётся неизвестным, а не придумывается.
Совет

Полный список инструментов с описаниями — на странице MCP в дашборде. Если вам не хватает данных или нужного действия, напишите в поддержку.