Findstack Документация по API

Findstack Каталог доступен для чтения как машинами, так и людьми. Информация о товарах, категориях, ценах, функциях и интеграциях доступна через общедоступный REST API, сервер MCP и в виде Markdown-представлений каждой страницы каталога. Для чтения не требуется аутентификация.

Findstack REST API

Базовый URL https://findstack.com/api/v1Ответы представляют собой JSON. Получение базового URL-адреса возвращает индекс всех конечных точек, ограничений и политик, указанных ниже — начните с этого, если вы программист.

curl https://findstack.com/api/v1/products?q=crm&per_page=5

GET /products — поиск и фильтрация товаров
GET /products/{slug} — Полная информация о продукте, включая тарифные планы.
GET /products/{slug}/integrations — с чем связан продукт
GET /categories — просмотр или поиск по категориям
GET /categories/{slug} — Подробная информация о категории с подкатегориями
GET /categories/{slug}/products — товары в рамках категории

Товары можно фильтровать по следующим критериям: q, category, tech_stack, segment, free_plan, has_api, has_ai и open_sourceи отсортировано по rating, reviews, popularity, newest or name.

Полный текст контракта описан в OpenAPI 3.1 по адресу /openapi.json и каталогизирован в соответствии с RFC 9727 по адресу /.well-known/api-catalog.

Пределы скорости

120 запросов в течение 60 секунд с каждого IP-адреса, распределяемых между всеми конечными точками. Каждый ответ показывает текущее состояние сети, поэтому вы можете регулировать количество запросов, а не определять лимит, достигнув его:

RateLimit: "catalog";r=<remaining>;t=<seconds until reset>
RateLimit-Policy: "catalog";q=120;w=60
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset — те же числа, что и в отдельных полях, отображенные в зеркальном отображении. X-RateLimit-*
Retry-After — секунд ожидания, отправляется только по 429

ошибки

Каждая неудача при /api Это JSON, а не HTML-страница, включая неизвестные пути и неожиданные ошибки сервера. Ветка на code, который является стабильным; message и hint предназначены для бревен и людей.

{
  "error": {
    "code": "not_found",
    "message": "No such resource",
    "hint": "Check the slug. Search endpoints return the slugs the detail endpoints accept.",
    "documentation_url": "https://findstack.com/developers"
  }
}

Используемые коды: not_found, rate_limited, internal_errorСтраницы за пределами /api Отвечайте на ошибку 404 в формате Markdown, если клиент не запрашивает HTML, предоставляя ссылки на карту сайта, файл llms.txt и эту страницу.

Политика версионирования и устаревания

Эта версия находится в пути выполнения, и v1 Актуально. Каждый ответ также включает в себя X-API-VersionДополнительные изменения — новое поле, новая конечная точка, новый фильтр — добавляются в текущую версию без предварительного уведомления, поэтому будьте внимательны и игнорируйте поля, которые вам незнакомы.

Изменения, нарушающие обратную совместимость, поставляются в виде новой версии пути. В этом случае устаревшая версия продолжает отвечать как минимум 180 дней и объявляет о своем прекращении поддержки при каждом ответе:

Deprecation — дата, когда данная версия была признана устаревшей (RFC 9745)
Sunset — дата прекращения ответов (RFC 8594), не ранее чем через 180 дней после Deprecation даты
Link: <https://findstack.com/developers#versioning>; rel="deprecation" — отправляется в каждом ответе, указывая сюда.

Нет Deprecation or Sunset Заголовок означает, что ничего не запланировано. Машинночитаемая форма этой политики выглядит следующим образом: versioning объект в /api/v1.

Findstack МСР-сервер

Агенты ИИ могут подключаться к https://findstack.com/mcp По протоколу контекста модели (потоковая передача HTTP, без аутентификации). Доступные инструменты: search_products, get_product, compare_products, find_alternatives, list_categories и get_category.

Сервер также публикует ресурсы — индекс категорий каталога с идентификаторами (slugs), описание OpenAPI для данного API, llms.txtа также два описанных ниже навыка агента — плюс шаблоны ресурсов, позволяющие обращаться к любой странице товара или категории по URL-адресу. Ознакомьтесь с ними перед использованием инструментов; это сэкономит вам время и силы.

Серверная карта находится по адресу: /.well-known/mcp (также подается в /.well-known/mcp/server-card.json).

Представления Markdown

При запросе любой страницы товара, категории, сравнения, руководства или статьи вместо HTML возвращается Markdown. Accept: text/markdown, или добавив .md к пути. В формате Markdown тот же контент, но без навигации, рекламы и скриптов — его проще цитировать и дешевле читать.

Навыки агента

В двух опубликованных руководствах описаны способы эффективного использования каталога: поиск программного обеспечения и сравнение предложенных вариантов. Они проиндексированы по адресу /.well-known/agent-skills/index.json.

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

Данные каталога могут использоваться для ответа на вопросы и обоснования ответов ИИ с указанием источника. Findstack и ссылка на каноническую страницу. Массовое повторное использование для обучения модели не допускается — наши сигналы контента публикуются в robots.txt.

Редакция не вносит никаких изменений в содержание объявлений, и некоторые из них содержат партнерские ссылки — см. наши партнерские отношения. раскрытие и методология. Вопросы: Здравствуйте@findstack.com.