yandex-direct-unified
Единая точка входа для безопасной работы с Яндекс.Директом: авторизация, чтение кабинета, Метрика, Wordstat, семантика, подготовка изменений и контролируемая запись.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- yandex-direct-unified
- description
- Единая точка входа для безопасной работы с Яндекс.Директом: авторизация, чтение кабинета, Метрика, Wordstat, семантика, подготовка изменений и контролируемая запись.
02 资源文件 14
- 参考文档agents/openai.yaml504 B
- 参考文档references/access-recovery-runbook.md2.2 KB
- 参考文档references/build-and-ops.md1.9 KB
- 参考文档references/decision-rules.md19.5 KB
- 参考文档references/keyword-collection-runbook.md25.7 KB
- 参考文档references/main-workflow.md37.0 KB
- 参考文档references/new-client-full-build-acceptance.md24.3 KB
- 参考文档references/operating-rules.md39.9 KB
- 参考文档references/research-forecast-acceptance.md16.6 KB
- 参考文档references/script-index.md10.0 KB
- 参考文档references/semantic-review-agent-brief.md14.3 KB
- 参考文档references/source-map.md6.5 KB
- 参考文档references/synonym-exhaustion-protocol.md7.5 KB
- 参考文档references/workflow-supervisor.md12.4 KB
03 SKILL.md 正文
Яндекс.Директ: единый рабочий навык
Этот навык задаёт порядок работы. Узкие навыки yandex-wordstat, roistat-reports-api и amocrm-api-control уточняют свои программные интерфейсы, но не заменяют этот порядок.
Перед началом
- Пройти общий поиск навыков по теме задачи.
- Всегда прочитать основной порядок, правила решений и правила работы. В правилах работы — таблица конкретных документов по операции: их прочитать до действия.
- Для семантики — сбор ключевых фраз, протокол исчерпания синонимов и задание смысловой проверки.
- Для исследования спроса, конкурентов, медиаплана или прогноза — приёмка исследования и прогноза.
- Для нового клиента, сборки по нескольким сайтам, комбинаторных объявлений и записи новых черновиков — приёмка новой сборки.
- Для действующего кабинета, авторизации или любой записи — надзорная проверка и указатель скриптов; при сбое доступа — восстановление доступа.
- Для изменения самого навыка — карта источников правил.
В первом статусе назвать прочитанные файлы.
Все ссылки относительны каталога навыка: установка не зависит от имени пользователя и расположения домашнего каталога.
Неподвижные правила
-
Roistat, amoCRM и XMLRiver необязательны. Отсутствие такого источника блокирует только выводы, которым он нужен (окупаемость, продажи, платный сбор выдачи), а не всю задачу. Подключение проверяйте по факту доступа, не предполагайте.
-
Сначала определить клиента, кабинет и разрешённый объём; затем читать данные.
-
Доступ подтверждается свежим запросом к нужной службе, а не наличием файла с токеном.
-
В поставке есть общие приложения авторизации для Директа и Метрики. Пользователю не требуется создавать собственное приложение.
-
Авторизация Директа и Метрики раздельна. Токен, код подтверждения и секрет приложения не передаются в аргументах процесса и не печатаются.
-
Чтение и запись разделены. Любая запись, запуск, модерация, бюджет или остановка трафика требуют отдельного явного разрешения.
-
Имена кампаний и групп показываются пользователю раньше служебных номеров.
-
Сырые данные Wordstat и поисковых фраз не являются готовой семантикой.
-
Автоматические сценарии не принимают смысловые решения за человека или проверяющего агента.
-
Секреты и клиентские выгрузки хранятся только вне каталога навыка.
-
Сначала API Директа; интерфейс — только при доказанном отсутствии метода. Метрика — только через API.
-
В общем аккаунте читаются только кампании клиента. «0 кампаний» при заявленном кабинете — блокер доступа, а не факт о бизнесе.
-
«Не знаю» — это ответ: повторно его не спрашивать, но и фактом не считать.
-
Доказательства раскладываются по элементам (текст, посадочная, площадка, аудитория); одна продажа не засчитывается нескольким объявлениям.
-
РСЯ — отдельный пакет текстов, у каждого объявления своё изображение без искажений.
DisplayUrlPath— русский, до 20 символов, из ключа группы. Якоря в быстрых ссылках запрещены. -
Полный поисковый запрос — доказательство, а не минус-фраза: в минус-слова идёт одно слово или неразрывная пара.
-
Бюджет и денежные параметры стратегии берутся только из решения заказчика; иначе
unknown. -
Изменяемые поля перечитываются из API непосредственно перед записью; после записи ранее работавшие кампании сверяются со снимком «до».
Результат
Каждый запуск оставляет проверяемые входы, исходные ответы, решения, план изменения и чтение после изменения. Если обязательного доказательства нет, статус — BLOCKED с конкретной причиной, а не предположение о готовности.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.