Detect creative fatigue across active ads — rising frequency, declining CTR week-over-week, and CPM drift — score each ad FATIGUED / WATCH / FRESH, and hand the evidence to a creative refresh. Use when the user asks whether creatives are worn out, why CTR is falling, if frequency is too high, when to rotate or refresh ads, or requests クリエイティブ疲弊チェック / 広告の疲弊を確認 / フリークエンシーが高い / CTRが落ちてきた / そろそろ差し替え時か. Reads active ads per platform, applies documented fatigue thresholds with noise guards, and routes fatigued ads to /creative-generate or /creative-refresh.

2026-07-1816

audience-review

logly/mureo

Audit who your ads actually target and where they run, compare it against the STRATEGY.md Persona, and surface exclusions, bid adjustments, lookalikes, and placement pruning tied to that Persona. Use when the user asks to review targeting, audiences, demographics, placements, or device performance, to check whether spend matches the Persona, to find wasted placements (e.g. Audience Network with no conversions), or requests オーディエンスレビュー / 配置レビュー / ターゲティング見直し / ペルソナと配信のズレを確認 / 除外設定を提案して. Reads Persona + Target Audience from STRATEGY.md and drives the read-only targeting tools.

2026-07-1816

budget-pacing

logly/mureo

Month-to-date spend vs the monthly budget target, projected month-end landing, and pace alerts across all configured platforms. Use when the user asks about pacing, burn rate, whether they will overspend or underspend this month, monthly-budget tracking, landing/forecast, 'are we on budget', or requests 予算ペーシング / 着地予測 / 予算消化ペース. DISTINCT from /budget-rebalance (which reallocates budget between campaigns) — this manages total-spend trajectory toward a monthly target. Reads STRATEGY.md Guardrails / a Monthly Budget section and STATE.json.

2026-07-1816

budget-rebalance

logly/mureo

Rebalance campaign budgets across all configured platforms based on strategy and performance signals. Use when the user asks to optimize budgets, redistribute spend, scale efficient campaigns, or cap overspending ones. Reads STRATEGY.md goals, analyzes campaign efficiency, and proposes budget changes with rationale. Also use when the user asks in Japanese (予算を最適化して / 予算の再配分 / 好調なキャンペーンに予算を寄せて / 予算リバランス).

2026-07-1816

name	_mureo-google-ads
description	Google Ads: Manage campaigns, ad groups, ads, keywords, budgets, and performance analysis.
metadata	{"version":"0.10.29","openclaw":{"category":"advertising","requires":{"bins":["mureo"]},"cliHelp":"mureo --help"}}

Google Ads (v23)

PREREQUISITE: Read ../_mureo-shared/SKILL.md for auth, global flags, and security rules.

There is no mureo google-ads … CLI command. Every operation below is an MCP tool (google_ads_*). Call the tool directly — never run or suggest a mureo google-ads campaigns-list-style shell command (it does not exist and will error, which is NOT a mureo bug).

No customer_id? (recovery)

Every Google Ads tool needs a customer_id (the target account). It is resolved from the stored credentials (set by mureo auth setup). When it is missing a tool returns customer_id is required. Provide it as a parameter or configure it … — auth is fine, only the account is unset (a common state when the operator finished sign-in but skipped account selection).

When you see that error, recover automatically — do NOT ask the operator to look up the ID in the Google Ads UI, and do NOT fall back to a CSV / "ask the agency":

Call google_ads_accounts_list — it needs no customer_id and returns every account reachable by the login.
Exactly one account → use its id as customer_id on the retried call and tell the operator which account you selected.
Several accounts → show the list and ask the operator which one to use.
Zero accounts → the login can't reach any Google Ads account; tell the operator to re-run mureo auth setup (or grant the account access), and that customer_id can be set there or via GOOGLE_ADS_CUSTOMER_ID (plus GOOGLE_ADS_LOGIN_CUSTOMER_ID for an MCC).

To persist the choice so it survives across sessions, point the operator at mureo auth setup (account picker) or the configure UI's env writer (GOOGLE_ADS_CUSTOMER_ID); passing customer_id per call works for the immediate request but is not remembered.

Tool Summary

