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

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

Открытая база знаний трёх маркетплейсов для ИИ-агентов: дерево markdown-файлов в git, по файлу на метод API и статьи справки продавца. Не сервис: агент читает файлы напрямую, когда проектирует бизнес-логику приложения.

Болело

Когда ИИ-агент проектирует логику под правила площадки, он опирается на память. Тарифы и лимиты меняются, память - нет, и ошибка всплывает не на ревью, а в деньгах.

Стало

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

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

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

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

Спецификации и справка площадок
Детерминированная сборка
Markdown со ссылкой на первоисточник
Оглавления для агента
git-diff как отчёт

Файл перезаписывается только когда изменилось его содержимое, поэтому diff после обновления - список настоящих изменений в правилах площадки, а не шум от дат.

Как устроено

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

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

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

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

Я. Открытый код, обновляется одной командой с рабочей машины.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ответ о магазине - словами, без дашборда

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

Охват
Ключи площадок
Табличный отчёт: скачивается сам и читается строками

на замере в августе 2026 через каталог API доступны 945 операций из 962

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

mcp.hubmarket.ru

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

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

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

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

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

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

Тип: Открытый код
Статус: В проде
Объём: 1 628 файлов по трём площадкам
Ведёт: инженер
Заменило: догадки агента о правилах площадки

PythonuvOpenAPIhttpxtrafilaturaMarkdownGit

GitHub