google-ads

Automate Google Ads data reads and campaign mutations via the official API.

Updated Feb 17, 2026

Search Tags:#reporting #google-ads #campaign-management #ads-api #gaql #keyword-planning

Ready to run

npx skills add https://github.com/gnestor/claude-workflow-plugin --skill google-ads-gnestor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: google-ads
Source: https://github.com/gnestor/claude-workflow-plugin/tree/main/.claude/skills/google/google-ads
Command: npx skills add https://github.com/gnestor/claude-workflow-plugin --skill google-ads-gnestor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @std/dotenv/load, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Google Ads data and campaign operations are often locked behind the API, requiring custom integrations for reporting and control. This Skill provides real-time access to Ads data and enables programmatic changes to campaigns, ROAS targets, budgets, and statuses across campaigns, ad groups, keywords, and Shopping data.

Core Features & Use Cases

Real-time reads of campaign, ad_group, keyword, and shopping performance through the Google Ads API.
Mutations to update budgets, target ROAS, campaign/ad_group/keyword statuses, and negative keywords, with safety checks.
Keyword planning helpers (idea generation and historical metrics) to inform optimization decisions.

Quick Start

Run a simple read query to fetch campaigns for the last 30 days, then adjust a budget with an update-budget operation.

Frequently Asked Questions about google-ads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I automate Google Ads reporting and campaign management via the API?▼

Google Ads campaign management and reporting automation uses the official API to fetch real-time performance data and execute mutations for budgets, ROAS targets, and statuses. It requires Google Ads API credentials, a developer token, and OAuth authentication to function.

Can I update campaign budgets and target ROAS programmatically?▼

Programmatic updates to campaign budgets and target ROAS are supported through API mutations. The workflow applies safety checks and a confirmation process before executing write operations on campaigns, ad groups, and keywords.

Do I need a developer token to access Google Ads data?▼

A developer token and OAuth authentication are required to access Google Ads data. These credentials authorize the API connection needed to read real-time campaign metrics and perform campaign management operations.

What's the best way to fetch real-time performance data for ad groups and keywords?▼

Real-time performance data for ad groups and keywords is fetched using the Google Ads API. The system executes read queries to retrieve current metrics across campaigns, ad groups, keywords, and shopping data for immediate analysis.

Can I generate keyword ideas and historical metrics for campaign optimization?▼

Keyword idea generation and historical metrics retrieval are supported through built-in keyword planning helpers. These functions analyze search data to inform budget decisions and optimize overall campaign performance.

Are there safety checks applied when changing negative keywords or campaign statuses?▼

Safety checks and a confirmation workflow are applied when changing negative keywords or campaign statuses. These precautions ensure write operations are verified before mutating live campaign data through the API.