yandex-direct-campaign-builder

name	yandex-direct-campaign-builder
description	Создавать, аудитить, запускать и оптимизировать кампании Яндекс Директа через LidFly MCP v3 с Wordstat, Метрикой и точным provider scope. Использовать для кампаний, групп, ключей, объявлений, ставок, бюджетов и статистики с современным ЕПК workflow.

Yandex Direct Campaign Builder

Use for Yandex Direct campaign creation, audit, optimization, budgets, keywords, negative keywords, responsive ads, search queries, Wordstat, and Metrika-linked decisions.

v3 Scope First

1. search_tools({ provider: "yandex", query }).
2. get_tool_schema before each new tool.
3. Unknown account/client/project: get_provider_context({ provider: "yandex", query? }). Keep query for free project/name/INN search; when the exact Direct login is known, pass it separately as client_login (both fields may be used together).
4. Named campaign: resolve_campaign_scope({ provider: "yandex", query, workspace_project_id? }).
5. Copy returned scope_arguments into Direct calls.
6. Read through call_tool; write through call_write_tool.

Direct tools use connection_id and optional client_login. Metrika tools use counter_id and optional connection_id, not client_login.

For legacy Workspace links, accept a recovered Direct scope only when get_provider_context returns the complete workspace_project_id + connection_id + client_login in tool_args. Read scope_issues: run only a read-only next_action with may_execute_automatically=true; never guess around manual_scope_review, ambiguity, conflict, provider outage, or login-not-found. Do not derive client_login from external_entity_key, a project/account name, external_entity_name, or Direct ClientId.

Progressive References

• For a new ЕПК campaign read campaign creation.
• For bidding, goals and learning status read bidding strategy.
• get_methodology(topic: "yandex") uses the compact compatibility methodology.

Guardrails

• Search-first by default; disable networks unless user explicitly asks.
• Budget values are rubles, not micro-units.
• Read current state before write.
• Show write plan and wait for explicit text confirmation.
• For agency/team Пространства include exact workspace_project_id.
• Changes to goal, strategy, or budget over 30% require separate confirmation.
• Never invent IDs, statistics, goals, counters, budgets, or Wordstat frequency.

Лендинги Директа

Публичный API Яндекс Директа не позволяет прочитать настройки блоков, создать, изменить, опубликовать или удалить контент лендингов на clients.site и турбо-страницах. Для такого запроса search_tools возвращает capability_notice.status=unsupported_by_provider_api.

• Объясни пользователю ограничение и предложи открыть страницу в веб-интерфейсе Директа.
• get_turbo_pages читает только метаданные опубликованных страниц; get_leads читает только отправленные формы.
• Не используй update_ad, update_campaign или другой рекламный write как замену редактированию блоков страницы.
• Не вызывай support-инструменты и не отправляй такое ограничение в поддержку LidFly.

Браузерный fallback

Использовать браузерный сценарий только когда AI-клиент умеет управлять уже авторизованным браузером и пользователь прямо попросил выполнить работу в веб-интерфейсе. Это не MCP/API-операция.

• Сначала прочитать текущее состояние в интерфейсе. Не запрашивать, не вводить и не сохранять логины, пароли, одноразовые коды или другие учётные данные; если сессия не авторизована, попросить пользователя войти самостоятельно и остановиться.
• Перед любым кликом, который меняет контент, публикацию, бюджет, ставку, цель, стратегию, статус, модерацию или расход денег, показать точный план и дождаться явного текстового подтверждения. Просьба открыть или проверить страницу не разрешает сохранять изменения.
• Ничего не сохранять, не публиковать, не запускать и не останавливать автоматически. После подтверждённого действия перечитать состояние в интерфейсе и проверить фактический результат.

Read Checklist

• get_campaigns with useful states and field_names.
• get_adgroups, get_ads or get_responsive_ads, get_keywords.
• get_autotargeting for categories.
• get_campaign_stats, get_search_queries with period and attribution.
• Wordstat via wordstat_* without client_login or connection_id.

Workspace

After confirmed work, save decisions, documents, analytics, campaign snapshots, or follow-up tasks only with resolved workspace_project_id. Use workspace_prepare_project_scope if uncertain.

Google Export

When the user asks to export a Direct report to Google Sheets or Google Docs, keep this skill for campaign scope and report reads, then hand the verified Google write and reread to $export-ad-reports.