#	Tool Name	Category	Type	Description
1	`google_ads_campaigns_list`	Campaign	Read	List campaigns
2	`google_ads_campaigns_get`	Campaign	Read	Get campaign details
3	`google_ads_campaigns_create`	Campaign	Write	Create a campaign (search or display, via `channel_type`)
4	`google_ads_campaigns_update`	Campaign	Write	Update campaign settings
5	`google_ads_campaigns_update_status`	Campaign	Write	Change campaign status
6	`google_ads_campaigns_diagnose`	Campaign	Read	Diagnose delivery issues
7	`google_ads_ad_groups_list`	Ad Group	Read	List ad groups
8	`google_ads_ad_groups_create`	Ad Group	Write	Create an ad group
9	`google_ads_ad_groups_update`	Ad Group	Write	Update ad group settings
10	`google_ads_ads_list`	Ad	Read	List ads
11	`google_ads_ads_create`	Ad	Write	Create an RSA ad
12	`google_ads_ads_update`	Ad	Write	Update ad content
13	`google_ads_ads_update_status`	Ad	Write	Change ad status
14	`google_ads_ads_policy_details`	Ad	Read	Get ad policy approval details
15	`google_ads_keywords_list`	Keyword	Read	List keywords
16	`google_ads_keywords_add`	Keyword	Write	Add keywords
17	`google_ads_keywords_remove`	Keyword	Write	Remove a keyword
18	`google_ads_keywords_suggest`	Keyword	Read	Suggest keywords via Keyword Planner
19	`google_ads_keywords_diagnose`	Keyword	Read	Diagnose keyword quality scores
20	`google_ads_keywords_pause`	Keyword	Write	Pause a keyword
21	`google_ads_keywords_audit`	Keyword	Read	Audit keyword performance and quality
22	`google_ads_keywords_cross_adgroup_duplicates`	Keyword	Read	Find duplicate keywords across ad groups
23	`google_ads_negative_keywords_list`	Negative KW	Read	List negative keywords
24	`google_ads_negative_keywords_add`	Negative KW	Write	Add negative keywords to a campaign
25	`google_ads_negative_keywords_remove`	Negative KW	Write	Remove a negative keyword
26	`google_ads_negative_keywords_add_to_ad_group`	Negative KW	Write	Add negative keywords to an ad group
27	`google_ads_negative_keywords_suggest`	Negative KW	Read	Suggest negative keywords from search terms
28	`google_ads_budget_get`	Budget	Read	Get campaign budget
29	`google_ads_budget_update`	Budget	Write	Update daily budget
30	`google_ads_budget_create`	Budget	Write	Create a new campaign budget
31	`google_ads_accounts_list`	Account	Read	List accessible Google Ads accounts
32	`google_ads_search_terms_report`	Search Terms	Read	Search terms report
33	`google_ads_search_terms_review`	Search Terms	Read	Review search terms with rule-based scoring
34	`google_ads_search_terms_analyze`	Search Terms	Read	Analyze search terms with intent classification
35	`google_ads_sitelinks_list`	Extension	Read	List sitelink extensions
36	`google_ads_sitelinks_create`	Extension	Write	Create a sitelink extension
37	`google_ads_sitelinks_remove`	Extension	Write	Remove a sitelink extension
38	`google_ads_callouts_list`	Extension	Read	List callout extensions
39	`google_ads_callouts_create`	Extension	Write	Create a callout extension
40	`google_ads_callouts_remove`	Extension	Write	Remove a callout extension
41	`google_ads_conversions_list`	Conversion	Read	List conversion actions
42	`google_ads_conversions_get`	Conversion	Read	Get conversion action details
43	`google_ads_conversions_performance`	Conversion	Read	Get conversion performance metrics
44	`google_ads_conversions_create`	Conversion	Write	Create a conversion action
45	`google_ads_conversions_update`	Conversion	Write	Update a conversion action
46	`google_ads_conversions_remove`	Conversion	Write	Remove a conversion action
47	`google_ads_conversions_tag`	Conversion	Read	Get conversion tracking tag snippet
48	`google_ads_recommendations_list`	Targeting	Read	List optimization recommendations
49	`google_ads_recommendations_apply`	Targeting	Write	Apply an optimization recommendation
50	`google_ads_device_targeting_get`	Targeting	Read	Get device targeting settings
51	`google_ads_device_targeting_set`	Targeting	Write	Set device targeting bid adjustments
52	`google_ads_bid_adjustments_get`	Targeting	Read	Get bid adjustment settings
53	`google_ads_bid_adjustments_update`	Targeting	Write	Update bid adjustments
54	`google_ads_location_targeting_list`	Targeting	Read	List location targeting criteria
55	`google_ads_location_targeting_update`	Targeting	Write	Update location targeting
56	`google_ads_schedule_targeting_list`	Targeting	Read	List ad schedule targeting
57	`google_ads_schedule_targeting_update`	Targeting	Write	Update ad schedule targeting
58	`google_ads_change_history_list`	Targeting	Read	List account change history
59	`google_ads_performance_report`	Analysis	Read	Performance report
60	`google_ads_performance_analyze`	Analysis	Read	Analyze performance trends and anomalies
61	`google_ads_cost_increase_investigate`	Analysis	Read	Investigate sudden cost increases
62	`google_ads_health_check_all`	Analysis	Read	Comprehensive account health check
63	`google_ads_ad_performance_compare`	Analysis	Read	Compare ad performance across variants
64	`google_ads_ad_performance_report`	Analysis	Read	Detailed ad-level performance report
65	`google_ads_network_performance_report`	Analysis	Read	Network-level performance breakdown
66	`google_ads_budget_efficiency`	Analysis	Read	Analyze budget utilization efficiency
67	`google_ads_budget_reallocation`	Analysis	Read	Suggest budget reallocation across campaigns
68	`google_ads_auction_insights_get`	Analysis	Read	Get auction insights (competitor analysis)
69	`google_ads_auction_insights_analyze`	Analysis	Read	Auction insights analysis
70	`google_ads_rsa_assets_analyze`	Analysis	Read	Analyze RSA asset performance
71	`google_ads_rsa_assets_audit`	Analysis	Read	Audit RSA assets for best practices
72	`google_ads_cpc_detect_trend`	Analysis	Read	Detect CPC trend direction
73	`google_ads_device_analyze`	Analysis	Read	Device performance analysis
74	`google_ads_btob_optimizations`	B2B	Read	Get B2B-specific optimization suggestions
75	`google_ads_landing_page_analyze`	Creative	Read	Analyze landing page relevance and quality
76	`google_ads_creative_research`	Creative	Read	Research competitive creative strategies
77	`google_ads_monitoring_delivery_goal`	Monitoring	Read	Monitor campaign delivery against goals
78	`google_ads_monitoring_cpa_goal`	Monitoring	Read	Monitor CPA against target goals
79	`google_ads_monitoring_cv_goal`	Monitoring	Read	Monitor conversion volume against goals
80	`google_ads_monitoring_zero_conversions`	Monitoring	Read	Detect campaigns with zero conversions
81	`google_ads_capture_screenshot`	Capture	Read	Capture a screenshot of a URL
82	`google_ads_assets_upload_image`	Asset	Write	Upload image as Google Ads asset
83	`google_ads_ads_create_display`	Ad	Write	Create an RDA (responsive display ad); image files are uploaded automatically
84	`google_ads_demographic_targeting_list`	Targeting	Read	List demographic criteria (age/gender/parental status/income)
85	`google_ads_audience_targeting_list`	Targeting	Read	List audience criteria (user lists, interests, custom/combined audiences)
86	`google_ads_image_assets_list`	Asset	Read	List image assets with names and dimensions

