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.