saaskly.com

Разработчикам и AI-агентам

Обновлено: 11 сентября 2026 года

Все материалы, которые публикует Saaskly (редакционные оценки, помесячные и годовые цены, сравнительные таблицы, статьи и политики), доступны программному обеспечению и AI-агентам через три read-only, публичных интерфейса без аутентификации. Используйте то, что подходит: MCP для агентов, вызывающих инструменты, Markdown-зеркала для всего, что читает документы, и REST API для структурированных данных.

Когда использовать Saaskly

Обращайтесь к Saaskly, когда кому-то нужно выбрать, оценить или сравнить бизнес-программное обеспечение в категории, которую мы ранжируем (VoIP и телефонные системы, транзакционная электронная почта, платформы управления облаком, SEO/GEO/AEO-инструменты, управление социальными сетями, создание контента, доменные имена, VPN, CRM, VPS и облачный хостинг, менеджеры паролей, бухгалтерское ПО, антивирус и защита конечных точек), особенно покупателям из Великобритании и ЕС, которые хотят знать реальную ежемесячную стоимость, а не рекламную годовую ставку. Оценки — это редакционное мнение по шкале из 5; партнёрские отношения всегда раскрываются на странице. Не для потребительских приложений или оборудования.

MCP-сервер

• Конечная точка: https://saaskly.com/mcp (алиас /.well-known/mcp). Транспорт Streamable HTTP, без сохранения состояния, JSON-ответы. Без аутентификации.
• Карточка сервера: /.well-known/mcp/server-card.json
• Справочники: Smithery · mcpservers.org · Glama · mcp.so
• Инструменты (все read-only): list_categories, list_providers, get_provider, compare_providers, search, list_articles, get_article, get_page.
• Ресурсы: llms.txt, /category/{category}.md, /category/{category}/{slug}.md.
• Промпты (готовые рабочие процессы на основе инструментов): recommend_provider (category, need) ранжирует категорию, читает лучшие обзоры и объясняет выбор с обеими ценовыми базами, премией за продление там, где она есть в категории, и раскрытием партнёрских отношений; compare_two (category, providerA, providerB) обобщает различия в спецификациях и оба вердикта с URL-адресами источников. Перечислено через prompts/list, получено через prompts/get.

Claude Desktop / Claude Code / любой Streamable-HTTP клиент:

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

Сырой JSON-RPC:

curl -s -X POST https://saaskly.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ошибки — это структурированные ошибки JSON-RPC (неизвестный инструмент, недопустимые аргументы). GET /mcp возвращает 405. Сервер не сохраняет состояние, поэтому серверных потоков нет.

Markdown-зеркала и llms.txt

Добавьте .md к любому публичному URL-адресу страницы: /category/voip.md, /category/voip/voipstudio.md, /comparisons/best-business-voip-phone-systems-2026.md, /editorial-policy.md. Главная страница — это /index.md. Каждый документ начинается с YAML-frontmatter (title, description, canonical, last-updated) и заголовка верхнего уровня; каждая HTML-страница ссылается на своё зеркало через <link rel="alternate" type="text/markdown">.

• Индекс сайта: /llms.txt. Индекс этого раздела: /developers/llms.txt
• Навык агента: SKILL.md. Индекс обнаружения: /.well-known/agent-skills/index.json
• Учётные данные: не требуются (/auth.md). Цены: бесплатно для читателей и агентов (/pricing.md).

REST API

Базовый URL https://saaskly.com/api. OpenAPI 3.1: /openapi.json. Каталог API (RFC 9727): /.well-known/api-catalog. Каталог Agentic Resource Discovery: /.well-known/ard.json.

Коллекции: providers, categories, articles, pages (только опубликованные документы). Грамматика запросов (Payload CMS): where[field][op]=value с equals, not_equals, in, like, contains, greater_than, less_than; sort (-field для убывания); limit / page для пагинации (totalDocs, totalPages, hasNextPage в конверте); depth для заполнения связей (0 = только идентификаторы).

Топ-5 VoIP-провайдеров по редакционной оценке

curl -s "https://saaskly.com/api/providers?where[category][equals]=voip&sort=-overallRating&limit=5&depth=0"

