# tray-api

Плагин для работы с API платформы Tray: скиллы и агенты по каталогу, заказам, доставке и оплате. Нужен, если пишете приложение для этой платформы.

- плагин · `type=plugin` · Claude Code · ★ 15
- Автор: tray-tecnologia
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tray-tecnologia/tray-api-ai-plugin
- Обновлён: 2026-08-12
- HTML: https://affpapa.org/nevibecode/plugins/tray-api

## Что делает

Плагин закрывает интеграцию с API Tray: авторизация OAuth, каталог товаров, заказы, доставка, платежи, вебхуки. Внутри 35 скиллов, 10 агентов и 3 слэш-команды, плюс 2 хука для проверки безопасности. Документация разложена по ресурсам — от `autorizacao` и `produtos` до `cupons` и `listas-preco-b2b`.

Начинать стоит со скилла `visao-geral`: там инвариантные правила API — OAuth, ключ ресурса в payload, лимиты запросов. Агент `/tray-api:configuracao-aplicativo` ведёт через первичную настройку, `/tray-api:gestor-catalogo` берёт массовые операции с товарами, `/tray-api:debug-integracao` разбирает ошибки. Для переезда с другой платформы есть `assistente-migracao` и пять субагентов под Shopify, WooCommerce, Magento 2, VTEX и Nuvemshop.

Перед началом нужны Consumer Key и Consumer Secret — их выдают в кабинете разработчика Tray. Без этих двух значений авторизация не пройдёт, и дальше агенты работать не смогут. Команда `/tray-api:validar-integracao` прогоняет чек-лист перед публикацией приложения, так что сертификацию проходить спокойнее.

## Установка

### Claude Code (родная платформа)

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add anthropics/claude-plugins-community
```
В чате агента (не в терминале):
```text
/plugin install tray-api@claude-community
```

## Когда брать
- подключить приложение к Tray через OAuth
- выгрузить и обновить каталог товаров пачкой
- провести заказ по статусам до отгрузки
- разобрать ошибку ответа API
- перенести данные магазина с Shopify или VTEX

## Примеры запросов агенту
- Покажи правила API Tray из скилла `visao-geral`
- Помоги настроить OAuth для приложения Tray
- Перенеси товары из WooCommerce в Tray

## Похожие
- [typescript-lsp](https://affpapa.org/nevibecode/plugins/typescript-lsp.md) — плагин · ★ 44635
- [ruby-lsp](https://affpapa.org/nevibecode/plugins/ruby-lsp.md) — плагин · ★ 44635
- [php-lsp](https://affpapa.org/nevibecode/plugins/php-lsp.md) — плагин · ★ 44635
- [mcp-server-dev](https://affpapa.org/nevibecode/plugins/mcp-server-dev.md) — плагин · ★ 44635
- [laravel-boost](https://affpapa.org/nevibecode/plugins/laravel-boost.md) — плагин · ★ 44635
- [firebase](https://affpapa.org/nevibecode/plugins/firebase.md) — плагин · ★ 44635

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md