Скиллы и бот для данных 1С через OData
1c oData bot
Скиллы OData и поиска по метаданным для AI-агентов плюс Telegram- и email-бот, который отвечает на вопросы о данных 1С обычным языком
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Передает данные из базы 1С через Telegram и email, доступ к боту стоит ограничивать
- Внешняя обработка публикует OData-интерфейс базы, что расширяет поверхность API
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/1c-odata-botОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .claude/skills
cp -R "$tmp/skills/odata" .claude/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .agents/skills
cp -R "$tmp/skills/odata" .agents/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .github/skills
cp -R "$tmp/skills/odata" .github/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .agents/skills
cp -R "$tmp/skills/odata" .agents/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .agents/skills
cp -R "$tmp/skills/odata" .agents/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .devin/skills
cp -R "$tmp/skills/odata" .devin/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .cline/skills
cp -R "$tmp/skills/odata" .cline/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .roo/skills
cp -R "$tmp/skills/odata" .roo/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add gybson63/1c-odata-skill --skill odata -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 85e8722
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .agents/skills
cp -R "$tmp/skills/odata" .agents/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .agents/skills
cp -R "$tmp/skills/odata" .agents/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/gybson63/1c-odata-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/odata/
git -C "$tmp" checkout 85e8722124c189ebf0df006ef1d0db5bdca77c34
mkdir -p .agents/skills
cp -R "$tmp/skills/odata" .agents/skills/odataКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Установи зависимости командой pip install -r requirements.txt, скопируй env.example.json в env.json и заполни токены бота и параметры OData, запусти python -m bot, а для Cursor подключи MCP conf-doc по инструкции из docs/mcp-setup.md.
Другие способы из описания автора
pip install -r requirements.txtУстановка зависимостей бота.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает два способа получить данные 1С через стандартный протокол OData. Для AI-агентов есть отдельные скиллы: odata формирует и выполняет OData-запросы, 1cconfinfo разбирает структуру конфигурации, conf-doc делает семантический поиск объектов и реквизитов до самого запроса, а conf-doc также доступен как MCP-сервер для Cursor. Параллельно работает мультиагентный бот в Telegram и по email: вопрос на русском проходит через аналитика метаданных, агента OData, который строит запрос и считает записи через $count и $expand, и форматтер, который оформляет ответ таблицей или графиком. Отдельная внешняя обработка EnableODataInterface публикует нужные справочники, документы и регистры в OData прямо из режима Предприятия, без Конфигуратора.
Для кого. Для 1С-разработчиков и аналитиков, которым нужно дать коллегам доступ к данным 1С на естественном языке, и для тех, кто хочет OData-скиллы для собственного AI-агента.
Подходит, если
- Нужно дать сотрудникам без доступа к 1С возможность спрашивать данные через Telegram или email обычным языком
- Нужны переиспользуемые скиллы OData и поиска по метаданным для агента в Cursor
- Нужно быстро опубликовать объекты 1С в OData без захода в Конфигуратор
Не подходит, если
- OData-интерфейс 1С не опубликован и публиковать его небезопасно для вашего контура
- Нужна запись данных в 1С: и скиллы, и бот описаны как чтение данных через OData, а не их изменение
- Нет возможности подключить внешний AI-провайдер для мультиагентного пайплайна
Пример запроса к агенту
Сколько заказов клиентов оформлено на этой неделе и на какую сумму, покажи таблицейОграничения
Бот и агент-аналитик используют собственный мультиагентный AI-пайплайн, токены и стоимость которого считаются по сессии, конкретный провайдер моделей задается в конфигурации и в README явно не назван. Домен-профили вроде ЗУП КОРП сделаны под конкретные конфигурации, для других понадобится свой профиль. Внешняя обработка EnableODataInterface публикует OData из режима Предприятия, что расширяет поверхность API базы, и решение о том, какие объекты публиковать, остается за администратором. Email-интерфейс работает по списку разрешенных отправителей, заданному в конфиге.
Как отключить. Остановите процесс python -m bot и отключите OData-интерфейс базы через ту же обработку EnableODataInterface или в Конфигураторе.
Проверка безопасности
- Передает данные из базы 1С через Telegram и email, доступ к боту стоит ограничивать
- Внешняя обработка публикует OData-интерфейс базы, что расширяет поверхность API
Коротко о README
README перечисляет возможности: email-интерфейс с ответом HTML и вложениями, Telegram-бот с мультиагентным пайплайном аналитик-OData-форматтер, семантический поиск conf-doc, отдельный режим аналитика метаданных с domain-профилями, опциональный веб-поиск через self-hosted SearXNG как fallback, набор скиллов для AI-агентов и внешнюю обработку публикации OData. Дает быстрый старт и таблицу ссылок на подробную документацию по каждой аудитории: пользователь бота, установка, MCP в Cursor, SearXNG, разработчик. Указан процесс разработки через feature-ветки и pre-commit.
Частые вопросы
Бот может менять данные в 1С?
README описывает только запросы данных через OData и подсчет записей, операций записи не документировано.
Зачем нужен conf-doc перед самим OData-запросом?
Семантический поиск по метаданным находит нужные объекты и реквизиты заранее, что снижает число ошибочных OData-запросов на первом шаге.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything