API ВЕГА
English

ai-visibility-mcp

Узнайте, что AI-ассистенты знают о компании и рекомендуют ли её в своих ответах. Сервис бесплатный и доступен через хостинг — учётная запись и API key не нужны.

Подключите его к Claude, Cursor, VS Code или любому MCP-клиенту и попросите ассистента проверить видимость вашего сайта в AI-поиске. Ассистент проведёт полный аудит по упорядоченному плану:

  • Составить план аудита. Пошаговый список: изучить сайт, проверить доступ для краулеров, сформировать вопросы покупателей, выявить реальных конкурентов и сторонние источники, на которые опирается AI, оценить доказательства и подготовить список приоритетных исправлений со ссылками на подтверждающие материалы.

  • Проверить страницы сайта так, как их видит AI. Изучить товары, цены, правила, сравнительные таблицы и структурированные данные о компании в коде страниц — до пяти страниц за раз. Для каждой страницы также будут перечислены факторы, влияющие на готовность к обработке AI: рендеринг только с помощью JavaScript, noindex, canonical, schema, структура ответов, источники, дата и автор. Для каждого вывода приводится документация.

  • Проверить доступ для AI-краулеров. Узнать, каким AI-краулерам robots.txt разрешает доступ, ограничивает его или блокирует, что это означает для ChatGPT, Perplexity, Gemini, Claude и Google AI Mode, отвечает ли проверка безопасности на обычный запрос и как именно устранить проблему.

  • Проверить, цитирует ли AI ваш сайт или упоминает ли компанию. Вставьте ответ любого ассистента. Вы увидите, ссылается ли он на ваш сайт, только упоминает компанию или не упоминает вовсе, к каким типам относятся источники каждой цитаты и почему вас могли не процитировать.

  • Узнать, откуда AI-платформы берут информацию для ответов. Посмотреть на сочетание источников, которые цитирует каждая AI-платформа, и недавние изменения на основе опубликованного AI Search Index от SurfacedBy. К каждому выводу прилагаются ссылки на исследования.

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

https://api.surfacedby.com/api/v1/mcp/public/

Транспорт: Streamable HTTP. Аутентификация не требуется.

Установка

Claude Code

claude mcp add --transport http surfacedby-ai-visibility https://api.surfacedby.com/api/v1/mcp/public/

Claude (claude.ai и desktop)

Откройте Customize > Connectors, нажмите + Add, затем выберите Add custom connector. Укажите имя SurfacedBy AI Visibility, вставьте URL выше и выберите No sign in. Включите подключение в чате: + > Connectors.

В планах Team и Enterprise сначала владелец организации должен добавить его в разделе Organization settings > Connectors. В плане Free можно добавить одно пользовательское подключение.

Cursor

Добавьте конфигурацию в ~/.cursor/mcp.json или в .cursor/mcp.json проекта:

{
  "mcpServers": {
    "surfacedby-ai-visibility": {
      "url": "https://api.surfacedby.com/api/v1/mcp/public/"
    }
  }
}

VS Code

Добавьте конфигурацию в .vscode/mcp.json:

{
  "servers": {
    "surfacedby-ai-visibility": {
      "type": "http",
      "url": "https://api.surfacedby.com/api/v1/mcp/public/"
    }
  }
}

Другие клиенты

К URL выше можно подключить любой клиент, поддерживающий удалённые серверы Streamable HTTP. Если клиент поддерживает только stdio, используйте мост, например mcp-remote:

{
  "mcpServers": {
    "surfacedby-ai-visibility": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.surfacedby.com/api/v1/mcp/public/"]
    }
  }
}

ChatGPT

Приложение ChatGPT на основе этого сервера проходит проверку. Статус и подробности: surfacedby.com/tools/chatgpt-ai-visibility.

Примеры запросов