API Resources

campaigns

list -- List all campaigns in the account. Response includes channel_type ("SEARCH" | "DISPLAY" | ...) so you can tell search and display campaigns apart at a glance.
```
Required: customer_id (string)
Optional: status_filter (string: "ENABLED" | "PAUSED")
```
get -- Get detailed information about a specific campaign. Response includes channel_type.
```
Required: customer_id, campaign_id (string)
```

create -- Create a search or display campaign. Requires user confirmation.

Required: customer_id, name (string)
Optional: bidding_strategy (string: "MAXIMIZE_CLICKS" | "MAXIMIZE_CONVERSIONS" | "TARGET_CPA" | ...),
          budget_id (string),
          channel_type (string: "SEARCH" | "DISPLAY"; defaults to "SEARCH")

Note: For display campaigns, create the campaign with channel_type="DISPLAY", then create an ad group, then create the display ad via ads.create_display.

update -- Update campaign settings (name, bidding strategy). Requires user confirmation.

Required: customer_id, campaign_id (string)
Optional: name (string), bidding_strategy (string)

update_status -- Change campaign status. Requires user confirmation.

Required: customer_id, campaign_id, status (string: "ENABLED" | "PAUSED" | "REMOVED")

diagnose -- Comprehensive delivery diagnosis. Returns serving status, policy issues, budget constraints.
```
Required: customer_id, campaign_id (string)
```

