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

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

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

Болело

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

Стало

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

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

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

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

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

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

Как устроено

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

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

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

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

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

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

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

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

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

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

Доверие
Витрины: продажи, остатки, присутствие, прибыль и убытки, сверка

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

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

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

Ставки меняются по данным, реклама в плане до 10 % выручки

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

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

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

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

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

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

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

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

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

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

mcp.hubmarket.ru

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

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

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

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

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

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

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

PythonuvOpenAPIhttpxtrafilaturaMarkdownGit

GitHub