getAdvantage MCP Server

Аутентификация

Создайте ключ в разделе /app/api-keys (отображается один раз — сохраните его как секрет окружения, никогда не коммитьте). Отправляйте его как Bearer-токен в любом запросе:

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"
-H "Authorization: Bearer adv_live_…"

Без заголовка вы получаете бесплатный тариф без ключа (ограничение по IP, семплированный вывод). С ключом действует лимит согласно вашему тарифному плану, а платный план возвращает живой вывод модели. При превышении лимита возвращается HTTP 429 с заголовком retry-after; недействительный ключ возвращает 401.

Ограничения по частоте запросов

Ограничения соблюдаются для каждого ключа (или для каждого IP при отсутствии ключа) в момент запроса:

• Без ключа: 5/мин · 30/день, семплированный вывод
• Starter: 60/мин · 1 000/день, живой вывод
• Pro: 120/мин · 5 000/день, живой вывод
• Agency: 240/мин · 20 000/день (добросовестное использование), живой вывод

Комбинированная конечная точка считается за одно обращение с той же частотой для каждого движка (никогда не снимает трижды за один вызов).

Конечные точки

GET/api/analyze?url=

Get Found — сканирование читаемости для ИИ (9 сигналов)

Оценивает, насколько страница удобочитаема для ИИ-движков по девяти сигналам (title, meta description, структурированные данные, заголовки, llms.txt, соотношение контента к разметке, Open Graph, canonical, robots). Возвращает разбивку по каждому сигналу, готовые к вставке исправления и сгенерированный стартовый llms.txt.

curl "https://getadvantage.app/api/analyze?url=https://yourapp.com"

GET/api/verify-convert?url=

Convert — готовность к конверсии + 5-секундное «холодное чтение»

Оценивает сигналы, которые определяют, поймёт ли новый посетитель приложение и зарегистрируется ли. На платном ключе также запускает агентный 5-секундный тест первого впечатления. Возвращает проверки, исправления, процентиль бенчмарка и ссылку на отчёт /v.

curl "https://getadvantage.app/api/verify-convert?url=https://yourapp.com"

GET/api/verify-safety?url=

Ship Verified — проверки безопасности поставки + значок

Выполняет детерминированные проверки на распространённые уязвимости при «вайб-кодинге» (секреты в клиентском бандле, конфигурация бэкенда, открытые файлы, заголовки безопасности, CORS, транспорт, карты исходников). Пройденная проверка означает, что мы не обнаружили эту конкретную проблему — и ни в коем случае не то, что приложение безопасно или сертифицировано. Возвращает проверки, исправления, процентиль бенчмарка, отчёт /v и значок «Checked by Advantage».

curl "https://getadvantage.app/api/verify-safety?url=https://yourapp.com"

POST/api/v1/scan/combined

Combined — все три движка в одном вызове

Запускает все три движка для одного URL и возвращает один ответ: три независимых блока оценок (никогда не усредняются), сводку пересечений с указанием самого слабого измерения и единственного наиболее важного следующего шага, а также одну постоянную ссылку. Самый быстрый способ получить полную картину в одном запросе.

curl -X POST "https://getadvantage.app/api/v1/scan/combined"
-H "Content-Type: application/json"
-H "Authorization: Bearer adv_live_…"
-d '{"url":"https://yourapp.com"}'

MCP-сервер — сканируйте прямо из редактора

Advantage также является сервером Model Context Protocol, поэтому вы можете один раз добавить его в Claude Code, Cursor, Claude Desktop или Windsurf и просто написать: «просканируй моё приложение с помощью getadvantage». Он работает по протоколу remote Streamable HTTP (текущий официальный удалённый транспорт) — нулевая установка, сканирование выполняется на наших серверах. Предоставляет четыре инструмента: get_found, convert_check, ship_verified и combined_scan. Каждый выводит оценку и самое важное готовое к вставке исправление, а также ссылку на отчёт.

Добавление (Cursor / Claude Desktop / Claude Code)

Вставьте это в конфигурацию вашего MCP-клиента:

{ "mcpServers": { "getadvantage": { "url": "https://getadvantage.app/api/mcp" } } }

С API-ключом (повышенная частота, живой вывод) добавьте заголовок:

{ "mcpServers": { "getadvantage": { "url": "https://getadvantage.app/api/mcp", "headers": { "Authorization": "Bearer adv_live_…" } } } }

Или в Claude Code одной строкой:

claude mcp add --transport http getadvantage https://getadvantage.app/api/mcp

MCP-сервер можно бесплатно попробовать без ключа с ограничениями бесплатного тарифа; ключ повышает лимит и возвращает живой вывод, точно так же, как HTTP API.

Хотите отслеживать сайты, видеть историю и автоматически применять исправления через встраиваемый модуль? Создайте аккаунт — или сначала бесплатно просканируйте одно приложение.

Спросить Ray