ad_groups

list -- List ad groups, optionally filtered by campaign.

Required: customer_id (string)
Optional: campaign_id (string), status_filter (string)

create -- Create an ad group within a campaign. Requires user confirmation.

Required: customer_id, campaign_id, name (string)
Optional: cpc_bid_micros (integer, in micros: 1,000,000 = 1 currency unit)

update -- Update ad group settings. Requires user confirmation.
```
Required: customer_id, ad_group_id (string)
Optional: name (string), status (string: "ENABLED" | "PAUSED"), cpc_bid_micros (integer)
```
Note: cpc_bid_micros is only accepted when the parent campaign uses a manual bidding strategy (MANUAL_CPC, MANUAL_CPM, MANUAL_CPV, ENHANCED_CPC). If the campaign uses an automated strategy (MAXIMIZE_CLICKS, MAXIMIZE_CONVERSIONS, TARGET_CPA, TARGET_ROAS, etc.), the tool returns a clear validation error — manual bids at the ad group level are not supported under automated bidding.

list -- List ads, optionally filtered by ad group. Returns headlines and descriptions for both RSA and RDA. For RDAs, the response also includes long_headline, business_name, marketing_images, square_marketing_images, and logo_images (lists of asset resource names).
```
Required: customer_id (string)
Optional: ad_group_id (string), status_filter (string)
```

create -- Create a Responsive Search Ad (RSA). Requires user confirmation.

Required: customer_id, ad_group_id (string),
          headlines (array of strings, 3-15 items),
          descriptions (array of strings, 2-4 items)
Optional: final_url (string), path1 (string), path2 (string)

Note: For Responsive Display Ads, use ads.create_display instead.

update -- Update RSA ad content. Requires user confirmation.
```
Required: customer_id, ad_group_id, ad_id (string)
Optional: headlines (array of strings), descriptions (array of strings)
```
Note: This tool supports Responsive Search Ads (RSA) only. Calling it on a Responsive Display Ad (RDA) fails fast with a clear error — RDA text updates are not implemented; recreate the ad via ads.create_display instead.

update_status -- Change ad status. Requires user confirmation.

Required: customer_id, ad_group_id, ad_id, status (string: "ENABLED" | "PAUSED")

policy_details -- Get ad policy approval details and disapproval reasons.
```
Required: customer_id, ad_group_id, ad_id (string)
```

keywords

list -- List keywords with performance metrics.

Required: customer_id (string)
Optional: campaign_id (string), ad_group_id (string), status_filter (string)

add -- Add keywords to an ad group. Requires user confirmation.

Required: customer_id, ad_group_id (string),
          keywords (array of {text: string, match_type?: "BROAD" | "PHRASE" | "EXACT"})

Note: match_type defaults to BROAD if omitted.

remove -- Remove a keyword by criterion ID. Requires user confirmation.
```
Required: customer_id, ad_group_id, criterion_id (string)
```

suggest -- Get keyword suggestions from Keyword Planner.

Required: customer_id (string), seed_keywords (array of strings)
Optional: language_id (string, default: "1005" = Japanese),
          geo_id (string, default: "2392" = Japan)

diagnose -- Diagnose keyword quality scores and delivery status for a campaign.
```
Required: customer_id, campaign_id (string)
```

pause -- Pause a keyword. Requires user confirmation.

Required: customer_id, ad_group_id, criterion_id (string)

audit -- Audit keyword performance and quality scores across a campaign.
```
Required: customer_id, campaign_id (string)
```
cross_adgroup_duplicates -- Find duplicate keywords across ad groups in a campaign.
```
Required: customer_id, campaign_id (string)
```

negative_keywords

list -- List campaign-level negative keywords.

Required: customer_id, campaign_id (string)

add -- Add negative keywords to a campaign. Requires user confirmation.

Required: customer_id, campaign_id (string),
          keywords (array of {text: string, match_type?: "BROAD" | "PHRASE" | "EXACT"})

remove -- Remove a negative keyword. Requires user confirmation.
```
Required: customer_id, campaign_id, criterion_id (string)
```

add_to_ad_group -- Add negative keywords to an ad group. Requires user confirmation.

