Анонсы новинок, новости, скидки и розыгрыши в нашем Телеграме

Dead Brush для ИИ-агентов

Эта страница для двоих: для покупателя, который ходит по магазинам вместе с ИИ-ассистентом, и для разработчика, который таких ассистентов делает. С июля 2026 года у Dead Brush есть публичный API: агент может искать товары, открывать карточки и собирать корзину — без ключей и регистрации.

Что умеет агент на Dead Brush

  • Листать каталог и категории: список товаров с ценами, наличием и картинками.
  • Искать по названию — на латинице и на кириллице.
  • Открывать карточку товара: цена, размеры, наличие, изображения.
  • Собирать корзину без регистрации: корзина живёт по токену, агент передаёт её человеку.

Оформляет и оплачивает заказ по-прежнему человек на сайте — агенту мы продажу не доверяем, он только помогает выбрать.

Если вы покупатель

Ничего настраивать не нужно. Если у вашего ассистента есть доступ в интернет (ChatGPT, Claude, агентные браузеры), просто попросите его, например, так:

Найди на deadbrush.ru худи с драконом, покажи варианты с ценами
и размерами. Инструкция для агентов: www.deadbrush.ru/AGENTS.md

Ассистент прочитает инструкцию, сходит в каталог и вернётся с вариантами. Ссылку на собранную корзину он отдаст вам — дальше обычное оформление на сайте.

Если вы разработчик

REST API без аутентификации: чтение каталога и headless-корзина. Лимиты: 60 запросов в минуту на чтение, 30 в минуту на операции с корзиной. Все параметры передаются в PATH, канонические URL — со слешем на конце.

Поиск:

$ curl https://www.deadbrush.ru/api/v1/products/search/SW/

{
  "items": [
    {
      "slug": "unstoppable-sword",
      "title": "Unstoppable Sword",
      "price": 3390,
      "currency": "RUB",
      "in_stock": true,
      "cover_url": "https://www.deadbrush.ru/etc/img/goods/a536c4260cf2ee9ee56efce8bc0a1dbb_unst_sword_400x450.png",
      "category": "anime"
    },
    {
      "slug": "dune-the-battle-for-arrakis-swr",
      "title": "Dune: The Battle for Arrakis SWR",
      "price": 4290,
      "currency": "RUB",
      "in_stock": true,
      "cover_url": "https://www.deadbrush.ru/etc/img/goods/8ada58387fa73ab1428400033acb08d8_dune_reg_sw_400x450.png",
      "category": "games"
    },
    "... ещё 15 товаров"
  ],
  "page": 0,
  "total": 17
}

Карточка товара:

$ curl https://www.deadbrush.ru/api/v1/products/unstoppable-sword/

{
  "slug": "unstoppable-sword",
  "title": "Unstoppable Sword",
  "price": 3390,
  "currency": "RUB",
  "in_stock": true,
  "cover_url": "https://www.deadbrush.ru/etc/img/goods/a536c4260cf2ee9ee56efce8bc0a1dbb_unst_sword_400x450.png",
  "category": "anime",
  "description": "Данная футболка станет отличным приобретением для фанатов манги Berserk...",
  "sizes": ["XS", "S", "M", "L", "XL", "XXL"],
  "images": [
    "https://www.deadbrush.ru/etc/img/goods/a536c4260cf2ee9ee56efce8bc0a1dbb_unst_sword_400x450.png",
    "https://www.deadbrush.ru/etc/img/goods/addit_photo/a2f9f53f38a31d4d6c912e39af5a3cfe_full.png"
  ],
  "url": "https://www.deadbrush.ru/catalog/goods/unstoppable-sword/"
}

Корзина:

$ curl -X POST https://www.deadbrush.ru/api/v1/carts/

{
  "cart_token": "c403fb12...6eec5700"
}
Кириллица в поиске передаётся не percent-encoding'ом (роутер его не разбирает), а base64url без padding: /api/v1/products/search/b64/0LDQvdC40LzQtQ/ — это поиск «аниме». Подробности — в описании эндпоинта в OpenAPI-контракте.

Машиночитаемые точки входа

АртефактЧто это
/.well-known/openapi.jsonOpenAPI 3.1 — полный контракт REST API
/agent-docs/Swagger UI — интерактивная документация API
/AGENTS.mdОперационная инструкция для агентов: что можно, что нельзя, как работать с магазином
/llms.txt и /llms-full.txtКонтекст о магазине для языковых моделей (краткий и расширенный)
/pricing.mdМашиночитаемый прайс: типы носителей и доставка
/auth.mdAuth-контракт: публичный read-only доступ, ключи не нужны
/.well-known/agent-card.jsonA2A agent card — визитка сайта для агентных протоколов
/.well-known/agent-skills/index.jsonСкиллы агента: поиск, карточка, категории, прайс, sitemap, контекст
/.well-known/api-catalogКаталог API по RFC 9727
/.well-known/mcp/server-card.jsonMCP server card: WebMCP-инструменты прямо в браузере
/.well-known/security.txtКуда сообщать об уязвимостях
Скоро: MCP-сервер. Готовим отдельный MCP-эндпоинт (mcp.deadbrush.ru), чтобы подключать магазин к Claude, Cursor и другим MCP-клиентам одной строкой конфига. Когда запустим — здесь появится адрес и инструкция.

Вопросы и ответы

Нужен ли API-ключ?
Нет. Чтение каталога и корзина работают без аутентификации. Действуют лимиты: 60 запросов в минуту на чтение, 30 — на запись корзины.

Может ли агент оформить и оплатить заказ?
Нет. Агент собирает корзину и передаёт её человеку, заказ и оплата — на сайте руками покупателя.

Почему кириллический поиск через base64?
Историческая особенность роутера: percent-encoding в пути не разбирается. Для не-ASCII запросов есть форма /api/v1/products/search/b64/{строка в base64url без padding}/.

Есть ли MCP-сервер?
Пока нет — есть WebMCP-инструменты в браузере и server card в /.well-known/mcp/. Отдельный MCP-эндпоинт в работе.

Куда написать о проблеме или уязвимости?
Контакты — в /.well-known/security.txt, почта — main@deadbrush.ru.