Свой продукт · В проде

Магазины маркетплейсов в Claude

Свой продукт: сервис подключает магазины продавца на маркетплейсах к Claude как коннектор. 48 инструментов на три площадки, каталог API поверх спецификаций, ключи площадок зашифрованы в базе, а пишущий вызов идёт в два шага: сначала предпросмотр, потом отправка.

Болело

Чтобы понять, что происходит в магазине, продавец обходит кабинеты трёх площадок и сводит отчёты в таблице. Дашборд отвечает только на заранее заложенные вопросы.

Стало

Продавец спрашивает обычными словами - «что заканчивается на складах», «окупается ли реклама», «сколько придёт на счёт», - и Claude идёт в API площадки его ключом.

Эффект по шагам

03 · Решения - точнее: Вопрос о магазине закрывается ответом словами, а не сведением отчётов
04 · Из рутины - в автоматизацию: Ежедневная проверка трёх кабинетов сворачивается в один вопрос в чат

Что это даёт бизнесу

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

От источника к результату

Вопрос словами
Коннектор площадки
Инструменты и каталог API
API площадки ключом продавца
Ответ строками, а не файлом

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

Как устроено

Каталог API собирается из снимков спецификаций площадок, поэтому Claude доступен почти любой метод: найти по словам, посмотреть параметры, вызвать.

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

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

Кто ведёт систему сейчас

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

Другие кейсы этого шага

Внутренняя система · В проде

Платформа данных

Цифра сверена с первоисточником до единицы товара

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

Доверие
Витрины: продажи, остатки, присутствие, P&L, сверка

Та же система даёт эффект ещё по 2 шагам

Внутренняя система · В проде

Агенты управления рекламой

Ставки меняются по данным: ДРР в плане ≤ 10 %

Болело: Ставки крутили по вчерашнему отчёту и по ощущению. Но «вчера» показывает не то, что было: обвал рынка легко принять за свою ошибку и разогнать спираль правками.
Стало: Решение собирается по порядку: режим рынка, здоровье товара, справедливый целевой ДРР для этой позиции и только потом сама ставка. Показатели - по зрелому окну, план по ДРР не выше 10 %.

ДРР
Порядок решения: режим рынка → здоровье товара → целевой ДРР → ставка
Окно показателей

Та же система даёт эффект ещё на одном шаге

Открытый код · В проде

База знаний маркетплейсов для агентов

Агент отвечает по правилам площадок, а не по памяти

Болело: Когда ИИ-агент проектирует логику под правила площадки, он опирается на память. Тарифы и лимиты меняются, память - нет, и ошибка всплывает не на ревью, а в деньгах.
Стало: База знаний трёх площадок лежит рядом с проектом обычными markdown-файлами: по файлу на метод API и статьи справки. Агент читает первоисточник со ссылкой и датой, а не пересказ.

База
Сборка
Обновление: одна команда, git-diff как отчёт об изменениях

GitHub

Внутренняя система · Пилот

Витрины поверх озера данных

Маржа по товару - и отдельно то, что на товар не ложится

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

Фильтр видов операции
Ответ дашборда
Потолок периода

15 % непустых таблиц источника отдают данные старше недели, и по каталогу их не отличить от рабочих

Тип: Свой продукт
Статус: В проде
Охват: 3 площадки, 48 инструментов
Ключи: зашифрованы в базе
Заменило: обход кабинетов и сведение отчётов

TypeScriptMCPHonoNext.jsPrismaPostgreSQLVitestGitHub Actionsnginx

mcp.hubmarket.ru