Yandex Direct tools
Yandex Direct accounts, campaigns and performance reports; status and weekly budget changes go through preview and approval and can be undone.
Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.
Read tools4 tools
list_yandex_clients
Odczyt1 creditsYandex Direct accounts reachable through the connected login: an agency's clients, otherwise the connected account itself. Returns login (account_id), name, currency, type and archived flag. Read only; connected=false when Yandex isn't connected.
This tool takes no parameters.
list_yandex_campaigns
Odczyt1 creditsYandex Direct campaigns: id, name, type, state, status, bidding strategy and weekly budget, with spend, impressions, clicks and conversions for the last N days. If the statistics report is still queued, stats stay empty and stats_ready=false. Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Yandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself |
daysOptional | integer (1–365) | last N days including today, default 30 |
stateOptional | on | off | suspended | ended | archived | converted | — |
yandex_performance_report
Odczyt1 creditsYandex Direct campaign performance report: impressions, clicks, cost, CTR, average CPC, conversions and cost per conversion, per campaign or per day. Large reports are queued by Yandex: pending=true means call again with the same arguments. Read only; never invents numbers.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Yandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself |
daysOptional | integer (1–365) | last N days including today, default 30 |
date_fromOptional | string | YYYY-MM-DD, with date_to |
date_toOptional | string | YYYY-MM-DD, with date_from |
campaign_idOptional | string | — |
group_byOptional | campaign | day | — |
include_vatOptional | boolean | include VAT in monetary values, default false |
diagnose_yandex_delivery
Odczyt1 creditsWhy a Yandex Direct campaign isn't serving, or is off, suspended, in moderation or rejected: call it first when the user reports such a problem. Live read of the campaign (state, status, payment status, Yandex's status clarification text, bidding strategy targets and limits, funds), its ad groups (keyword review status, serving status) and ads (state, moderation status, rejection text, sitelink / image / per-asset moderation), plus which objects changed in the last 7 days; returned with a findings list (scope, Yandex's code, category, evidence) and cannot_read for what the API doesn't expose. Read only.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Yandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself |
campaign_idRequired | string | Yandex Direct campaign id (list_yandex_campaigns) |
Write tools3 tools
update_yandex_campaign_status
Zapis2 creditsPause or activate a Yandex Direct campaign. Applied when the user asks, recorded in the audit log and undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Yandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself |
campaign_idRequired | string | — |
statusRequired | pause | activate | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_yandex_campaign_budget
Zapis2 creditsSet a Yandex Direct campaign weekly budget (account currency); Yandex no longer uses daily campaign budgets. Text and unified campaigns only; portfolio, custom period and priority goal strategies are refused. Increases above 50% per change or 2x per 24 hours are blocked; undoable with undo_action.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Yandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself |
campaign_idRequired | string | — |
weekly_budgetRequired | number | new weekly budget in the account currency |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_yandex_campaign
Zapis5 creditsCreate a Yandex Direct text campaign with an automatic strategy (weekly click budget) and suspend it right away - Yandex creates campaigns live, and manual strategies are no longer accepted for new campaigns. Budgets are weekly, not daily. Ad groups and ads are added in the Yandex interface.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Yandex login of an agency client (sent as Client-Login); defaults to the connection's selected account or the connected account itself |
nameRequired | string | — |
weekly_budgetRequired | number | account currency; Yandex budgets are WEEKLY |
placementOptional | search_only | search_and_network | — |
start_dateOptional | string | YYYY-MM-DD, not in the past |
end_dateOptional | string | YYYY-MM-DD |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.