Скилл для Claude: нейросеть сама находит нужный метод API Ozon

Скилл - это готовый навык для ИИ-помощника: скачали папку, положили в нужное место - и ваш Claude умеет то, чего вчера не умел. Сегодня выкладываем первый скилл нашего клуба: он учит нейросеть находить настоящие методы API Ozon вместо выдуманных. Внутри - официальные спецификации на 458 методов Seller API и 48 методов Performance API, поиск по-русски и проверка каждого метода по документации.

Ведём тему AI-помощников для селлеров в Telegram-канале «Вайб Селлер Клуб» - разборы, кейсы и готовые сборки.

Что такое скилл и зачем он нейросети

У Claude и других ИИ-помощников есть простой механизм: перед задачей они заглядывают в библиотеку навыков - папки с инструкциями. В каждой папке лежит файл с правилами («как правильно делать X») и справочные материалы. Если тема задачи совпала с темой навыка, помощник читает инструкцию и работает по ней, а не по общим знаниям из интернета.

Это и есть вайб-кодинг в чистом виде: вы не пишете программу, вы объясняете помощнику правила работы - один раз, по-русски.

Наш первый скилл называется ozon-api-navigator. Его тема - API Озона: та самая «розетка», через которую Торговод и любые ваши скрипты забирают из кабинета продажи, остатки и рекламу.

Проблема: нейросеть выдумывает методы API Ozon

У Озона два разных API: Seller API - товары, цены, остатки, заказы, отчёты - и Performance API - реклама, кампании, ставки. Вместе это больше пятисот методов, их версии постоянно растут: старый метод объявляют устаревшим, взамен выпускают новый. Нейросеть училась на статьях двух-трёхлетней давности, поэтому уверенно предлагает то, чего уже - или вообще никогда - не существовало.

Мы проверили на живом тесте. Попросили Claude без скилла написать код, который меняет недельный бюджет рекламной кампании. Ответ выглядел профессионально: авторизация правильная, формат денег правильный, а сам адрес метода - выдуманный, в официальной документации его нет. Такой код упадёт с ошибкой при первом же запуске, и селлер без опыта будет часами искать проблему не там.

Со скиллом та же задача решилась верно: помощник нашёл настоящий метод изменения кампании в официальной спецификации и взял из неё точные названия полей. На девяти проверках теста скилл набрал девять из девяти, без скилла - семь из девяти, причём обе ошибки - именно выдуманные методы.

Что внутри скилла

Внутри - четыре части:

• Инструкция для помощника - когда включаться, как искать, какие ловушки у API Озона (например: рекламные ключи не подходят к товарным методам, и почти все методы Seller API работают через POST).
• Официальные спецификации - полные копии swagger.json с docs.ozon.ru: 458 методов Seller API и 48 методов Performance API, с описаниями на русском.
• Индексы методов - все методы одной строкой, сгруппированы по разделам: товары, склады, заказы, реклама. Помощник пробегает список глазами, как оглавление.
• Скрипт поиска - lookup.py: ищет метод по словам («остатки склад» найдёт восемь подходящих методов), показывает полную схему выбранного метода и умеет обновлять спецификации, когда Озон их меняет.

Важная деталь: сайт документации Озона закрыт защитой от роботов, поэтому помощник не может просто «сходить и почитать» - попытки кончаются бесконечными перенаправлениями. Навык решает это локальными копиями спецификаций, а для обновления использует настоящий браузер.

Как установить за пять минут

Самый быстрый путь - блок «Поставить скилл - два способа» сразу под заголовком статьи:

• Способ 1, руками. Нажмите «Скачать скилл» и распакуйте архив в папку навыков Claude Code: C:\Users\<вы>\.claude\skills\ozon-api-navigator\ (на Mac - ~/.claude/skills/ozon-api-navigator/). Внутри папки должен лежать файл SKILL.md.
• Способ 2, промптом. Нажмите «Скопировать промпт», вставьте его в Claude Code и отправьте - помощник сам скачает архив ozon-api-navigator.zip, разложит по папкам и отчитается, что умеет новый навык.

Перезапускать ничего не нужно: навыки подхватываются лениво - помощник сам вспомнит про навык, когда вы заговорите про API Озона.

Если вы ещё не работали с Claude Code - начните с разбора Claude Code для селлера: там пошагово, что это за инструмент и как его поставить. Ещё из бесплатных инструментов клуба - офлайн-озвучка текста Вслух: она тоже собрана без программистов.

Как проверить, что навык работает

Спросите у Claude что-нибудь конкретное: «каким методом получить остатки моих товаров на складах Ozon?» Правильное поведение со скиллом выглядит так: помощник запускает поиск по спецификации, находит несколько кандидатов, отбрасывает устаревшие и называет точный метод со ссылкой на официальное описание. Если помощник отвечает мгновенно и без ссылок на спецификацию - навык не подхватился, проверьте путь к папке.

Дальше навык работает незаметно: любой скрипт для Озона, который вы попросите написать, будет опираться на настоящие методы. А когда Озон обновит документацию, скажите помощнику «обнови спецификации Ozon» - помощник скачает свежие файлы и перестроит индексы.