Выгрузка данных MARFOR в файл для своего дашборда

Выгрузка — это профиль на вашем компьютере: какой датасет, какие метрики и разрезы, за какой период. По профилю клиент забирает данные из MARFOR и пишет файл, а ваш дашборд — в Excel, Looker Studio, своём HTML — читает этот файл.

Что нужно заранее

• Локальный клиент, подключённый к Claude. В коннекторе по адресу выгрузок нет: файлу нужен ваш компьютер.
• Датасет в MARFOR: источник, прогноз, сценарий или План/Факт.

Шаги

1. Опишите выгрузку: «Сделай выгрузку выручки и расходов по каналам помесячно с начала года в CSV для моего дашборда, назови sales-ytd».
2. Claude сверит имена метрик и разрезов с датасетом. Неизвестное имя он не возьмёт — предложит похожие.
3. Пробный запуск. Claude сохранит профиль и сразу запишет файл. В ответе — путь, по умолчанию ~/.marfor_mcp/out/sales-ytd.csv, и первые строки.
4. Расписание. Попросите: «обновляй каждый день». Claude напечатает готовую настройку планировщика вашей системы: для macOS, Linux или Windows. Сам он ничего не ставит — установка отдельным шагом, с вашего согласия.
5. Подключите файл к своему дашборду. Формат js — для HTML-страницы, которая открывается с диска.

Период — относительный

Профиль хранит не даты, а правило: весь период, годы, с начала года, последние N месяцев, этот и следующий год, отдельные месяцы. При каждом запуске период пересчитывается на сегодня: выгрузка «с начала года» в марте даст январь–март, в октябре — январь–октябрь.

Как понять, что получилось

• Файл появился по пути из ответа, в нём строки с годом, кварталом, месяцем, разрезами и метриками.
• Команда python3 ~/.marfor_mcp/server.py --list-exports показывает выгрузки этого компьютера и итог последнего запуска.
• Запустить выгрузку руками, как это делает планировщик: python3 ~/.marfor_mcp/server.py --export sales-ytd.

Если дашборд ходит в MARFOR сам

Попросите у Claude «рецепт» выгрузки — marfor_export_recipe. Он напечатает запрос к MARFOR на curl, Python и JavaScript с тем же составом данных. Вместо токена в рецепте стоит переменная $MARFOR_TOKEN: токен вы кладёте в окружение своего сервиса сами, в чат его не вставляйте.

Важно знать

• Отношения — от сумм. ДРР, средний чек и другие вычисляемые поля выгрузка считает из сумм числителя и знаменателя. Если в своём дашборде вы складываете строки — пересчитайте отношение заново, а не складывайте проценты.
• До 200 000 строк в одном файле. Больше — сузьте период или разрезы.
• Данные не уходят дальше вашего компьютера: клиент читает MARFOR и пишет локальный файл.