Required: customer_id, ad_group_id (string),
          keywords (array of {text: string, match_type?: "BROAD" | "PHRASE" | "EXACT"})

suggest -- Suggest negative keywords based on search term analysis.
```
Required: customer_id, campaign_id (string)
```

budget

get -- Get the budget attached to a campaign, including its type. Returns id, name, daily_budget(_micros), total_budget / total_amount_micros (null unless a CUSTOM_PERIOD total budget), period (DAILY / CUSTOM_PERIOD), delivery_method, status, reference_count.
```
Required: customer_id, campaign_id (string)
```
update -- Update the daily and/or total budget amount. Requires user confirmation. Always show current vs. new amount. The period is immutable -- total amounts only apply to CUSTOM_PERIOD budgets.
```
Required: customer_id, budget_id (string), and one of amount / amount_micros / total_amount / total_amount_micros
```
create -- Create a new campaign budget. Requires user confirmation. Pass period=CUSTOM_PERIOD with total_amount(_micros) for a campaign-lifetime total budget (immutable after creation); otherwise supply the daily amount.
```
Required: customer_id, name (string), and one of amount / total_amount / total_amount_micros
Optional: period (DAILY | CUSTOM_PERIOD)
```

accounts

list -- List all accessible Google Ads accounts under the manager account.
```
Required: (none)
```

search_terms

report -- Get search terms report showing actual queries that triggered ads.

Required: customer_id (string)
Optional: campaign_id (string), ad_group_id (string), period (string, default: "LAST_30_DAYS")

review -- Multi-rule review of search terms with add/exclude recommendations.

Required: customer_id, campaign_id (string)
Optional: period (string, default: "LAST_7_DAYS"), target_cpa (number)

analyze -- Analyze search terms with intent classification and clustering.
```
Required: customer_id, campaign_id (string)
```

sitelinks

list -- List sitelink extensions for a campaign.
```
Required: customer_id, campaign_id (string)
```

create -- Create a sitelink extension. Requires user confirmation.

Required: customer_id, campaign_id, link_text, final_url (string)

remove -- Remove a sitelink extension. Requires user confirmation.
```
Required: customer_id, campaign_id, extension_id (string)
```

callouts

list -- List callout extensions for a campaign.
```
Required: customer_id, campaign_id (string)
```
create -- Create a callout extension. Requires user confirmation.
```
Required: customer_id, campaign_id, callout_text (string)
```
remove -- Remove a callout extension. Requires user confirmation.
```
Required: customer_id, campaign_id, extension_id (string)
```

conversions

list -- List all conversion actions in the account.
```
Required: customer_id (string)
```

get -- Get details of a specific conversion action.

Required: customer_id, conversion_action_id (string)

performance -- Get conversion performance metrics across campaigns.
```
Required: customer_id (string)
```
create -- Create a new conversion action. Requires user confirmation.
```
Required: customer_id, name, type (string)
```
update -- Update a conversion action. Requires user confirmation.
```
Required: customer_id, conversion_action_id (string)
```
remove -- Remove a conversion action. Requires user confirmation.
```
Required: customer_id, conversion_action_id (string)
```
tag -- Get the conversion tracking tag (JavaScript snippet) for a conversion action.
```
Required: customer_id, conversion_action_id (string)
```

targeting

recommendations.list -- List optimization recommendations from Google.
```
Required: customer_id (string)
```
recommendations.apply -- Apply an optimization recommendation. Requires user confirmation.
```
Required: customer_id, recommendation_id (string)
```
device_targeting.get -- Get device targeting bid adjustment settings.
```
Required: customer_id, campaign_id (string)
```
device_targeting.set -- Set device targeting bid adjustments. Requires user confirmation.
```
Required: customer_id, campaign_id, device_type, bid_modifier (string/number)
```
bid_adjustments.get -- Get bid adjustment settings for a campaign.
```
Required: customer_id, campaign_id (string)
```
bid_adjustments.update -- Update bid adjustments. Requires user confirmation.
```
Required: customer_id, campaign_id (string)
```
location_targeting.list -- List location targeting criteria.
```
Required: customer_id, campaign_id (string)
```
location_targeting.update -- Update location targeting settings. Requires user confirmation.
```
Required: customer_id, campaign_id (string)
```
schedule_targeting.list -- List ad schedule targeting rules.
```
Required: customer_id, campaign_id (string)
```
schedule_targeting.update -- Update ad schedule targeting. Requires user confirmation.
```
Required: customer_id, campaign_id (string)
```
change_history.list -- List account change history (who changed what, when).
```
Required: customer_id (string)
```
demographic_targeting.list -- List explicit demographic criteria (age range, gender, parental status, income). Excluded segments have negative=true; segments with no explicit criterion are targeted by default and not returned.
```
Required: customer_id (string)
Optional: ad_group_id (string), campaign_id (string)
```
audience_targeting.list -- List audience-type criteria (user interests, user lists, custom/combined audiences). value is the criterion's resource name.
```
Required: customer_id (string)
Optional: ad_group_id (string), campaign_id (string)
```

