API и MCP-сервер YOOtraffic

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

YOOtraffic Content API

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

Базовый URL
https://yootraffic.com/api/v1
Спецификация OpenAPI 3.1
https://yootraffic.com/openapi.json
Авторизация
Не требуется. Все эндпоинты публичные, только на чтение, доступны с любого источника.
Формат ответа
JSON, UTF-8, кэш пять минут на границе сети.

Эндпоинты

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

MethodPathoperationIdSummary
GET/api/v1getServiceIndexDescribe the API
GET/api/v1/productslistProductsList products
GET/api/v1/products/{productId}getProductGet one product
GET/api/v1/pricinggetPricingGet the pricing model
GET/api/v1/pageslistPagesList public pages
GET/api/v1/contentgetPageContentGet a page as markdown
GET/api/v1/postslistBlogPostsList blog posts
GET/api/v1/searchsearchSiteSearch pages and posts

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

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

curl https://yootraffic.com/api/v1/products
curl https://yootraffic.com/api/v1/pricing
curl "https://yootraffic.com/api/v1/content?path=/ru/pricing"

MCP-сервер

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

Адрес
https://yootraffic.com/mcp
Транспорт
Streamable HTTP (POST, JSON-RPC 2.0)
Манифест сервера
https://yootraffic.com/mcp.json

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

{
  "mcpServers": {
    "yootraffic": {
      "type": "http",
      "url": "https://yootraffic.com/mcp"
    }
  }
}

Инструменты

  • 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.

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

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

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

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

Вопросы

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