getAdvantage MCP

API и MCP документация

Запускайте три сканирования Advantage из собственного кода, CI или прямо из вашего AI-редактора. Get Found измеряет, как AI читает живой URL. Convert проверяет, зарегистрировался бы новый посетитель. Ship Verified проверяет, что страница опубликовала лишнего. Каждый результат — это фактическое измерение на момент сканирования, а не вердикт, сертификация или гарантия.

API можно бесплатно попробовать без ключа с ограничением по IP. API-ключ повышает лимит до уровня вашего тарифа и возвращает живые результаты модели на платном плане. Машиночитаемая спецификация доступна по адресу /api/openapi.json.

Зачем подключать один раз? Чтобы не поддерживать AEO вручную. Добавьте embed или один API-вызов в ваш CI, и безопасные для DOM исправления (JSON-LD, meta, FAQ) будут применяться сами; мы перепроверяем, как ChatGPT, Perplexity, Gemini и Claude меняют способ чтения сайтов, поэтому ваши оценки остаются актуальными без погони за трендами. Нейтральный инструмент непрерывно следит за AI-видимостью и безопасностью публикаций — независимый контроль, а не разовый аудит. (Ваши llms.txt и robots.txt остаются файлами, которые вы размещаете один раз.)

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

Создайте ключ на /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/день (разумное использование), живые результаты

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

Endpoints

GET /api/analyze?url=

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

Оценивает, насколько страница читаема для AI-движков по девяти сигналам (заголовок, meta-описание, структурированные данные, заголовки, 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 — проверки безопасности публикаций + бейдж

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

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

POST /api/v1/scan/combined

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

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

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 и просто написать «scan my app with getadvantage». Он работает через удалённый 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.

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