analysis & reporting

performance.report -- Get performance metrics aggregated by campaign.
```
Required: customer_id (string)
Optional: campaign_id (string), period (string, default: "LAST_30_DAYS")
```
Period options: TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, THIS_MONTH, LAST_MONTH
performance.analyze -- Analyze performance trends, detect anomalies, and surface insights.
```
Required: customer_id (string)
```
cost_increase.investigate -- Investigate sudden cost increases and identify root causes.
```
Required: customer_id, campaign_id (string)
```
health_check.all -- Run a comprehensive account health check across all campaigns.
```
Required: customer_id (string)
```
ad_performance.compare -- Compare ad performance across variants in an ad group.
```
Required: customer_id, ad_group_id (string)
```
ad_performance.report -- Get detailed ad-level performance report.
```
Required: customer_id (string)
```
network_performance.report -- Get performance breakdown by network (Search, Display, etc.).
```
Required: customer_id (string)
```
budget.efficiency -- Analyze budget utilization efficiency across campaigns.
```
Required: customer_id (string)
```
budget.reallocation -- Suggest budget reallocation across campaigns based on performance.
```
Required: customer_id (string)
```
auction_insights.get -- Get auction insights with competitor impression share and overlap rate.
```
Required: customer_id, campaign_id (string)
```
auction_insights.analyze -- Analyze auction insights: impression share, overlap rate, top-of-page rate, and competitor domains.
```
Required: customer_id, campaign_id (string)
Optional: period (string, default: "LAST_30_DAYS")
```
rsa_assets.analyze -- Analyze RSA asset (headline/description) performance ratings.
```
Required: customer_id, ad_group_id (string)
```
rsa_assets.audit -- Audit RSA assets for best practices and coverage gaps.
```
Required: customer_id, campaign_id (string)
```
cpc.detect_trend -- Detect CPC trend direction (rising / stable / falling) using linear regression on daily CPC data. Also detects sudden spikes and week-over-week changes.
```
Required: customer_id, campaign_id (string)
Optional: period (string, default: "LAST_30_DAYS")
```
device.analyze -- Compare performance across devices (Desktop / Mobile / Tablet). Shows CPA, CVR, CTR per device, detects CPA gaps, and identifies wasted spend on zero-conversion devices.
```
Required: customer_id, campaign_id (string)
Optional: period (string, default: "LAST_30_DAYS")
```

b2b

btob.optimizations -- Get B2B-specific optimization suggestions (lead quality, audience targeting, etc.).
```
Required: customer_id (string)
```

creative

landing_page.analyze -- Analyze landing page relevance and quality signals for a campaign.
```
Required: customer_id, campaign_id (string)
```
creative.research -- Research competitive creative strategies and ad copy patterns.
```
Required: customer_id (string)
```

monitoring

monitoring.delivery_goal -- Monitor campaign delivery pace against goals.
```
Required: customer_id, campaign_id (string)
```
monitoring.cpa_goal -- Monitor CPA against target goals and alert on deviations.
```
Required: customer_id, campaign_id (string)
```
monitoring.cv_goal -- Monitor conversion volume against goals.
```
Required: customer_id, campaign_id (string)
```
monitoring.zero_conversions -- Detect campaigns with zero conversions in recent periods.
```
Required: customer_id (string)
```

capture

capture.screenshot -- Capture a screenshot of a URL (useful for landing page audits).
```
Required: url (string)
```

assets

assets.upload_image -- Upload a local image file as a Google Ads asset.
```
Required: customer_id, file_path (string)
```

image_assets.list -- List image assets with names, dimensions, and serving URLs.

Required: customer_id (string)
Optional: limit (integer 1-1000, default: 100)

Common Workflows

1. Performance Check

