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, тому він не може розійтися зі специфікацією.
| Method | Path | operationId | Summary |
|---|---|---|---|
| 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 |
Швидкий старт
Три запити покривають майже все, що потрібно агенту: що продається, скільки коштує і що написано на сторінці.
curl https://yootraffic.com/api/v1/products
curl https://yootraffic.com/api/v1/pricing
curl "https://yootraffic.com/api/v1/content?path=/uk/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/uk/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 бракує чогось потрібного, розкажіть, що ви робите, і ми подивимось, чи можна це додати.