Individual skill

roistat-reports-api

Чтение отчётов Roistat, воспроизводимая сверка с сырыми сделками и коллтрекингом, а также строго ограждённая запись сохранённых отчётов.

plugins/nebelov/yandex-direct-for-all/skills/roistat-reports-api/SKILL.md

Read pinned source

Source commit d780783eba4ecc7c8b9429f95c9362df95f07c61

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: Yes
Repository scan complete: No
Skill scan complete: No
Observed behavior: Network or broad shell
Last checked: Nov 4, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 1,532
Repository last updated: Nov 6, 2026
License: Apache-2.0

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

ai-coding Repository topic
awesome Repository topic
awesome-list Repository topic
codex Repository topic
codex-plugins Repository topic
openai Repository topic
codex-skill Repository topic
codex-skills Repository topic
marketplace Repository topic
codex-marketplace Repository topic
engineering Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

SKILL.mdcore · 16,681 bytes
SKILL.mdcore · 16,681 bytes
agents/openai.yamlasset · 282 bytes
references/reporting-endpoints.mddoc · 8,230 bytes
scripts/build_roistat_report_pack.pyruns · 12,466 bytes
scripts/save_roistat_report.pyruns · 10,791 bytes
tests/test_reporting_contract.pyruns · 8,583 bytes

Read excerpt


# Отчёты Roistat

## Если Roistat не подключён

Roistat необязателен. Нет проекта или ключа — не создавайте их и не просите у пользователя ради чужой задачи: продажи берутся из CRM (выгрузка файлом или навык `amocrm-api-control`) или из целей Метрики, а выводы помечаются «продажи не проверены». В общих сценариях сбора вызывайте `roistat_query.sh --if-configured`: без доступа шаг пропускается, а не роняет пакет; на месте файла результата остаётся `{"status": "skipped"}`, и такой файл не считается выгрузкой продаж.

## Обязательный порядок

1. Доступ бери из `ROISTAT_PROJECT` и `ROISTAT_API_KEY` либо из указанного закрытого файла JSON с правами `0600`. Никогда не передавай ключ аргументом.
2. Точно задай период, окно, модель атрибуции, канал, фильтры и валюту.
3. Считай три источника разными: аналитический отчёт, сырые сделки и коллтрекинг. У каждого есть собственное состояние полноты.
4. Сырые сделки и коллтрекинг запрашивай только с явным `--include-personal-data`; полученные пакеты остаются закрытыми.
5. Проходи всю постраничную выдачу. Статус `partial` не превращай в полный отчёт.
6. Каждое число должно воспроизводиться из сохранённых ответов и `report-context.json`.