A typical daily performance check flow:

Step 1: List campaigns to identify active ones
  -> google_ads_campaigns_list {customer_id, status_filter: "ENABLED"}

Step 2: Get overall performance report
  -> google_ads_performance_report {customer_id, period: "LAST_7_DAYS"}

Step 3: Run comprehensive health check
  -> google_ads_health_check_all {customer_id}

Step 4: For underperforming campaigns, run diagnostics
  -> google_ads_campaigns_diagnose {customer_id, campaign_id}

Step 5: Check keyword quality scores
  -> google_ads_keywords_diagnose {customer_id, campaign_id}

Step 6: Analyze device performance for CPA gaps
  -> google_ads_device_analyze {customer_id, campaign_id}

Step 7: Monitor conversion goals
  -> google_ads_monitoring_zero_conversions {customer_id}

2. Negative Keyword Addition

When cleaning up wasted spend from irrelevant search terms:

Step 1: Get search terms report
  -> google_ads_search_terms_report {customer_id, campaign_id, period: "LAST_30_DAYS"}

Step 2: Or use automated review for suggestions
  -> google_ads_search_terms_review {customer_id, campaign_id, target_cpa: 3000}

Step 3: Analyze search terms with intent classification
  -> google_ads_search_terms_analyze {customer_id, campaign_id}

Step 4: Get AI-suggested negative keywords
  -> google_ads_negative_keywords_suggest {customer_id, campaign_id}

Step 5: Review current negative keywords to avoid duplicates
  -> google_ads_negative_keywords_list {customer_id, campaign_id}

Step 6: Add negative keywords (CONFIRM WITH USER)
  -> google_ads_negative_keywords_add {customer_id, campaign_id, keywords: [...]}

3. New Campaign Creation

Full campaign setup from scratch:

Step 1: Create a budget
  -> google_ads_budget_create {customer_id, name, amount}

Step 2: Create the campaign (omit channel_type or set "SEARCH" for a search campaign)
  -> google_ads_campaigns_create {customer_id, name, bidding_strategy, budget_id}

Step 3: Create ad groups
  -> google_ads_ad_groups_create {customer_id, campaign_id, name}

Step 4: Add keywords to each ad group
  -> google_ads_keywords_add {customer_id, ad_group_id, keywords: [...]}

Step 5: Create RSA ads for each ad group
  -> google_ads_ads_create {customer_id, ad_group_id, headlines: [...], descriptions: [...], final_url}

Step 6: Add campaign-level negative keywords
  -> google_ads_negative_keywords_add {customer_id, campaign_id, keywords: [...]}

Step 7: Add sitelink extensions
  -> google_ads_sitelinks_create {customer_id, campaign_id, link_text, final_url}

Step 8: Add callout extensions
  -> google_ads_callouts_create {customer_id, campaign_id, callout_text}

Step 9: Set up conversion tracking
  -> google_ads_conversions_create {customer_id, name, type}

Step 10: Enable the campaign
  -> google_ads_campaigns_update_status {customer_id, campaign_id, status: "ENABLED"}

3b. New Display Campaign + Responsive Display Ad

Display campaigns use a different channel_type and require image assets. mureo uploads the local image files automatically before creating the ad.

Step 1: Create a budget
  -> google_ads_budget_create {customer_id, name, amount}

Step 2: Create a DISPLAY campaign
  -> google_ads_campaigns_create {
       customer_id, name, channel_type: "DISPLAY",
       bidding_strategy: "MAXIMIZE_CONVERSIONS", budget_id
     }

Step 3: Create an ad group inside the display campaign
  -> google_ads_ad_groups_create {customer_id, campaign_id, name}

Step 4: Create the responsive display ad
  -> google_ads_ads_create_display {
       customer_id, ad_group_id,
       headlines: [...], long_headline, descriptions: [...],
       business_name,
       marketing_image_paths: ["/path/to/marketing-1200x628.jpg"],
       square_marketing_image_paths: ["/path/to/square-1200x1200.jpg"],
       logo_image_paths: ["/path/to/logo.png"],   # optional
       final_url
     }

Step 5: Enable the campaign
  -> google_ads_campaigns_update_status {customer_id, campaign_id, status: "ENABLED"}

Constraints (RDA):