Проведи аудит видимости yourbrand.com в AI-поиске. Мы продаём продукты небольшим бухгалтерским фирмам в Великобритании.
Могут ли ChatGPT и Perplexity сканировать yourbrand.com? Если нет, что именно нужно изменить?
Я управляю yourbrand.com. Что может помешать AI рекомендовать нас, когда люди спрашивают о лучшем инструменте в нашей категории, и что нужно исправить в первую очередь?
Вот ответ ChatGPT на мой вопрос о компании: "<paste the answer>".
Сайт компании: https://yourbrand.com. AI действительно ссылается на нас или только упоминает?
Есть ли в ответе ошибки, если сравнить его с информацией на наших страницах?
Сравни страницы с ценами и описанием функций на competitor-a.com и competitor-b.com
для небольшой компании, которая выбирает между ними. Используй только информацию
с этих страниц и перечисли, что осталось неизвестным.
Проверь страницу https://yourbrand.com/pricing. Какие факты с неё может прочитать AI-система, а что отсутствует или сформулировано неясно?

Инструменты

Все инструменты доступны бесплатно, работают только на чтение и не требуют учётной записи.

surfacedby_plan_ai_visibility_audit

Входные данныеТипПримечания
business_urlstringСайт компании. Можно указать домен без протокола и пути.
goalstring, optionalfull_audit (по умолчанию), compare_competitors, check_answers или fix_crawler_access.
marketstring, optionalСтрана, регион или город, в котором работает компания.
languagestring, optionalЯзык компании и её покупателей.
competitorsarray of strings, optionalДо 5 известных пользователю конкурентов.

Возвращает упорядоченный список проверок для выбранной цели, инструменты для каждого шага, критерии качества результата, правила работы, применимые опубликованные результаты исследований и оставшийся лимит запросов. Не отправляет запросы на сайт.

surfacedby_inspect_page_evidence

Входные данныеТипПримечания
urlsarray of stringsОт 1 до 5 общедоступных URL с протоколом HTTP(S). Можно указать домен без протокола и пути.

Для каждого URL возвращает содержимое, которое AI-система может извлечь: заголовок, описание, заголовки разделов, разделы, таблицы, внутренние и внешние ссылки, а также объявленные структурированные данные. Также указывает тип страницы и источника и результаты проверки готовности либо объясняет, почему страница недоступна: доступ ограничен через robots.txt, сработала проверка для ботов, формат не поддерживается или произошла ошибка. Если одновременно проверяются несколько страниц одного сайта, инструмент также перечисляет факты о компании, которые в структурированных данных указаны по-разному. В каждом результате указаны оставшийся лимит запросов и следующий шаг аудита.

Работает только на чтение, идемпотентен и получает данные из открытого веба.

surfacedby_check_ai_crawler_access

Входные данныеТипПримечания
domainstringДомен или любой URL на сайте.

Показывает, разрешён ли доступ каждому AI-краулеру, ограничен или заблокирован, и какое правило robots.txt отвечает за это. Краулеры разделены по назначению: блокировка краулеров для обучения не влияет на цитирование, а блокировка краулеров поисковых индексов и систем поиска информации влияет. Для каждой AI-платформы инструмент указывает, какой поисковый индекс она использует и куда отправлять страницы. Также проверяет, ответила ли проверка безопасности на обычный запрос, и показывает noindex главной страницы, llms.txt, Content-Signal и готовые к копированию исправления. Инструмент читает общедоступные файлы сайта и отправляет один обычный запрос; он не выдаёт себя за краулер и не может обнаружить правила брандмауэра, настроенные для IP-адресов самих краулеров.

Работает только на чтение, идемпотентен и получает данные из открытого веба (около трёх запросов).

surfacedby_analyze_answer_evidence

Входные данныеТипПримечания
answerstringТекст ответа AI длиной до 64 000 символов. Ссылки в Markdown учитываются.
business_urlstringСайт компании, которую нужно найти в ответе.
brand_namestring, optionalПомогает обнаруживать упоминания, если название бренда отличается от домена.
languagestring, optionalЯзык ответа.
platformstring, optionalchatgpt, perplexity, gemini, claude, ai_mode, grok, deepseek или other.
competitor_domainsarray of strings, optionalДо 10 доменов конкурентов, чтобы их страницы были обозначены как страницы конкурентов.

Показывает, как бренд представлен в конкретном ответе (cited, named или not_observed), перечисляет все видимые цитаты с указанием типа источника (сайт с отзывами, список лучших, форум, конкурент, сайт компании и другие), а также показывает, какие типы источников встречаются чаще всего. Если компания не процитирована, инструмент указывает вероятную причину и способ исправления. Ссылки-переадресации Google и Gemini раскрываются до страниц, на которые они ведут.

