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"
}
/api/v1/products/search/b64/0LDQvdC40LzQtQ/ — это поиск «аниме».
Подробности — в описании эндпоинта в OpenAPI-контракте.Машиночитаемые точки входа
| Артефакт | Что это |
|---|---|
| /.well-known/openapi.json | OpenAPI 3.1 — полный контракт REST API |
| /agent-docs/ | Swagger UI — интерактивная документация API |
| /AGENTS.md | Операционная инструкция для агентов: что можно, что нельзя, как работать с магазином |
| /llms.txt и /llms-full.txt | Контекст о магазине для языковых моделей (краткий и расширенный) |
| /pricing.md | Машиночитаемый прайс: типы носителей и доставка |
| /auth.md | Auth-контракт: публичный read-only доступ, ключи не нужны |
| /.well-known/agent-card.json | A2A agent card — визитка сайта для агентных протоколов |
| /.well-known/agent-skills/index.json | Скиллы агента: поиск, карточка, категории, прайс, sitemap, контекст |
| /.well-known/api-catalog | Каталог API по RFC 9727 |
| /.well-known/mcp/server-card.json | MCP server card: WebMCP-инструменты прямо в браузере |
| /.well-known/security.txt | Куда сообщать об уязвимостях |
Вопросы и ответы
Нужен ли 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.