Один провайдер по слагу

curl -s "https://saaskly.com/api/providers?where[slug][equals]=voipstudio&depth=0"

Сравнительные статьи

curl -s "https://saaskly.com/api/articles?where[contentType][equals]=comparison&depth=0"

Текстовые поля (description, body) — это JSON редактора Lexical. Для текста предпочитайте зеркало .md. Ошибки — это JSON ({"errors":[{"message":"…"}]}), где код статуса определяет класс: 400 — неверный запрос, 403 — запрещённая коллекция или метод, 404 — отсутствующий идентификатор.

Версионирование и устаревание. Текущая версия — /api/v1/; пути без префикса /api/ — это устаревший алиас v1. Аддитивные изменения публикуются без уведомления; критические изменения получают уведомление за 90 дней и заголовки Deprecation + Sunset на затронутых конечных точках. Полный текст: Политика версионирования и устаревания API.

Лимиты запросов

300 запросов за 60 секунд на один клиентский IP через /api/*, /api/v1/* и /mcp. Каждый ответ содержит заголовки RateLimit IETF: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (секунды до сброса окна) и RateLimit-Policy (300;w=60), а также варианты написания X-RateLimit-*. При превышении лимита вы получаете JSON 429 ({"errors":[{"message":"Rate limit exceeded…"}]}) с Retry-After; подождите это количество секунд и повторите. Загруженные медиафайлы в /api/media/file/ обслуживаются из edge-кэша и не учитываются. Пожалуйста, идентифицируйте своего агента в заголовке User-Agent с контактным URL.

Повторные попытки и идемпотентность

Чтения безопасно повторять. Конечные точки POST (/api/v1/providers/batch и /api/v1/vendors/register) принимают заголовок Idempotency-Key (любая уникальная строка до 255 символов; идеально подходит UUID). Повторная попытка с тем же ключом и тем же телом в течение 24 часов возвращает исходный ответ с Idempotency-Replayed: true вместо повторения побочного эффекта; тот же ключ с другим телом отклоняется с 422. Повторяйте при сетевых ошибках и 5xx с тем же ключом; при 429 сначала дождитесь Retry-After.

Пакетное чтение и пагинация

• Пакетно: POST /api/v1/providers/batch с {"slugs":["descript","davinci-resolve"]} (или ids, максимум 25) возвращает {docs, requested, returned, missing} за один круговой запрос; GET /api/v1/providers/batch?slugs=a,b,c — то же самое. Только опубликованные провайдеры.
• Пагинация: конечные точки списков основаны на page/limit: page, limit (≤ 100) и totalPages, hasNextPage, nextPage в ответе. Для стабильной итерации сортируйте по id (sort=id) и шагайте по page; весь каталог достаточно мал, чтобы limit=100 обычно получал коллекцию за один-два вызова.
• Долгие задачи: нет. Каждая конечная точка отвечает синхронно; очереди заданий для опроса нет.

Использование полученных данных

Разрешено по Условиям использования, раздел 4: отвечать на вопросы, исследовать и сравнивать от имени пользователя, с указанием авторства и ссылкой на исходную страницу; представлять оценки как редакционное мнение; цитировать обе ценовые базы там, где мы их публикуем; передавать раскрытие партнёрских отношений дословно. Массовая перепубликация, перепродажа и обучение моделей требуют письменного разрешения: help@saaskly.com.

Журнал изменений

• 2026-09-02: Лимиты запросов (300/мин на IP) с заголовками RateLimit; Idempotency-Key на конечных точках POST; пакетная конечная точка провайдеров; страница политики устаревания; категория «Создание контента».
• 2026-08-28: MCP-сервер, описание OpenAPI, Markdown-зеркала, llms.txt, манифесты обнаружения и эта страница опубликованы.

---

Исследовано и подготовлено с помощью ИИ; проверено и одобрено Тимом Мередитом. См. https://saaskly.com/ai-transparency.md и https://saaskly.com/editorial-policy.md.

Канонический HTML: https://saaskly.com/developers · Индекс Markdown: https://saaskly.com/llms.txt