Skip to content

danielpopamd/google-ads-assistant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Google Ads Assistant

Connect your AI assistant to Google Ads through the AdPlug Marketing Control Plane. This is a thin bundle: it points your agent at AdPlug's hosted, multi-tenant MCP server and ships five operator skills. All 16 Google Ads tools run server-side at AdPlug.

What you get (16 tools)

  • Reporting: account, campaign, conversion, and daily-trend performance across every account in one call, plus search-term reports.
  • Research: keyword ideas, shared negative-list contents.
  • Raw GAQL: google_ads_query with built-in syntax and reporting-view docs.
  • Safe edits: preview-then-execute for status changes and mutations, plus preview-then-execute for negative keywords.
  • Status: adplug_get_status for connection state and next steps.

Bundled skills

Five short playbooks load with the plugin and drive the tools above:

  • google-ads-optimise: entry-point routine that ties the tools together (status check, performance pull, alerts, pacing, prioritized actions) and defines the preview-then-confirm-then-execute mutation protocol every change follows.
  • google-ads-audit: full account audit into a prioritized markdown report.
  • google-ads-sqr: search-term review: classify terms, cut wasted spend, apply negatives, surface converting terms worth adding as keywords.
  • google-ads-ad-copy: generate RSAs and extensions within the character limits, then apply them.
  • google-ads-structure-builder: build a new Search campaign structure from keyword research through campaigns, ad groups, match types, and negatives.

Install (OpenClaw)

openclaw plugins install clawhub:google-ads-assistant

Getting started (free, one-time)

To read or optimise your Google Ads data you need a free AdPlug account. AdPlug is the secure bridge between your AI assistant and the Google Ads API.

  1. Install this plugin (above). It adds the Google Ads Assistant MCP server.
  2. Create your free AdPlug account. The first time you use the plugin, your client opens an AdPlug sign-in page. Sign up, or sign in if you already have an account. That signup authenticates the connection over OAuth, with no API keys or tokens to paste.
  3. Connect Google Ads (free). In the AdPlug dashboard at https://adplug.app/dashboard/connections, click "Connect Google Ads" and authorize.

After that, just ask your assistant about your Google Ads and the tools work. Until an account is connected they return a clear "connect first" message. Each user authenticates individually and sees only their own accounts.

Endpoint

https://api.adplug.app/mcp/google-ads   (Streamable HTTP, OAuth 2.1)

The same endpoint also accepts a personal URL token if you prefer not to use OAuth: https://api.adplug.app/mcp/google-ads/<your-mcp-token> (find the token on your AdPlug dashboard). OAuth is recommended.

Pricing

AdPlug has a free tier for reads and paid tiers for edits and higher volume. See https://adplug.app for current plans and terms.

Links

About

Google Ads Assistant: connect your AI assistant to Google Ads via AdPlug (remote MCP over OAuth). ClawHub plugin.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors