Entrar Empezar gratis

Referencia de herramientas — Anuncios

General tools

Account status, campaign summary, reports, approval queue, brand profile and channel-independent change tools.

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.

Herramientas de lectura10 herramientas

get_status

Lectura1 créditos

Account overview: brand, plan, connected platforms, campaigns (7 days), pending approvals, open customer chats, spend guard. Call first when context is unknown.

Esta herramienta no recibe parámetros.

list_accounts

Lectura1 créditos

Connected ad and data accounts (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) with status. 'sample' connections are demo data, not live.

Esta herramienta no recibe parámetros.

list_campaigns

Lectura1 créditos

Campaigns with the last N days of spend, clicks, orders and revenue. Use the returned campaign ids for update_campaign / add_negative_keywords.

Parámetro	Tipo	Descripción
`days`Opcional	integer (1–90)	—

get_report

Lectura1 créditos

Period report: spend, orders, revenue, ROAS, change versus the previous period, suggestions. Read only.

Parámetro	Tipo	Descripción
`period`Opcional	day \| week \| month	—

search_terms_report

Lectura2 créditos

Google 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.

Parámetro	Tipo	Descripción
`days`Opcional	integer (1–90)	—
`campaign_id`Opcional	string	—

account_audit

Lectura3 créditos

Account hygiene audit as prioritised findings: spend without results, missing budgets, no spend cap, wasted search terms, pending approvals. Read only.

Esta herramienta no recibe parámetros.

list_pending_approvals

Lectura1 créditos

Changes waiting for the user's approval (id, kind, title).

Esta herramienta no recibe parámetros.

get_brand_profile

Lectura1 créditos

Brand knowledge base: sector, location, products, audience, goals, tone, competitors.

Esta herramienta no recibe parámetros.

research

Lectura2 créditos

Web research (competitor, price, sector rule). If no research provider is configured, returns a note; never invent results.

Parámetro	Tipo	Descripción
`query`Obligatorio	string	—

list_customers

Lectura1 créditos

Customer conversations in the inbox (WhatsApp, Messenger, Instagram): who wrote, last message, waiting for reply.

Parámetro	Tipo	Descripción
`state`Opcional	needs_you \| waiting \| auto \| done	—
`limit`Opcional	integer	—

Herramientas de escritura13 herramientas

connect_account

Escritura0 créditos

Start connecting a platform account. Returns an authorisation link the user must open (OAuth); nothing is connected without the user signing in.

Parámetro	Tipo	Descripción
`provider`Obligatorio	google \| meta \| microsoft \| tiktok \| linkedin \| ga4 \| search-console \| gbp \| whatsapp \| shopify \| youtube	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_campaign

Escritura2 créditos

Create 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.

Parámetro	Tipo	Descripción
`name`Obligatorio	string	—
`platform`Obligatorio	google \| meta \| microsoft \| tiktok \| linkedin	—
`kind`Opcional	string	search \| pmax \| display \| message \| traffic \| conversion
`daily_budget`Opcional	number	—
`goal`Opcional	string	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_campaign

Escritura2 créditos

Pause / 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.

Parámetro	Tipo	Descripción
`campaign_id`Obligatorio	string	—
`op`Obligatorio	pause \| resume \| budget \| publish	—
`amount`Opcional	number	daily budget for op=budget

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_budget

Escritura2 créditos

Set a platform-level budget (no campaign id needed). Goes through preview and approval; increases above 50% per change are blocked.

Parámetro	Tipo	Descripción
`platform`Obligatorio	string	—
`amount`Obligatorio	number	—
`currency`Opcional	TRY \| USD \| EUR	—
`period`Opcional	day \| week \| month	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

add_negative_keywords

Escritura2 créditos

Add 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.

Parámetro	Tipo	Descripción
`campaign_id`Obligatorio	string	—
`keywords`Obligatorio	array<string>	—
`match_type`Opcional	BROAD \| PHRASE \| EXACT	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_rule

Escritura2 créditos

Turn an 'if … then …' sentence into an automation rule (mode=ask puts each trigger into approval, auto applies within the spend guard).

Parámetro	Tipo	Descripción
`sentence`Obligatorio	string	—
`mode`Opcional	ask \| auto	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_spend_guard

Escritura1 créditos

Profit guard: daily/monthly spend caps, target CPA, margin, average order value, autopilot.

Parámetro	Tipo	Descripción
`daily_cap_try`Opcional	number	—
`monthly_cap_try`Opcional	number	—
`target_cpa_try`Opcional	number	—
`margin_pct`Opcional	number	—
`aov_try`Opcional	number	—
`autopilot`Opcional	boolean	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

approve_action

EscrituraIrreversible5 créditos

Apply a pending change. Only call after the user explicitly said to approve it; pass confirm=true. Returns applied / dry run / failed.

Parámetro	Tipo	Descripción
`action_id`Obligatorio	string	—
`confirm`Obligatorio	boolean	must be true; only after the user explicitly approved

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

reject_action

Escritura0 créditos

Reject a pending change.

Parámetro	Tipo	Descripción
`action_id`Obligatorio	string	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

set_brand_profile

Escritura1 créditos

Write brand profile fields when the user describes the business.

Parámetro	Tipo	Descripción
`fields`Obligatorio	object	business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone …

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

draft_ad_copy

Escritura2 créditos

Ad copy drafts (headlines, descriptions, call to action) from the brand profile.

Parámetro	Tipo	Descripción
`platform`Opcional	google \| meta \| instagram	—
`kind`Opcional	string	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

reply_customer

Escritura2 créditos

Reply to a customer thread on the user's behalf (only when the user dictated or approved the text).

Parámetro	Tipo	Descripción
`thread_id`Obligatorio	string	—
`text`Obligatorio	string	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

generate_content

Escritura3 créditos

Studio: 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.

Parámetro	Tipo	Descripción
`kind`Obligatorio	string	image \| short_video \| ugc_video \| voice \| script
`brief`Opcional	string	—
`campaign_id`Opcional	string	—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.