Работает только на чтение и идемпотентен. Не отправляет сетевые запросы, кроме случаев, когда ответ содержит ссылку-переадресацию Google или Gemini.

surfacedby_get_ai_source_landscape

Входные данныеТипПримечания
platformstring, optionalОграничить результат одной AI-платформой: chatgpt, perplexity, gemini, claude, ai_mode, grok или deepseek. Если для платформы ещё нет данных в индексе, инструмент сообщает об этом и перечисляет платформы, по которым данные доступны.
topicstring, optionalВыбрать результаты исследований по теме, например reddit, crawlers или competitors.

Для каждой AI-платформы возвращает доли цитат по категориям источников, последние изменения в использовании конкретных источников и особенности цитирования в ответах. Данные берутся из опубликованного AI Search Index от SurfacedBy. Результат включает дату данных и ссылку на общедоступную страницу, а также результаты исследований с указанием выборок, дат и ссылок на публикации. Это сводные показатели для множества брендов, а не данные об отдельной компании.

Работает только на чтение и идемпотентен.

Промпты и ресурсы

Клиентам, которые отображают промпты MCP, доступны четыре готовые команды: Полный аудит видимости в AI, Сравнить нас с конкурентами, Проверить, как AI описывает нас в ответах и Исправить доступ для краулеров AI. Для каждой команды укажите URL компании, а также при необходимости — конкурентов и рынок.

Клиенты, которые читают ресурсы, могут использовать два ресурса: surfacedby://method/ai-visibility-audit (полное описание метода аудита) и surfacedby://research/findings (опубликованные результаты исследований с указанием выборки, даты и ссылки для каждого результата).

Отслеживание изменений во времени

Сервер работает со страницами и ответами в рамках вашего диалога, а его исходные данные объединяются для многих брендов. Чтобы отслеживать, как ChatGPT, Perplexity, Gemini и другие AI-платформы упоминают ваш бренд, каких конкурентов рекомендуют вместо него и каким источникам доверяют, воспользуйтесь сервисом SurfacedBy. Или выполните разовую проверку с помощью бесплатного инструмента проверки видимости в AI.

Страницы, для загрузки которых требуются JavaScript, вход в систему или прохождение проверки для ботов, отмечаются как недоступные. Их содержимое не угадывается.

Ограничения и добросовестное использование

  • За один вызов проверки можно указать до 5 URL. Полный аудит обычно включает около 50 запросов к сайтам, которые он проверяет. Страницы, уже загруженные за последние 24 часа, не расходуют лимит.

  • Сервер бесплатный и доступен нескольким пользователям. Для него установлены дневной и месячный лимиты запросов, а также дневной лимит для каждого целевого сайта. Когда лимит исчерпан, инструменты возвращают понятное сообщение об ошибке, пока лимит не обновится.

  • Запросы выполняются с использованием user agent SurfacedByEvidence/1.0 (+https://surfacedby.com/tools/chatgpt-ai-visibility). Сервер соблюдает правила robots.txt, относящиеся к этому user agent, и следует только проверенным публичным перенаправлениям.

Конфиденциальность

Снимки страниц кэшируются максимум на 24 часа, чтобы повторные проверки выполнялись быстрее, после чего удаляются. Отправленные вами ответы анализируются в рамках запроса и не сохраняются. Статистика использования учитывается в виде дневных итоговых значений, а также хешированного счетчика по каждому сайту. Он сбрасывается ежедневно, чтобы предотвратить чрезмерное число запросов к одному сайту. Промпты, ответы и идентификаторы пользователей не сохраняются. Вызовы не связываются с аккаунтами SurfacedBy или посетителями сайтов.

Политика конфиденциальности: surfacedby.com/privacy. Условия использования: surfacedby.com/terms.

Поддержка

Создайте обращение в этом репозитории или свяжитесь с нами через surfacedby.com/contact.

О проекте

Создан Ali Khallad (GitHub) в рамках проекта SurfacedBy, который отслеживает, как AI-платформы упоминают бренды, ссылаются на них и рекомендуют их.

В этом репозитории находятся документация и метаданные реестра для размещённого сервера. Сам сервер работает как часть платформы SurfacedBy.

Лицензия

Содержимое этого репозитория распространяется по лицензии MIT.