| 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
search_tools({ provider: "yandex", query }).get_tool_schema before each new tool.- Unknown account/client/project:
get_provider_context({ provider: "yandex", query? }).
- Named campaign:
resolve_campaign_scope({ provider: "yandex", query, workspace_project_id? }).
- Copy returned
scope_arguments into Direct calls.
- 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.
Default Modern Build
Use modern managed campaigns by default:
add_unified_campaign
-> add_adgroup with adgroup_type: UNIFIED_AD_GROUP
-> add_keywords_batch
-> add_responsive_ad
-> manage_ads action: moderate only after explicit confirmation
add_adgroups creates multiple legacy TEXT_AD_GROUP groups and must not be used for UNIFIED_AD_GROUP. Legacy add_campaign, add_adgroups, add_ad, and add_ads are compatibility-only for old text scenarios. If used, say clearly that it is a legacy TEXT_AD path and reread actual ad Type after creation.
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.
