1c-web-session

Скилл Claude Code для работы в веб-клиенте 1С через Playwright MCP: сеансы, навигация, справочники, документы и тестовые данные

СкиллВысокий рискРоссийский стек

roolee10/1c-web-session

Установка

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--timeout", "500"]
    }
  }
}

Playwright MCP нужен скиллу для управления браузером.

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

Что делает

Скилл учит агента управлять опубликованной базой 1С в браузере через Playwright MCP. Он запускает и завершает сеанс, обрабатывает окна входа и лицензионные предупреждения, переходит по разделам и кеширует идентификаторы пунктов меню конкретной базы в .claude/1c-nav.json. Агент создает элементы справочников, заполняет и проводит документы с табличными частями, генерирует тестовые данные и выполняет JS-сценарии для сценарного тестирования. В скилле собраны приемы, без которых обычный Playwright в веб-клиенте 1С не работает: вставка через буфер обмена и селекторы кнопок выбора.

Для кого. Для разработчиков и тестировщиков 1С, которые хотят проверять пользовательские сценарии руками агента в веб-клиенте.

Подходит, если

  • Нужно наполнить тестовую базу справочниками и документами через интерфейс
  • Нужно прогнать пользовательский сценарий после доработки формы
  • Нужно воспроизвести ошибку, которая появляется только в веб-клиенте

Не подходит, если

  • База не опубликована на веб-сервере
  • Речь о рабочей базе с реальными данными: агент проводит документы

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

Запусти базу, создай элемент справочника Номенклатура «Билет семейный» и проведи документ продажи для клиента Петрова

Ограничения

Нужны Claude Code, Playwright MCP и опубликованная веб-база 1С, адрес которой прописывается в CLAUDE.md проекта. Часть приемов, например загрузка сценария через буфер обмена, рассчитана на PowerShell. Работа через интерфейс медленнее и чувствительнее к изменениям форм, чем тесты на уровне кода.

Как отключить. Удалите папку .claude/skills/1c-web-session из проекта и при необходимости сервер playwright из .mcp.json.

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

  • Создает и проводит документы в информационной базе через интерфейс
  • Выполняет произвольный JS-код сценариев в браузере

Коротко о README

README перечисляет, что умеет скилл, и объясняет приемы для веб-клиента 1С: вставка через буфер обмена, селекторы кнопок выбора, навигационный кеш и длинные цепочки действий в одном вызове. Требования: Claude Code, Playwright MCP и опубликованная база, приведен пример .mcp.json. Установка сводится к копированию папки .claude в проект, есть видео с демонстрацией сценарного тестирования. Лицензия MIT.

SKILL.md

---
name: 1c-web-session
description: >
  Взаимодействие с 1С:Предприятие в веб-клиенте через Playwright.
  Использовать для ЛЮБОЙ работы в браузере с 1С-базой: запуск/перезапуск/
  завершение сеанса; навигация по разделам интерфейса; создание и
  редактирование справочников и документов; заполнение форм и табличных
  частей; генерация тестовых данных через UI. Содержит паттерны: clipboard
  paste, DLB-кнопки, пикеры, навигационный кеш, обработка диалогов 1С,
  оптимизация browser_run_code. Триггеры: открой/запусти/перезапусти/
  заверши базу; создай/добавь/измени элемент справочника или документа;
  проведи документ; сгенерируй тестовые данные; любое browser_* действие
  в 1С-базе.
---

# Управление сеансом 1С в веб-клиенте

## Запуск базы

Прочитать `CLAUDE.md` проекта (Read tool) и найти URL базы. Формат обычно: `http://localhost/<имя-базы>/ru_RU/`

Использовать `browser_navigate` для перехода по URL. Если сеанс уже запущен — сначала завершить (см. ниже).

## Запуск JS-сценариев по пути

Команда пользователя вида `запусти сценарий <путь-к-файлу>.js` означает: выполнить код этого файла в текущем сеансе 1С через `browser_run_code`.

Формат сценария: JS-выражение функции `async (page) => { ... }` (пример: `.claude/scenarios/*.js`).

Не искать отдельный npm/ps1-раннер как первый шаг. Не запускать файл как обычный Node.js-скрипт.

Алгоритм:
1. Проверить существование файла сценария по указанному пути.
2. Запустить или восстановить сеанс 1С (URL из `CLAUDE.md`, обработать лицензию и форму входа по правилам этого скилла).
3. Выполнить сценарий способом A (по умолчанию). При недоступном clipboard переключиться на способ B.

### Способ A (рекомендуемый по скорости): clipboard loader

Использовать по умолчанию. Это самый быстрый способ для длинных сценариев: в `browser_run_code` передаётся короткий загрузчик, а не весь файл.

1. Скопировать файл сценария в буфер обмена:
```powershell
Get-Content -LiteralPath <путь-к-сценарию> -Raw | Set-Clipboard
```

Частые вопросы

Почему нельзя просто использовать Playwright без скилла?

Поля веб-клиента 1С плохо принимают стандартный ввод Playwright, а идентификаторы меню разные в каждой базе. Скилл описывает обходные приемы и кеш навигации.

Как запустить свой сценарий?

Написать JS-функцию async (page) и попросить агента запустить сценарий по пути к файлу, он выполнит ее в текущем сеансе.

Playwright CLI

playwright-cli

Выбор редакции

Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем

CLIСредний риск13,3 тыс.
Выбор редакции

Официальный отладчик MCP-серверов: веб-интерфейс, CLI для автоматизации и терминальный интерфейс в одном пакете

CLIСредний риск10,9 тыс.
Выбор редакции

Официальный MCP-сервер SonarSource: проблемы качества и безопасности, quality gates и анализ кода из SonarQube Server и Cloud

MCP-серверСредний риск648

Открытый ИИ-агент для ревью pull request: описание, замечания и предложения по улучшению в GitHub, GitLab и других

CLIСредний риск13 тыс.