# API и MCP-сервер YOOtraffic

> Публичный API YOOtraffic только на чтение, MCP-сервер по Streamable HTTP и markdown-версия каждой страницы. Без ключа и регистрации.

Всё, что публикует этот сайт, доступно программам так же, как людям: JSON API только на чтение, MCP-сервер и markdown-представление каждой страницы. Без ключа, без регистрации, без лимитов сверх обычной защиты от злоупотреблений.

## YOOtraffic Content API

Публичный REST API по каталогу продуктов, модели цен, списку страниц, тексту страниц и блогу. Он отвечает на вопросы о продукте. Он не заказывает трафик и не управляет кампанией: это делается в личном кабинете и через этот API недоступно.

Базовый URL

Спецификация OpenAPI 3.1

Авторизация

Не требуется. Все эндпоинты публичные, только на чтение и открыты для запросов с любых доменов (CORS).

Формат ответа

JSON, UTF-8, кэшируется на CDN на пять минут.

## Эндпоинты

Список формируется из документа OpenAPI, поэтому он не может разойтись со спецификацией.

## Быстрый старт

Три запроса покрывают почти всё, что нужно агенту: что продаётся, сколько стоит и что написано на странице.

## MCP-сервер

Те же операции в виде MCP-инструментов по транспорту Streamable HTTP. Укажите любому MCP-клиенту адрес ниже. Шага авторизации нет, сессия не хранится: каждый инструмент только читает.

Адрес

Транспорт

Streamable HTTP (POST, JSON-RPC 2.0)

Манифест сервера

Конфигурация клиента

Инструменты

## Markdown для каждой страницы

Каждая страница отдаётся не только как HTML, но и как markdown, поэтому краулеру не нужно разбирать вёрстку, чтобы прочитать текст.

- Отправьте Accept: text/markdown на любой адрес страницы и получите её же в markdown.
- Или добавьте .md к пути: https://yootraffic.com/ru/pricing.md
- В ответах есть Vary: Accept и заголовок Link со ссылкой на markdown-версию.
- Если заголовок Accept отвергает оба представления, сервер отвечает 406 и не пытается угадать формат.
- Несуществующий путь отдаёт настоящий 404 с markdown-телом, где перечислено, куда идти дальше.

## Машиночитаемые файлы

- Спецификация OpenAPI: https://yootraffic.com/openapi.json
- Манифест MCP-сервера: https://yootraffic.com/mcp.json
- Описание сайта для языковых моделей: https://yootraffic.com/llms.txt
- Цены в markdown: https://yootraffic.com/pricing.md
- Карта сайта: https://yootraffic.com/sitemap.xml
- Правила для краулеров: https://yootraffic.com/robots.txt

## Вопросы

Пишите на support@yootraffic.com. Если в API не хватает чего-то нужного, расскажите, что вы делаете, и мы посмотрим, можно ли это добавить.

## Endpoints

- `GET /api/v1` (getServiceIndex): Describe the API
- `GET /api/v1/products` (listProducts): List products
- `GET /api/v1/products/{productId}` (getProduct): Get one product
- `GET /api/v1/pricing` (getPricing): Get the pricing model
- `GET /api/v1/pages` (listPages): List public pages
- `GET /api/v1/content` (getPageContent): Get a page as markdown
- `GET /api/v1/posts` (listBlogPosts): List blog posts
- `GET /api/v1/search` (searchSite): Search pages and posts

## MCP tools

- `list_products`: List every YOOtraffic product with its traffic type, billing unit, entry price, and what is included. Use this to answer what the company sells.
- `get_pricing`: Unit prices for every product plus the account terms (minimum deposit, refunds, balance expiry) and an explicit list of what the service does not deliver. Prices are USD, pay-as-you-go, no subscription. Call this instead of quoting a price from memory.
- `list_pages`: The index of every public page with its title, description, URL, and markdown URL. Use it to find the page that answers a question before fetching its text.
- `get_page_content`: The full text of any public page as markdown, including blog posts and legal documents. Give a site path such as /en/pricing or /en/blog/some-post.
- `list_blog_posts`: Published articles, newest first, with title, excerpt, date, and markdown URL.
- `search_site`: Search page titles, page descriptions, and article titles and excerpts. Returns URLs and markdown URLs so the matching text can be fetched directly.

---

- HTML version of this page: https://yootraffic.com/ru/developers
- Site index for agents: https://yootraffic.com/llms.txt
- Sitemap: https://yootraffic.com/sitemap.xml