Headlines: 1-5, each ≤30 display width
Long headline: required, ≤90 display width
Descriptions: 1-5, each ≤90 display width
Business name: required, ≤25 display width
Marketing images (1.91:1): 1-15, 3+ recommended for delivery quality
Square marketing images (1:1): 1-15, 3+ recommended
Logo images: optional, up to 5
The target ad group must belong to a DISPLAY campaign — mureo verifies this before any upload happens to avoid orphaned assets.
If image upload or ad creation fails partway through, an RDAUploadError is raised that includes the resource names of any orphaned uploaded assets so the agent can clean them up.

4. Budget Adjustment

Safe budget change workflow:

Step 1: Get current budget
  -> google_ads_budget_get {customer_id, campaign_id}

Step 2: Analyze budget efficiency
  -> google_ads_budget_efficiency {customer_id}

Step 3: Get reallocation suggestions
  -> google_ads_budget_reallocation {customer_id}

Step 4: Update budget (CONFIRM WITH USER)
  -> google_ads_budget_update {customer_id, budget_id, amount: 6000}

5. Delivery Troubleshooting

When a campaign is not getting impressions:

Step 1: Check campaign status and settings
  -> google_ads_campaigns_get {customer_id, campaign_id}

Step 2: Run comprehensive delivery diagnosis
  -> google_ads_campaigns_diagnose {customer_id, campaign_id}

Step 3: Check keyword quality and delivery status
  -> google_ads_keywords_diagnose {customer_id, campaign_id}

Step 4: Check ad policy details for disapprovals
  -> google_ads_ads_policy_details {customer_id, ad_group_id, ad_id}

Step 5: Check CPC trends (are bids competitive?)
  -> google_ads_cpc_detect_trend {customer_id, campaign_id}

Step 6: Analyze auction insights (competitor landscape)
  -> google_ads_auction_insights_analyze {customer_id, campaign_id}

Step 7: Monitor delivery pace
  -> google_ads_monitoring_delivery_goal {customer_id, campaign_id}

Step 8: Review budget constraints
  -> google_ads_budget_get {customer_id, campaign_id}

6. Competitive Analysis

Understanding the competitive landscape:

Step 1: Analyze auction insights
  -> google_ads_auction_insights_analyze {customer_id, campaign_id, period: "LAST_30_DAYS"}

Step 2: Get auction insights data
  -> google_ads_auction_insights_get {customer_id, campaign_id}

Step 3: Detect CPC trend (rising CPC may indicate increased competition)
  -> google_ads_cpc_detect_trend {customer_id, campaign_id}

Step 4: Investigate cost increases
  -> google_ads_cost_increase_investigate {customer_id, campaign_id}

Step 5: Research competitive creative strategies
  -> google_ads_creative_research {customer_id}

Step 6: Get keyword suggestions to find new opportunities
  -> google_ads_keywords_suggest {customer_id, seed_keywords: ["..."]}

7. RSA Optimization

Improving responsive search ad performance:

Step 1: Analyze RSA asset performance
  -> google_ads_rsa_assets_analyze {customer_id, campaign_id}

Step 2: Audit RSA assets for best practices
  -> google_ads_rsa_assets_audit {customer_id, campaign_id}

Step 3: Compare ad variants
  -> google_ads_ad_performance_compare {customer_id, ad_group_id}

Step 4: Check landing page relevance
  -> google_ads_landing_page_analyze {customer_id, url}

8. Account Audit

Comprehensive account review:

Step 1: List all accessible accounts
  -> google_ads_accounts_list {}

Step 2: Run health check
  -> google_ads_health_check_all {customer_id}

Step 3: Audit keywords
  -> google_ads_keywords_audit {customer_id, campaign_id}

Step 4: Find duplicate keywords
  -> google_ads_keywords_cross_adgroup_duplicates {customer_id, campaign_id}

Step 5: Review change history
  -> google_ads_change_history_list {customer_id}

Step 6: Check optimization recommendations
  -> google_ads_recommendations_list {customer_id}

Important Notes

Micros: Some values (e.g., cpc_bid_micros) are in micros where 1,000,000 = 1 currency unit. For example, 500,000 micros = 0.50 in the account currency.
Period values: Use Google Ads date range constants like LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH.
customer_id: Always a 10-digit string without dashes (e.g., "1234567890", not "123-456-7890").
RSA limits: Headlines 3-15, descriptions 2-4. Maximum 3 enabled RSA ads per ad group.
Write operations: All tools that create, update, or remove resources require user confirmation before execution.