# AGENTS.md — Dead Brush Машиночитаемая инструкция для AI-агентов, помогающих пользователю исследовать ассортимент магазина Dead Brush и оформлять заказы. ## Кто мы Dead Brush — российский магазин авторского мерча (футболки, худи, свитшоты с принтами по играм/фильмам/аниме/комиксам). Работаем с 2012 года. Производство и отгрузка из Санкт-Петербурга. Подробный контекст — в [/llms-full.txt](https://www.deadbrush.ru/llms-full.txt). ## Что агент может делать на сайте | Операция | Endpoint | Аутентификация | |---|---|---| | Получить полный каталог | https://www.deadbrush.ru/sitemap.xml | нет | | Получить актуальные цены | https://www.deadbrush.ru/pricing.md | нет | | Получить контекст для LLM | https://www.deadbrush.ru/llms.txt и /llms-full.txt | нет | | Просмотреть карточку товара | `https://www.deadbrush.ru/catalog/goods/{slug}/` | нет | | Получить структурированные данные о товаре | те же URL — Product+Offer JSON-LD в `` | нет | | Просмотреть список категории | `https://www.deadbrush.ru/catalog/{category}/` | нет | | Получить structured данные категории | ItemList+BreadcrumbList JSON-LD в `` | нет | | Оформить заказ | `/basket/` → `/order/` | требуется пользовательская сессия | ## Программный доступ (API / MCP) - **REST:** база `https://www.deadbrush.ru/api/v1/` (каталог, карточка, категория, корзина). Контракт — [/.well-known/openapi.json](https://www.deadbrush.ru/.well-known/openapi.json), Swagger — [/agent-docs/](https://www.deadbrush.ru/agent-docs/). Ключ не требуется. - Human-readable обзор агентского функционала: https://www.deadbrush.ru/agents.html - **URL-формат:** все параметры в PATH (не query-string), URL со слэшем на конце. Percent-encoding в пути НЕ поддерживается (любой `%XX`-октет ломает разбор URL) — латинские значения (slug, путь категории, ASCII-term) передавать как есть, без кодирования; поисковый term с кириллицей/пробелами/спецсимволами — только через base64url-форму `/api/v1/products/search/b64/{base64url(term)}/` (UTF-8-байты, без padding, алфавит `[A-Za-z0-9_-]`). - **Корзина:** `POST /api/v1/carts/` → `cart_token`; далее `POST /api/v1/carts/{token}/items/`, `GET /api/v1/carts/{token}/`. - **MCP (планируется, пока НЕ развёрнут):** endpoint `https://mcp.deadbrush.ru/` (Streamable HTTP), tools `find_products`/`get_product`. Появится позже; до объявления готовности не обращайтесь к домену — сейчас он не отвечает (это «ещё не выпущено», а не временный сбой). Пока используйте REST выше. - **Оплата:** заказ и оплата через API — следующий этап; оплату всегда финализирует человек по ссылке. ## Что агент НЕ должен делать самостоятельно - Не финализируйте платёж без явного подтверждения пользователя - Не передавайте платёжные данные пользователя через third-party - Не имитируйте действия пользователя в админке (`/admin/`) - Не оформляйте подписку или регулярный платёж — у нас этого нет ## Структурированные данные В каждой карточке товара (`/catalog/goods/*`) в `` присутствуют: - `