- name
- adagent-google-ads
- description
- Manage Google Ads campaigns — create, monitor, pause, and optimize. Use when the user says 'Google Ads', 'Google 廣告', 'keyword research', 'search ads', 'create Google campaign', 'ad performance', or wants to manage their Google Ads account.
- version
- 1.0.0
- metadata
- openclaw
- emoji
- 🔍
- homepage
- https://adagent.10xboost.org
- requires
- config
Google Ads Agent
Create, manage, and optimize Google Search Ads campaigns directly from Claude Code. Powered by AdAgent.
Security & Data Handling
- MCP link is a credential: Your MCP Server URL (
https://adagent.10xboost.org/api/mcp/google-ads/{user_id}/mcp) contains your user ID for credential lookup. Treat it like a password — do not share it publicly. - Token scope: The service uses your Google Ads OAuth refresh token to access your ad accounts. It can create campaigns, modify budgets, enable/pause campaigns, and read performance data.
- Token storage: Your Google Ads OAuth tokens are encrypted with Fernet (AES-128-CBC + HMAC) and stored in MongoDB. They are never exposed in API responses.
- Multi-tenant isolation: Each request is scoped to your user credentials via ASGI middleware. You can only access your own ad accounts.
- No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
- Third-party service: This skill relies on AdAgent, an AI-powered ad management platform.
Prerequisites
- Sign up at adagent.10xboost.org with Google
- Connect Google Ads — authorize AdAgent to access your Google Ads account
- Get your MCP link: Copy your Google Ads MCP Server URL from the dashboard
- Add to Claude: Paste the MCP link as a Connector — no install, no API key needed
Available Tools
| Tool | Description |
|---|
list_accessible_customers | List all accessible Google Ads accounts (MCC + sub-accounts) |
get_customer_info | Get account details (name, type, etc.) |
list_campaigns | List all campaigns (active + paused) |
create_campaign | Create a complete Search Ads campaign (budget, ad group, keywords, ads) |
get_performance | Get all campaigns performance (impressions, clicks, cost, CTR, CPC) |
get_campaign_performance | Get daily performance for a specific campaign |
keyword_research | Research keywords — get suggestions and search volume |
enable_campaign | Enable a paused campaign |
pause_campaign | Pause an active campaign |
Workflow
Step 1: List Accounts
Call list_accessible_customers to see all available Google Ads accounts. Then get_customer_info for details.
Step 2: Determine What the User Wants
| User Request | Tool to Use |
|---|
| "Show my Google Ads accounts" | list_accessible_customers |
| "List my campaigns" | list_campaigns |
| "How are my ads doing?" | get_performance |
| "Campaign X performance" | get_campaign_performance |
| "Research keywords for ..." | keyword_research |
| "Create a search ad for ..." | create_campaign |
| "Pause campaign X" | pause_campaign |
| "Enable campaign X" | enable_campaign |
Step 3: Execute
Check Performance
get_performance(
start_date="2026-03-01",
end_date="2026-03-30"
)
Keyword Research
keyword_research(
keywords=["AI agent", "automation tool"],
location_ids=["2158"], // 2158=Taiwan, 2840=US
language_id="1000" // 1000=Chinese
)
Create Campaign
create_campaign(
name="Spring Sale 2026",
daily_budget_usd=10.0,
keywords=["AI agent", "automation tool", "AI assistant"],
ad_headlines=["Build Your AI Agent", "Automate Your Work", "Try AI Agent Free"],
ad_descriptions=["Create powerful AI agents in minutes.", "Boost productivity with AI automation."],
final_url="https://example.com",
location_ids=["2158"],
language_id="1000"
)
Important: Campaigns are created in PAUSED state. Use enable_campaign to activate.
Step 4: Present Results
- Performance: Show key metrics in a table (impressions, clicks, CTR, CPC, cost, conversions)
- Keyword research: Show keywords ranked by search volume with competition level
- Campaign creation: Confirm campaign ID and remind user it's paused until enabled
Common Location IDs
| Location | ID |
|---|
| Taiwan | 2158 |
| United States | 2840 |
| Japan | 2392 |
| Hong Kong | 2344 |
| Singapore | 2702 |
Common Language IDs
| Language | ID |
|---|
| Chinese (Traditional) | 1018 |
| Chinese (Simplified) | 1017 |
| English | 1000 |
| Japanese | 1005 |
Error Handling
| Error | Solution |
|---|
| Account not found | Run list_accessible_customers to get valid IDs |
| Permission denied | Reconnect Google Ads at adagent.10xboost.org |
| Budget too low | Google Ads has minimum budget requirements per market |
| Campaign creation failed | Verify all required fields (headlines >= 3, descriptions >= 2) |
| Token expired | Reconnect Google Ads at adagent.10xboost.org (refresh token is long-lived) |
Documentation
Product website: adagent.10xboost.org
