From 1c-skills
Automates browser interactions with 1C:Enterprise web client using Playwright: navigate sections, open commands, fill forms, read tables/reports, filter lists. Use for testing or automation requests.
npx claudepluginhub nikolay-shirokov/cc-1c-skills --plugin 1c-skillsThis skill uses the workspace's default tool permissions.
---
Automates Coda document and data tasks via Rube MCP (Composio): search/browse docs/pages/tables, manage rows/formulas/permissions/publishing. Requires Rube MCP connection.
Automates browser tasks via PinchTab CLI: navigate sites, inspect/click/fill elements by stable refs/CSS/XPath/text, scrape text, snapshot diffs, export screenshots/PDFs, manage instances.
Provides Frappe Python and JavaScript API reference for document operations, database queries, utilities, and REST API patterns. Use with frappe.get_doc, frappe.db, frappe.call.
Share bugs, ideas, or general feedback.
Automates user interactions with 1C:Enterprise web client via Playwright — navigating sections, filling forms, reading tables and reports, filtering lists.
RUN="${CLAUDE_SKILL_DIR}/scripts/run.mjs"
# One-shot: opens browser → runs script → closes browser → exits
node $RUN run http://localhost:8081/bpdemo test-scenario.js
# Or pipe inline:
cat <<'SCRIPT' | node $RUN run http://localhost:8081/bpdemo -
await navigateSection('Продажи');
await openCommand('Заказы клиентов');
await clickElement('Создать');
await fillFields({ 'Клиент': 'Альфа' });
await clickElement('Провести и закрыть');
SCRIPT
cd "${CLAUDE_SKILL_DIR}/scripts" && npm install
Requires Node.js 18+. npm install downloads Playwright and Chromium.
Read .v8-project.json from project root. Each database has id and optional webUrl.
Construct URL as http://localhost:8081/<id> or use webUrl if set.
Use /web-publish first if the database is not published.
node $RUN run <url> script.js # exits when done, no session
# 1. Start session (run_in_background=true, prints JSON when ready)
node $RUN start <url>
# 2. Execute scripts against running session
cat <<'SCRIPT' | node $RUN exec -
const form = await getFormState();
console.log(JSON.stringify(form, null, 2));
SCRIPT
# 2b. Execute without video recording (for debugging/testing)
cat script.js | node $RUN exec - --no-record
# 3. Screenshot
node $RUN shot result.png
# 4. Stop (logout + close)
node $RUN stop
start runs an HTTP server in background. Use exec/shot/stop from other shells.
All browser.mjs exports are globals — no import needed.
console.log() output is captured in the JSON response.
writeFileSync / readFileSync also available.
navigateSection(name) → { navigated, sections, commands }Go to a top-level section (fuzzy match). Returns list of commands in that section.
await navigateSection('Продажи');
// { navigated: 'Продажи', sections: [...], commands: ['Заказы клиентов', ...] }
openCommand(name) → form stateOpen a command from the function panel (fuzzy). Returns form state of the opened form.
const form = await openCommand('Заказы клиентов');
navigateLink(url) → form stateOpen any 1C object by metadata path (Shift+F11 dialog). Bypasses section/command navigation.
await navigateLink('Документ.ЗаказКлиента');
await navigateLink('РегистрНакопления.ЗаказыКлиентов');
await navigateLink('Справочник.Контрагенты');
openFile(path) → form stateOpen an external data processor or report (EPF/ERF) via File → Open. Handles the security confirmation dialog automatically.
const form = await openFile('C:\\WS\\build\\МояОбработка.epf');
const form = await openFile('build/МояОбработка.epf'); // relative paths work too
switchTab(name) → form stateSwitch to an already-open tab/window (fuzzy match).
getFormState() → { form, formCount, openForms, fields, buttons, tabs, navigation?, table, tables, filters, reportSettings? }Returns current form structure. This is the primary way to understand what's on screen.
form — active form number, or null when no form is open (desktop).
formCount — number of open forms. Use this to know how many windows are stacked. 0 means desktop.
openForms — array of all open form numbers (e.g. [0, 1]). Works even when the open-windows tab bar is hidden in 1C settings.
modal — true when the active form is a modal dialog blocking the UI. Only present when modal is active.
openTabs — array of { name, active? } from the open-windows tab bar. Only present when the tab bar is enabled in 1C settings. Do NOT rely on this — use formCount/openForms instead.
fields — each field has: name, value, label?, actions? (select, clear, open), required? (true for unfilled mandatory fields)
navigation — form navigation panel links (for objects with subordinate catalogs): [{ name, active? }]. Clickable via clickElement(). Only present when the form has a navigation panel (e.g. "Основное", "Объекты метаданных", "Подсистемы").
tables — array of all visible grids: [{ name, columns, rowCount, label? }]. label is the visual group title shown on screen (e.g. "Входящие"), absent when grid has no visible title. Use readTable() for actual data.
table — backward-compatible alias for the first grid: { present, columns, rowCount }.
reportSettings — for DCS reports: human-readable filter settings instead of raw technical names:
const form = await getFormState();
// form.reportSettings = [
// { name: "Склад", enabled: true, value: "Склад бытовой техники", actions: ["select"] },
// { name: "Номенклатура", enabled: false, value: "" }
// ]
errorModal — if present, 1C showed an error dialog. Read the message and decide how to proceed.
confirmation — if present, a Yes/No dialog is shown. Call clickElement('Да') or clickElement('Нет').
errors.stateText — array of SpreadsheetDocument state messages (e.g. "Не установлено значение параметра \"X\"", "Отчет не сформирован...", "Изменились настройки..."). Present when the report area shows an info bar instead of data.
readTable({ maxRows?, offset?, table? }) → { columns, rows, total, shown, offset }Read actual grid data with pagination. Each row is { columnName: value }.
| Option | Default | Description |
|---|---|---|
maxRows | 20 | Max rows to return per call |
offset | 0 | Skip first N rows |
table | — | Grid name from tables[] (for multi-grid forms) |
Special row fields:
_kind: 'group' — hierarchical group row_kind: 'parent' — parent row in hierarchy_tree: 'expanded'|'collapsed' — tree node state_level: N — nesting depth in tree view_selected: true — row is selected (highlighted). Use with clickElement({ modifier: 'ctrl'|'shift' }) to verify multi-selectionhierarchical: true — list has groups (on result object)viewMode: 'tree' — tree view active (on result object)const t = await readTable({ maxRows: 50 });
console.log('Columns:', t.columns);
console.log('Rows:', t.rows.length, 'of', t.total);
// Pagination:
const page2 = await readTable({ maxRows: 50, offset: 50 });
readSpreadsheet() → { title?, headers?, data?, totals?, rows?, total }Read report output (SpreadsheetDocument) after clicking "Сформировать".
Returns structured data when header row is detected:
await clickElement('Сформировать');
await wait(5);
const report = await readSpreadsheet();
// { title: "Остатки товаров", headers: ["Номенклатура", "Склад", "Количество"],
// data: [{ "Номенклатура": "Бумага", "Склад": "Основной", "Количество": "150" }, ...],
// totals: { "Количество": "1250" }, total: 42 }
Falls back to { rows: string[][], total } when headers can't be detected.
getSections() → { activeSection, sections, commands }Read section panel and commands without navigating.
getCommands() → string[]Commands of the current section.
getPageState() → { activeSection, activeTab, sections, tabs }Sections + all open tabs.
clickElement(text, { dblclick?, table?, expand?, modifier? }) → form stateClick button, hyperlink, tab, navigation panel link, or grid row (fuzzy match).
table — scope button search to a specific grid's command panel (by name from tables[]):
await clickElement('Добавить', { table: 'Исходящие' }); // clicks "Добавить" near "Исходящие" grid
await clickElement('0000-000227', { dblclick: true }); // opens document
submenu[] when a menu opens — click again with item name:
const r = await clickElement('Ещё');
// r.submenu = ['Расширенный поиск', 'Настройки', ...]
await clickElement('Расширенный поиск');
{ expand: true } to expand/collapse:
await clickElement('ИСУ ФХД'); // select row
await clickElement('ИСУ ФХД', { expand: true }); // expand/collapse
modifier: 'ctrl' (add to selection) or modifier: 'shift' (select range):
await clickElement('Номенклатура 1'); // select first row
await clickElement('Номенклатура 2', { modifier: 'ctrl' }); // add to selection
await clickElement('Номенклатура 5', { modifier: 'shift' }); // select range 2..5
// Verify selection:
const t = await readTable();
t.rows.filter(r => r._selected); // rows with _selected: true
{ row, column } object to click a cell in a rendered report. Coordinates match readSpreadsheet() output:
const report = await readSpreadsheet();
// report.data[0] = { 'К1': 'Материалы строительные', 'К6': '150 000', ... }
// By data row index + column header name
await clickElement({ row: 0, column: 'К6' }, { dblclick: true });
// By cell value filter (fuzzy match)
await clickElement({ row: { 'К1': 'Материалы' }, column: 'К6' }, { dblclick: true });
// Totals row
await clickElement({ row: 'totals', column: 'К6' }, { dblclick: true });
Text search also works as fallback — searches inside spreadsheet iframes:
await clickElement('150 000', { dblclick: true }); // finds cell by text in report
fillFields({ name: value }) → { filled, form }Fill form fields by label (fuzzy match). Auto-detects field type.
| Value | Field type | Method |
|---|---|---|
'Конфетпром' | Reference | Clipboard paste + typeahead |
'5000' | Plain text | Clipboard paste |
'true' / 'да' | Checkbox | Toggle |
'Оплата поставщику' | Radio | Fuzzy label match |
'' / null | Any (except checkbox/radio) | Clear via Shift+F4 |
DCS report filters: use human-readable label names. Checkbox is auto-enabled:
await fillFields({
'Склад': 'Склад бытовой техники', // auto-enables "Склад" checkbox + fills value
'Номенклатура': 'Вентилятор' // same: enables checkbox + fills
});
Returns { filled: [{ field, ok, value, method }], form: {...} }.
Method is one of: 'clear' | 'toggle' | 'radio' | 'paste' | 'dropdown' | 'form' | 'typeahead'
selectValue(field, search, opts?) → form state with selectedSelect a value from reference field via dropdown or selection form. More reliable than fillFields for reference fields that need exact selection from a catalog. Pass empty search ('' or null) to clear the field (Shift+F4).
search — string for simple search, or { field: value } object for per-field advanced search:
await selectValue('Организация', 'Конфетпром');
// result.selected = { field: 'Организация', search: 'Конфетпром', method: 'dropdown'|'form' }
// Per-field search (disambiguate by multiple columns):
await selectValue('Документ', { 'Номер': '0000-000601', 'Дата': '29.12.2016' }, { type: 'Реализация (акт' });
For composite-type fields (accepting multiple types), specify type to first select the type, then the value:
await selectValue('Документ', '0000-000601', { type: 'Реализация (акт' });
// Clears field → opens type dialog → picks type via Ctrl+F → picks value from selection form
// result.selected = { field: 'Документ', search: '0000-000601', type: 'Реализация (акт', method: 'form' }
Also supports DCS labels — auto-enables the paired checkbox.
fillTableRow(fields, opts) → form stateFill table row cells via Tab navigation. Value is a plain string, { value, type } for composite-type cells, or ''/null to clear (Shift+F4).
| Option | Description |
|---|---|
tab | Switch to tab before filling |
add | Add new row before filling |
row | Edit existing row by 0-based index |
table | Grid name from tables[] (for multi-grid forms) |
// Add new row:
await fillTableRow(
{ 'Номенклатура': 'Бумага', 'Количество': '10', 'Цена': '100' },
{ tab: 'Товары', add: true }
);
// Edit existing row:
await fillTableRow(
{ 'Количество': '20' },
{ tab: 'Товары', row: 0 }
);
// Multi-grid form — add row to specific table:
await fillTableRow(
{ 'Объект': 'БДДС' },
{ table: 'Исходящие', add: true }
);
// Composite-type cell (e.g. SubConto accepting multiple types):
await fillTableRow(
{ 'СубконтоКт1': { value: 'Голованов', type: 'Физическое лицо' } },
{ tab: 'Проводки' }
);
deleteTableRow(row, { tab?, table? }) → form stateDelete row by 0-based index. table targets a specific grid on multi-grid forms.
closeForm({ save? }) → form state with closedClose the current form via Escape. Returns form state with closed: true/false indicating whether the form actually closed.
| Argument | Behavior |
|---|---|
{ save: false } | Auto-clicks "Нет" on confirmation |
{ save: true } | Auto-clicks "Да" on confirmation |
{} (omitted) | Returns confirmation field if dialog appears |
closed — true if the form was closed (form number changed), false if it stayed open (e.g. Escape was ignored). Always check this to confirm the form actually closed. After closing, check formCount to see how many forms remain.
Preferred over clickElement('×') — close buttons on tabs are ambiguous.
filterList(text, opts?) → form stateFilter list. Simple mode searches all columns, advanced mode targets a specific field.
await filterList('КП00-000018'); // simple — all columns
await filterList('Мишка', { field: 'Наименование' }); // advanced — specific column
await filterList('Мишка', { field: 'Наименование', exact: true }); // exact match
Works on hierarchical catalogs too (flattens the view).
unfilterList({ field? }) → form stateClear filters. Without arguments clears all, with { field } clears specific badge.
screenshot() → PNG Bufferwait(seconds) → form stategetPage() → Playwright Page (raw, for advanced scripting)startRecording(path, opts?) / stopRecording() → MP4 video recording ({ force: true } to restart if already recording)showCaption(text, opts?) / hideCaption() → text overlay on pageshowTitleSlide(text, opts?) / hideTitleSlide() → full-screen title card (intro/outro)isRecording() → booleansetHighlight(on) / isHighlightMode() → auto-highlight mode for videohighlight(text) / unhighlight() → manual element highlighting (error lists available elements)addNarration(videoPath, opts?) → narrated MP4 with TTS voiceovergetCaptions() → caption timestamps from last recordingSee recording.md for setup (ffmpeg), highlight mode, TTS narration, API details, and examples.
If .v8-project.json has ffmpegPath, pass it to startRecording({ ffmpegPath }).
If .v8-project.json has tts config, pass it to addNarration() (provider, voice, apiKey).
await navigateSection('Продажи');
await openCommand('Заказы клиентов');
await clickElement('Создать');
await fillFields({ 'Организация': 'Конфетпром', 'Контрагент': 'Альфа' });
await fillTableRow({ 'Номенклатура': 'Бумага', 'Количество': '10' }, { tab: 'Товары', add: true });
await clickElement('Провести и закрыть');
await clickElement('КП00-000227', { dblclick: true });
// Always use { dblclick: true } — single click only selects the row
await filterList('Конфетпром'); // flatten + search
await clickElement('Конфетпром ООО', { dblclick: true }); // open
await closeForm();
await unfilterList(); // restore hierarchy
// Fill report filters using readable labels
await fillFields({ 'Склад': 'Основной склад' });
await clickElement('Сформировать');
await wait(5);
const report = await readSpreadsheet();
console.log('Title:', report.title);
console.log('Data rows:', report.data?.length);
// Generate report
await clickElement('Сформировать');
await wait(5);
const report = await readSpreadsheet();
// Double-click cell to open drill-down (uses coordinates from readSpreadsheet)
await clickElement({ row: 0, column: 'К6' }, { dblclick: true });
// Modal dialog "Выбор поля" opens
await clickElement('Регистратор');
await clickElement('Выбрать');
await wait(10);
const drilldown = await readSpreadsheet();
Some forms have multiple grids (e.g. "Входящие" and "Исходящие" tables on a single form). Without table, buttons like "Добавить" hit the first match and readTable reads the first grid — which may not be the one you need.
Step 1 — discover tables via getFormState():
const form = await getFormState();
// form.tables = [
// { name: "ДеревоБизнесПроцессов", columns: ["Полный код", "Бизнес-процесс"], rowCount: 21 },
// { name: "Входящие", label: "Входящие", columns: ["Объект", "Бизнес-процесс источник", ...], rowCount: 1 },
// { name: "Исходящие", label: "Исходящие", columns: ["Объект", "Бизнес-процесс приемник", ...], rowCount: 1 }
// ]
Step 2 — use table name in any grid operation:
// Read specific table
const t = await readTable({ table: 'Исходящие' });
// Add row — fillTableRow with add:true already clicks the right "Добавить" button
await fillTableRow({ 'Объект': 'БДДС' }, { table: 'Исходящие', add: true });
// Or click buttons separately
await clickElement('Добавить', { table: 'Входящие' });
// Delete from specific table
await deleteTableRow(0, { table: 'Исходящие' });
Table matching accepts both technical name (tables[].name) and visual label (tables[].label). Label is the group title shown on screen — useful when working from screenshots. Name match takes priority over label match.
const page = await getPage();
await page.keyboard.press('F8'); // example: create new item in focused reference field
| Key | Context | Action |
|---|---|---|
F8 | Reference field focused | Create new catalog item |
Shift+F4 | Any input field focused | Clear field value (auto via ''/null in fillFields/selectValue/fillTableRow) |
F4 | Reference field focused | Open selection form |
Alt+F | List/table form | Open advanced search dialog |
| Goal | Method |
|---|---|
| Post & close document | clickElement('Провести и закрыть') |
| Save & close catalog | clickElement('Записать и закрыть') |
| Close without saving | closeForm({ save: false }) |
| Close and save | closeForm({ save: true }) |
| Close (manual confirm) | closeForm() — returns confirmation if dialog appears |
{ "ok": true, "output": "...console.log output...", "elapsed": 3.2 }
On error (auto-screenshot taken):
{ "ok": false, "error": "Element not found", "output": "...", "screenshot": "error-shot.png", "elapsed": 1.5 }
filterList returns 0 rows or readTable is empty after filtering — the item likely doesn't exist in this database. Don't retry the same search 5 times with slight variationsnavigateLink. Couldn't find via simple search? Try advanced search with a specific field. But don't repeat the same methodstart)cat <<'SCRIPT' | node $RUN exec - to avoid escaping issues\u00a0 instead of regular spaces. All matching is normalized internallynavigateSection() works with any panel position (side, top) but requires "Picture and text" or "Text" display mode. Icon-only mode is not supported — API cannot read section names from icons alone