# Yandex Direct For All

Переносимый набор навыков и подключаемых служб для Яндекс.Директа, Метрики, Wordstat v2, Roistat, amoCRM и Yandex Search API.

## Главное

- Единая точка входа: plugins/yandex-direct-for-all/skills/yandex-direct-unified/SKILL.md.
- Встроены два общих приложения авторизации: для Директа и для Метрики. Любой пользователь может разрешить доступ к своему Яндекс-аккаунту без создания собственного приложения.
- Открытые идентификаторы приложений опубликованы намеренно; секретов приложений и пользовательских токенов в хранилище нет.
- Wordstat использует текущий программный интерфейс v2 Yandex Cloud, общий межпроцессный учёт 10 запросов в секунду и 100 тарифицируемых запросов в час.
- Чтение отделено от записи. Запись требует явного разрешения, точного пакета, снимка до изменения и чтения после него.
- Установщик сначала показывает план, не перезаписывает пользовательские файлы, подготавливает закреплённые зависимости поиска и Wordstat и умеет точно откатывать свой запуск.
- Платный Search API по умолчанию выключен; ручной и заранее разрешённый режимы имеют точные лимиты и закрытый журнал.

## Установка

Для работы прямо из хранилища Кодекс использует .agents/plugins/marketplace.json.

Для личной установки сначала посмотреть план:

    bash plugins/yandex-direct-for-all/scripts/install_bundle.sh --target codex
    bash plugins/yandex-direct-for-all/scripts/install_bundle.sh --target claude
    bash plugins/yandex-direct-for-all/scripts/install_bundle.sh --target both

Если план верен:

    bash plugins/yandex-direct-for-all/scripts/install_bundle.sh --target both --apply

Команда выдаст RUN_ID и точную команду отката. Повторный запуск обновляет только неизменённые управляемые каталоги; пользовательское изменение даёт конфликт до любой записи.

## Первый запуск

1. Проверить набор:

       bash plugins/yandex-direct-for-all/scripts/release_gate.sh

2. Открыть единый навык.
3. Для Директа или Метрики запустить встроенную авторизацию. Код подтверждения вводится скрыто, а токен после обмена обязательно проверяется чтением целевой службы.
4. Для Wordstat создать защищённый файл с api_key и folder_id, права 600, затем использовать collect_wordstat_wave.sh.

Подробности: QUICKSTART.md, docs/component-inventory.md и docs/auth-model-matrix.md.