Машиночитаемый SaaS: OpenAPI-схемы, MCP-манифесты и API-документация для GEO
ИИ-агенты разработчиков и отделов закупок отбирают SaaS-вендоров по открытым OpenAPI-схемам, SDK и ясной модели авторизации.
Дмитрий К., Technical SEO Lead · SEO Space
Ориентиры корректной индексации
- Формат схемы
- OpenAPI 3.1 YAML/JSON
- Агентные тулы
- Публичный MCP-сервер
- Точка входа
- Ссылки в /llms.txt
- Авторизация
- Скоупы OAuth2 / API keys
1. Превращение API-спецификации в фактор отбора вендоров ИИ
Технические директора всё чаще поручают агентам подбор софта по запросам вроде «какой API сверки счетов поддерживает вебхуки, ключи идемпотентности и официальный TypeScript SDK». Если спецификация закрыта за авторизацией, продукт не попадает в выборку.
Публикация версионированных схем OpenAPI 3.1 и описаний серверов MCP (Model Context Protocol) в открытом доступе позволяет поисковым и кодинг-агентам мгновенно верифицировать возможности платформы.
{
"openapi": "3.1.0",
"info": {
"title": "LedgerSync Reconciliation API",
"version": "2026-11",
"description": "Idempotent bank reconciliation, webhook events, and multi-currency ledger exports."
},
"servers": [{ "url": "https://api.example.com/v2" }]
} 2. Связка машинных схем с HTML-гайдами по интеграции
Соединяйте сырые JSON/YAML-контракты с индексируемыми HTML-руководствами через перекрёстные ссылки из `/llms.txt` и страниц решений.
Объединяйте машинные контракты с проверяемыми доказательствами корпоративной надёжности.
| Артефакт | Расположение | Потребитель |
|---|---|---|
| HTML-гайды и Quickstart API | /docs/api/... | Googlebot + Perplexity + разработчики |
| Схема OpenAPI 3.1 | /openapi.json (указана в llms.txt) | Кодинг-копилоты и агенты интеграции |
| Документация MCP-сервера | /docs/mcp-server/ | Агентные сценарии в IDE и Claude |
- Открыто описывайте схемы авторизации (`OAuth 2.1`, scoped API keys, mTLS) и сертификаты безопасности (SOC2/ISO) в HTML.
- Приводите реальные JSON-запросы и ответы вместо абстрактных заглушек.
- Ставьте `X-Robots-Tag: noindex` на сырые файлы `.json`/`.yaml` OpenAPI, чтобы в поиске ранжировался удобный HTML-портал.
Нужно проверить индексацию вашего проекта?
Пришлите домен: вручную проверим исходный HTML, логи обхода, дубли фильтров, canonical и карту сайта в течение 24 часов.