Запросы к базе 1С для агентов

Установка

./.claude/skills/1c-queries/scripts/query-1c.sh 'ВЫБРАТЬ ПЕРВЫЕ 10 Кассы.Код, Кассы.Наименование ИЗ Справочник.Кассы КАК Кассы'

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Расширение публикует HTTP-сервис, который принимает текст запроса на языке 1С, проверяет его синтаксис и возвращает результат таблицей с разделителями. Скилл 1c-queries дает агенту скрипты для bash и PowerShell, которые читают адрес и учетные данные из .env, и подробные правила составления запросов: без параметров через амперсанд, с ограничением ПЕРВЫЕ N, со сравнением ссылок через реквизиты. Так агент разбирает, почему не проводится документ, опираясь на реальные данные, или делает произвольный анализ базы. Автор советует подключать вместе с MCP по метаданным, чтобы агент сначала читал структуру.

Для кого. Для разработчиков и аналитиков 1С, которые разбирают ошибки и данные в базе вместе с агентом.

Пример запроса к агенту

Почему не проводится чек ККМ ССНФ-000002 от 2 января? Посмотри данные в базе

Ограничения

Агент читает любые данные, доступные пользователю 1С, включая персональные: за конфиденциальность отвечает владелец базы, автор советует обезличивать данные. Нужно установить расширение и опубликовать HTTP-сервис на веб-сервере или через автономный сервер ibsrv. Логин и пароль базы хранятся в .env в папке скилла.

Как отключить. Удалите папку .claude/skills/1c-queries из проекта и отключите расширение АПРО_ВнешниеЗапросы или публикацию HTTP-сервиса.

Проверка безопасности

• Агент читает данные рабочей базы, включая персональные
• Учетные данные базы хранятся в файле .env

Коротко о README

README объясняет, что расширение занимает около двадцати строк кода и выросло из задачи разбирать ошибки проведения на реальных данных. Быстрый старт: подключить расширение, опубликовать HTTP-сервис для клиент-серверной или файловой базы, проверить его через curl и заполнить .env скилла. Автор подчеркивает роль подробного SKILL.md и проверки синтаксиса запроса как обратной связи для агента, приводит примеры отчетов и альтернативные решения. Лицензия MIT.

SKILL.md

---
name: 1c-queries
description: Выполняет запросы к базе данных 1С:Предприятие через HTTP-сервис. Используй этот навык когда нужно получить данные из 1С, выполнить анализ данных в базе 1С, написать или проверить запрос на языке 1С.
---

# Выполнение запросов к базе 1С:Предприятие

## Обзор

Этот навык позволяет выполнять запросы к базе данных 1С:Предприятие через HTTP-сервис. Используй его для анализа данных и получения информации из 1С.

## Скрипты для выполнения запросов

Скрипты читают `.env` автоматически и отправляют запрос в 1С.

**Windows (PowerShell):**

```powershell
.\.claude\skills\1c-queries\scripts\query-1c.ps1 -Query 'ВЫБРАТЬ Кассы.Код, Кассы.Наименование ИЗ Справочник.Кассы КАК Кассы ГДЕ Кассы.Наименование = "Основная касса"'
```

**Linux (bash):**

```bash
./.claude/skills/1c-queries/scripts/query-1c.sh 'ВЫБРАТЬ Кассы.Код, Кассы.Наименование ИЗ Справочник.Кассы КАК Кассы ГДЕ Кассы.Наименование = "Основная касса"'
```

## Формат ответа

- Ответ в формате TSV (Tab-Separated Values)
- Первая строка — заголовки колонок
- Следующие строки — данные
- При ошибке: HTTP 400 с описанием ошибки

Похожие