BitrEx
PowerShell CLI для безопасной выгрузки компаний и контактов Bitrix24 в CSV через входящий вебхук
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Читает и выгружает персональные данные контактов и компаний CRM на локальный диск
- Права выгрузки равны правам входящего вебхука, указанного при запуске
Установка
Ручная установка
.\run.ps1 export -Webhook "https://your-domain.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx" -UserId 734Выгружает компании пользователя и контакты по ним, требует клонированный репозиторий и Windows PowerShell.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скрипт на PowerShell читает CRM Битрикс24 через входящий вебхук с правом CRM и выгружает компании и связанные контакты в companies.csv и contacts.csv, вместе со сводкой export-summary.json, метриками качества данных data-quality.csv и логом export.log. По умолчанию выгружаются только компании текущего пользователя (по CREATED_BY_ID или ASSIGNED_BY_ID), команды contacts-all и export-all снимают это ограничение в пределах прав вебхука. Есть режим dry-run без сохранения файлов, три скорости запросов (safe, ultra, fast) с паузами между вызовами, чтобы не упереться в лимиты API, и запуск двойным кликом через start-bitrex.cmd с интерактивным выбором команды.
Для кого. Для менеджеров и аналитиков, которым нужна разовая или регулярная выгрузка компаний и контактов CRM Битрикс24 в CSV.
Подходит, если
- Нужно выгрузить компании и контакты Битрикс24 в CSV для отчета или сверки
- Нужен безопасный dry-run, чтобы проверить доступ вебхука перед реальной выгрузкой
- Нужны метрики качества данных по выгруженным записям
Не подходит, если
- Нет доступа к Windows PowerShell: инструмент рассчитан только на Windows
- Нужны сделки, задачи или другие сущности CRM, кроме компаний и контактов
- Нужна запись данных обратно в Битрикс24, а не только чтение
Пример запроса к агенту
Выгрузи мои компании и контакты по ним из Битрикс24 в CSV в безопасном режимеОграничения
Работает только на Windows через PowerShell, кроссплатформенной версии нет. Выгружает только компании и контакты, без сделок и других сущностей CRM. Требует входящий вебхук с правом CRM, секрет которого нельзя коммитить в репозиторий или config.json.
Как отключить. Удалите папку проекта и отзовите вебхук CRM в настройках портала Битрикс24.
Проверка безопасности
- Читает и выгружает персональные данные контактов и компаний CRM на локальный диск
- Права выгрузки равны правам входящего вебхука, указанного при запуске
Коротко о README
README описывает назначение (выгрузка компаний и контактов через REST API в CSV и сопутствующие файлы), требования (Windows PowerShell, входящий вебхук с правом CRM), команды test, sample, export, contacts-all, export-all, полный список параметров, три режима скорости, формат CSV с разделителем точка с запятой для русской локали Excel, dry-run и таблицу типичных ошибок 401, 403 и нулевого результата. Отдельно расписаны правила безопасности: не коммитить вебхук, config.json и файлы с CRM-данными.
Частые вопросы
Можно проверить доступ перед выгрузкой?
Да, команда test проверяет вебхук, профиль и доступ к компаниям и контактам, а sample выгружает 10 записей для проверки формата.
Как избежать блокировки по лимитам API?
Использовать режим -Mode safe с паузами 6-14 секунд между запросами, для больших выгрузок это рекомендуемый режим.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма