Яндекс Директ: Действие с ключевыми фразами — MCP-инструмент (tool)

MCP-инструмент (tool) для Яндекс Директа: Выполняет действие над ключевыми фразами по id: suspend, resume или delete.

Техническое имя: keyword_action

Какую задачу решает

Я хочу выполнить действие с ключевыми фразами.

Выполняет действие над ключевыми фразами по id: suspend, resume или delete.

Когда использовать

Используйте эту возможность, когда нужен результат «Действие с ключевыми фразами» без ручной работы в интерфейсе Яндекс Директа. Операция выполняется только по вызову из AI-приложения.

Что нужно передать

• action — обязательно. Действие из перечня, указанного в описании инструмента.
• ids — обязательно. Id ключевых фраз, к которым применить действие.

Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

Что изменится в Яндекс Директе

Исходный код помечает весь вызов «Действие с ключевыми фразами» как опасный. Конкретное воздействие зависит от переданного действия и описано ниже; перед вызовом проверьте параметры и обратимость результата.

Пример запроса

Выполнить действие с ключевыми фразами в Яндекс Директе. Если не хватает обязательных идентификаторов, сначала уточни их. Сначала покажи, какие данные изменятся, и дождись подтверждения.

Возможные ошибки и ограничения

Проверьте обязательные параметры, права токена и актуальные ограничения исходного API.

Доступ также зависит от прав токена, квот и ограничений исходного API.

Связанные MCP-инструменты

• Добавить ключевые фразы — add_keywords
• Список ключевых фраз — list_keywords
• Задать ставки ключевых фраз — set_keyword_bids

Технические сведения

• Воздействие: опасная операция
• Группа: Ключевые фразы и ставки
• Источник описания: регистрация keyword_action в src/tools/keywords.ts
• Полный технический справочник
• Все MCP-возможности