Genel araçlar
Hesap durumu, kampanya özeti, raporlar, onay kuyruğu, marka profili ve kanaldan bağımsız değişiklik araçları.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü özgün İngilizce metinlerdir.
Okuma araçları10 araç
get_status
Okuma1 krediAccount overview: brand, plan, connected platforms, campaigns (7 days), pending approvals, open customer chats, spend guard. Call first when context is unknown.
Bu araç parametre almaz.
list_accounts
Okuma1 krediConnected ad and data accounts (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) with status. 'sample' connections are demo data, not live.
Bu araç parametre almaz.
list_campaigns
Okuma1 krediCampaigns with the last N days of spend, clicks, orders and revenue. Use the returned campaign ids for update_campaign / add_negative_keywords.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
get_report
Okuma1 krediPeriod report: spend, orders, revenue, ROAS, change versus the previous period, suggestions. Read only.
| Parametre | Tip | Açıklama |
|---|---|---|
periodİsteğe bağlı | day | week | month | — |
search_terms_report
Okuma2 krediGoogle Ads search terms with spend, clicks and conversions for the last N days, plus the wasted (zero-conversion) terms. Requires a connected Google Ads account; otherwise returns a note, never invented numbers.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
campaign_idİsteğe bağlı | string | — |
account_audit
Okuma3 krediAccount hygiene audit as prioritised findings: spend without results, missing budgets, no spend cap, wasted search terms, pending approvals. Read only.
Bu araç parametre almaz.
list_pending_approvals
Okuma1 krediChanges waiting for the user's approval (id, kind, title).
Bu araç parametre almaz.
get_brand_profile
Okuma1 krediBrand knowledge base: sector, location, products, audience, goals, tone, competitors.
Bu araç parametre almaz.
research
Okuma2 krediWeb research (competitor, price, sector rule). If no research provider is configured, returns a note; never invent results.
| Parametre | Tip | Açıklama |
|---|---|---|
queryZorunlu | string | — |
list_customers
Okuma1 krediCustomer conversations in the inbox (WhatsApp, Messenger, Instagram): who wrote, last message, waiting for reply.
| Parametre | Tip | Açıklama |
|---|---|---|
stateİsteğe bağlı | needs_you | waiting | auto | done | — |
limitİsteğe bağlı | integer | — |
Yazma araçları13 araç
connect_account
Yazma0 krediStart connecting a platform account. Returns an authorisation link the user must open (OAuth); nothing is connected without the user signing in.
| Parametre | Tip | Açıklama |
|---|---|---|
providerZorunlu | google | meta | microsoft | tiktok | linkedin | ga4 | search-console | gbp | whatsapp | shopify | youtube | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_campaign
Yazma2 krediCreate a campaign DRAFT (paused). Going live is a separate step: update_campaign(op=publish) which passes the approval gate. Platforms without a live adapter return can_go_live=false with steps.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
platformZorunlu | google | meta | microsoft | tiktok | linkedin | — |
kindİsteğe bağlı | string | search | pmax | display | message | traffic | conversion |
daily_budgetİsteğe bağlı | number | — |
goalİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_campaign
Yazma2 krediPause / resume / change daily budget / publish a campaign. Returns a preview and status: applied, pending approval, or dry run. Nothing is applied without the user's approval policy allowing it.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
opZorunlu | pause | resume | budget | publish | — |
amountİsteğe bağlı | number | daily budget for op=budget |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_budget
Yazma2 krediSet a platform-level budget (no campaign id needed). Goes through preview and approval; increases above 50% per change are blocked.
| Parametre | Tip | Açıklama |
|---|---|---|
platformZorunlu | string | — |
amountZorunlu | number | — |
currencyİsteğe bağlı | TRY | USD | EUR | — |
periodİsteğe bağlı | day | week | month | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_negative_keywords
Yazma2 krediAdd negative keywords to a Google Ads campaign. Creates an approval item with a preview; applied to Google only after approval and only with a connected account.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
keywordsZorunlu | array<string> | — |
match_typeİsteğe bağlı | BROAD | PHRASE | EXACT | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_rule
Yazma2 krediTurn an 'if … then …' sentence into an automation rule (mode=ask puts each trigger into approval, auto applies within the spend guard).
| Parametre | Tip | Açıklama |
|---|---|---|
sentenceZorunlu | string | — |
modeİsteğe bağlı | ask | auto | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_spend_guard
Yazma1 krediProfit guard: daily/monthly spend caps, target CPA, margin, average order value, autopilot.
| Parametre | Tip | Açıklama |
|---|---|---|
daily_cap_tryİsteğe bağlı | number | — |
monthly_cap_tryİsteğe bağlı | number | — |
target_cpa_tryİsteğe bağlı | number | — |
margin_pctİsteğe bağlı | number | — |
aov_tryİsteğe bağlı | number | — |
autopilotİsteğe bağlı | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
approve_action
YazmaGeri alınamaz5 krediApply a pending change. Only call after the user explicitly said to approve it; pass confirm=true. Returns applied / dry run / failed.
| Parametre | Tip | Açıklama |
|---|---|---|
action_idZorunlu | string | — |
confirmZorunlu | boolean | must be true; only after the user explicitly approved |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
reject_action
Yazma0 krediReject a pending change.
| Parametre | Tip | Açıklama |
|---|---|---|
action_idZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_brand_profile
Yazma1 krediWrite brand profile fields when the user describes the business.
| Parametre | Tip | Açıklama |
|---|---|---|
fieldsZorunlu | object | business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone … |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
draft_ad_copy
Yazma2 krediAd copy drafts (headlines, descriptions, call to action) from the brand profile.
| Parametre | Tip | Açıklama |
|---|---|---|
platformİsteğe bağlı | google | meta | instagram | — |
kindİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
reply_customer
Yazma2 krediReply to a customer thread on the user's behalf (only when the user dictated or approved the text).
| Parametre | Tip | Açıklama |
|---|---|---|
thread_idZorunlu | string | — |
textZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
generate_content
Yazma3 krediStudio: generate an image, short video, UGC video, voice-over or script from a brief. The script is immediate; files take minutes and need an AI route.
| Parametre | Tip | Açıklama |
|---|---|---|
kindZorunlu | string | image | short_video | ugc_video | voice | script |
briefİsteğe bağlı | string | — |
campaign_idİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.