google-ads-clilisted
Install: claude install-skill almoretti/martech-ai-skills-and-tools
# Google Ads CLI Skill
You have access to `google-ads-cli`, a read-only CLI for the Google Ads API (v23). Use it to query ad accounts, pull performance stats, and run custom GAQL queries.
## Quick start
```bash
# Check if the CLI is available
google-ads-cli --help
# List accessible accounts
google-ads-cli customers
```
If the CLI is not installed, install it:
```bash
npm install -g google-ads-cli
```
## Authentication
The CLI uses OAuth2 user credentials (Google Ads API does not support service accounts). Credentials are stored in `~/.config/google-ads-cli/credentials.json`.
Before running any command, verify credentials are configured by running `google-ads-cli customers`. If it fails with a credentials error, ask the user to set up authentication:
```bash
google-ads-cli auth login \
--developer-token=xxx \
--client-id=xxx \
--client-secret=xxx
```
How to get the values:
1. **developer_token**: Sign in to a Google Ads **manager account** and open the [API Center](https://ads.google.com/aw/apicenter). Copy the developer token.
2. **client_id & client_secret**: Go to [Google Cloud Console > Credentials](https://console.cloud.google.com/apis/credentials), create an **OAuth client ID** (Desktop app type). Make sure the [Google Ads API](https://console.cloud.google.com/apis/library/googleads.googleapis.com) is enabled.
This opens a browser for authorization. Make sure the user signs in with a Google account that has access to the Google Ads data they want to us