| name | yandex-direct-unified |
| description | Единая точка входа для безопасной работы с Яндекс.Директом: авторизация, чтение кабинета, Метрика, Wordstat, семантика, подготовка изменений и контролируемая запись. |
Яндекс.Директ: единый рабочий навык
Этот навык задаёт порядок работы. Узкие навыки yandex-wordstat, roistat-reports-api и amocrm-api-control уточняют свои программные интерфейсы, но не заменяют этот порядок.
Перед началом
- Пройти общий поиск навыков по теме задачи.
- Прочитать references/main-workflow.md и references/decision-rules.md.
- Для семантики прочитать references/keyword-collection-runbook.md.
- Для изменения самого навыка прочитать references/source-map.md.
- Для действующего кабинета, авторизации или любой записи пройти references/workflow-supervisor.md.
Все ссылки относительны каталога навыка: установка не зависит от имени пользователя и расположения домашнего каталога.
Неподвижные правила
- Сначала определить клиента, кабинет и разрешённый объём; затем читать данные.
- Доступ подтверждается свежим запросом к нужной службе, а не наличием файла с токеном.
- В поставке есть общие приложения авторизации для Директа и Метрики. Пользователю не требуется создавать собственное приложение.
- Авторизация Директа и Метрики раздельна. Токен, код подтверждения и секрет приложения не передаются в аргументах процесса и не печатаются.
- Чтение и запись разделены. Любая запись, запуск, модерация, бюджет или остановка трафика требуют отдельного явного разрешения.
- Имена кампаний и групп показываются пользователю раньше служебных номеров.
- Сырые данные Wordstat и поисковых фраз не являются готовой семантикой.
- Автоматические сценарии не принимают смысловые решения за человека или проверяющего агента.
- Секреты и клиентские выгрузки хранятся только вне каталога навыка.
Результат
Каждый запуск оставляет проверяемые входы, исходные ответы, решения, план изменения и чтение после изменения. Если обязательного доказательства нет, статус — BLOCKED с конкретной причиной, а не предположение о готовности.
