К основному содержанию
скилл CX Codex

google-ads · acedatacloud — скилл для Claude Code: что делает и как установить

Скилл для Claude Code запрашивает через Google Ads API кампании, группы объявлений, ключевые слова и расходы. Получает данные о кликах и конверсиях для отчётов.

Apache-2.0 177 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill google-ads -a claude-code
Открыть на GitHub

Что делает google-ads

Скилл обращается к Google Ads API через curl и jq, получает доступные аккаунты и выполняет запросы GAQL методом searchStream. Он умеет читать данные кампаний, групп объявлений, ключевых слов и аккаунта, включая расходы, клики и конверсии. Результаты потокового ответа нужно разворачивать из .results[], а стоимость в metrics.cost_micros переводится делением на 1e6.

Для запросов нужны OAuth-токен пользователя в GOOGLE_ADS_TOKEN и токен разработчика в GOOGLE_ADS_DEVELOPER_TOKEN. Для обращений через управляющий аккаунт добавляется login-customer-id; при прямом доступе этот заголовок не нужен. Идентификатор клиента в URL и заголовках пишется только цифрами. Без GOOGLE_ADS_DEVELOPER_TOKEN коннектор не запускает запросы, потому что API вернёт ошибку авторизации.

Какие задачи решает

  • получить доступные аккаунты Google Ads
  • собрать расходы кампаний за период
  • сравнить клики и конверсии по кампаниям
  • выгрузить данные групп объявлений и ключевых слов
  • разобраться с доступом через управляющий аккаунт

Примеры запросов агенту

  • Покажи доступные мне аккаунты Google Ads и их идентификаторы.
  • Собери расходы, клики и конверсии по кампаниям за последние 30 дней.
  • Проверь данные кампании для клиента 1234567890 через управляющий аккаунт.

Как установить google-ads

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill google-ads -a claude-code

2Вручную: положить файлы

~/.claude/skills/google-ads/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/google-ads/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о google-ads

Как установить google-ads в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill google-ads -a claude-code, затем проверьте файл ~/.claude/skills/google-ads/SKILL.md.

Что делает google-ads?

Скилл читает Google Ads через API и GAQL searchStream: получает доступные аккаунты, данные кампаний, групп объявлений, ключевых слов, расходов, кликов и конверсий.

Что нужно для работы google-ads через Google Ads API?

Нужны GOOGLE_ADS_TOKEN с OAuth-доступом и GOOGLE_ADS_DEVELOPER_TOKEN. Для запросов в контексте MCC добавляется GOOGLE_ADS_LOGIN_CUSTOMER_ID, а идентификатор клиента передаётся цифрами без дефисов.

Исходный текст

SKILL.md · Apache-2.0
---
name: google-ads
description: Query Google Ads campaigns, ad groups, keywords and spend via the Google Ads API (GAQL searchStream). Use when the user mentions Google Ads, ad campaigns, ad spend / cost, impressions / clicks / conversions on ads, or campaign performance.
when_to_use: |
  Trigger when the user wants Google Ads reporting — list accessible
  customers, campaign / ad-group / keyword performance, spend and
  conversions. Read via GAQL. Needs the OAuth token PLUS a platform
  developer token; if the developer token is absent the connector
  isn't fully provisioned yet — tell the user.
connections: [google/ads]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

Query the **Google Ads API** via `curl + jq`. Two credentials plus one context
header:

- `$GOOGLE_ADS_TOKEN` — the user's OAuth bearer (`adwords` scope) →
  `Authorization: Bearer $GOOGLE_ADS_TOKEN`
- `$GOOGLE_ADS_DEVELOPER_TOKEN` — the platform's developer token (injected
  server-side) → header `developer-token: $GOOGLE_ADS_DEVELOPER_TOKEN`
- `login-customer-id` — **only for manager (MCC) scoped calls**: the manager id
  the request runs under, or `$GOOGLE_ADS_LOGIN_CUSTOMER_ID` if set (digits
  only, no dashes). Not needed by `customers:listAccessibleCustomers`.

> **API version:** the base is `https://googleads.googleapis.com/<vNN>`. Google
> ships a new `vNN` every ~4 months and retires old ones, so a hardcoded version
> eventually stops working. The example uses `v25` (supported as of 2026-07). If
> **every** call 404s, the version is unavailable — either retired or not yet
> released. Probe `customers:listAccessibleCustomers`: a supported version
> answers 401/200, an unavailable one 404. Step **down** one version at a time
> from the example, and check Google's supported-versions table before assuming
> a newer `vNN` exists.

If `$GOOGLE_ADS_DEVELOPER_TOKEN` is empty, the connector isn't fully provisioned —
say so rather than calling the API (it would 401/DEVELOPER_TOKEN_NOT_APPROVED).

```bash
VER="v25"; BASE="https://googleads.googleapis.com/$VER"
AUTH="Authorization: Bearer $GOOGLE_ADS_TOKEN"; DEV="developer-token: $GOOGLE_ADS_DEVELOPER_TOKEN"
# Customers the OAuth user can access (ids are returned as customers/<id>)
curl -sS -H "$AUTH" -H "$DEV" "$BASE/customers:listAccessibleCustomers" | jq '.resourceNames'
```

## Report with GAQL (searchStream)

```bash
CID="1234567890"   # target customer id, digits only
# Manager (MCC) access → send login-customer-id; direct access → drop the header.
# Array, not a plain string: the header value contains a space and would split.
LOGIN=(); [ -n "$GOOGLE_ADS_LOGIN_CUSTOMER_ID" ] && LOGIN=(-H "login-customer-id: $GOOGLE_ADS_LOGIN_CUSTOMER_ID")
curl -sS -H "$AUTH" -H "$DEV" "${LOGIN[@]}" \
  -H "Content-Type: application/json" -d '{
  "query":"SELECT campaign.name, metrics.cost_micros, metrics.clicks, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC"
}' "$BASE/customers/$CID/googleAds:searchStream" \
  | jq '.[].results[]? | {campaign: .campaign.name, cost_usd: (.metrics.costMicros|tonumber/1e6), clicks: .metrics.clicks, conv: .metrics.conversions}'
```

GAQL resources: `campaign`, `ad_group`, `ad_group_criterion` (keywords),
`customer`. Cost is `metrics.cost_micros` (÷ 1,000,000 = account currency).

## Gotchas

- **A 404 on *every* endpoint points at `VER`, not at credentials** — the
  version is retired or unreleased. A 404 on a *single* call is about that call:
  a missing resource (bad customer id) or a wrong path. Sanity-check the version
  with `customers:listAccessibleCustomers` before debugging auth.
- **Two credentials plus a context header.** `developer-token` is required on
  every call; `login-customer-id` is only needed when acting under a manager
  (MCC) account — `customers:listAccessibleCustomers` works without it. Omitting
  it on a manager-scoped call is the #1 cause of 401/403 here.
- Customer ids are **digits only** in URLs/headers (strip the dashes from
  `123-456-7890`).
- `searchStream` returns an array of chunks each with `.results[]` — flatten with
  `.[].results[]?`.
- Cost is in **micros** of the account currency; divide by 1e6.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Маркетинг и контент» →

Сначала — google-ads от других авторов.

google-ads arnabbagxd Скилл помогает планировать, собирать и оптимизировать рекламные кампании в Google Ads. Пригодится при настройке поисковой рекламы, PMax, шопинга и трекинга конверсий. CX Codex +1 1 900установок google-ads kostja94 Скилл помогает спланировать структуру кампаний в Google Ads, собрать минус-слова и настроить ставки. Пригодится при запуске рекламы для проверки спроса или масштабирования продаж. CX Codex +1 1 700установок google-ads OpenClaudia Готовит структуру Google Ads и тексты объявлений для поиска, КМС и Performance Max. Собирает кампании, перерабатывает рекламные материалы. CX Codex +1 576установок google-ads membrane Управляет рекламными кампаниями, бюджетами и объявлениями в Google Ads через вызовы Membrane CLI прямо из чата с агентом. CX Codex +1 214установок google-ads nowork-studio Помогает управлять Google Ads: кампаниями, ключевыми словами, ставками и бюджетами. Запускается при запросах о CPA, ROAS, расходах на рекламу или настройках кампаний. CX Codex +1 ★ 4 288звёзд репо Google Ads MCP scalably-io Подключает Google Ads API к ассистенту в режиме чтения: выполняет GAQL-запросы, собирает рекомендации и подбирает ключевые слова. CX Codex +1 pp-google-ads mvanhorn Скилл pp-google-ads для Claude Code, Cursor и других ИИ-редакторов, который подключает Google Ads API. Тянет отчёты через GAQL, управляет кампаниями, бюджетами, конверсиями и аудиториями. CX Codex +1 263установок ads-google AgriciDaniel Скилл ads-google для Claude Code, Codex, Cursor и других агентов проводит аудит Google Ads: кампании Search, Shopping, Performance Max, Demand Gen, ставки, бюджеты, минус-слова, конверсии. CX Codex +1 4 900установок google-ads-audit Cogny AI Скилл google-ads-audit проверяет поисковые кампании и расход бюджета в Google Ads через MCP-шлюз Cogny. Пригодится при поиске нецелевого трафика и скликивания. CX Codex +1 ★ 116звёзд репо Google Ads get-mcp-ads Подключает аккаунт Google Ads к ИИ-ассистенту: 35 инструментов чтения и 13 инструментов записи, которые по умолчанию выключены. CX Codex +1 ★ 1звёзд репо google-ads-manager claude-office-skills Скилл google-ads-manager помогает планировать кампании в Google Ads, собирать семантику, генерировать адаптивные объявления RSA и готовить отчёты. Пригодится при настройке платного поиска. CX Codex +1 6 500установок

Из того же набора67

Весь набор →
juejin Скилл ведёт ваш аккаунт на Juejin через собственные cookie: показывает статьи с просмотрами и лайками, открывает одну по id и публикует Markdown-черновик. CX Codex +1 179установок microsoft-teams Даёт агенту чтение и отправку сообщений в чатах Microsoft Teams через Microsoft Graph v1.0: список чатов, последние сообщения, отправка с подтверждением. CX Codex +1 178установок tiktok Публикует готовые видео в профиль TikTok или загружает их в черновики через API v2. Скилл запрашивает подтверждение настроек приватности перед каждой отправкой. CX Codex +1 178установок google-analytics Скилл для Claude и других агентов: тянет отчёты Google Analytics 4 и список свойств через Analytics API, работая из оболочки на curl и jq. CX Codex +1 177установок vercel Скилл проверяет сборки, читает логи ошибок и управляет доменами на Vercel через REST API прямо из чата с агентом. CX Codex +1 176установок bilibili Скилл читает статистику статей в Bilibili и помогает публиковать новые через ваш аккаунт. Для работы нужны cookies входа. CX Codex +1 175установок figma Читает файлы Figma через REST API: дерево документа, отдельные ноды, рендер в PNG и комментарии. Запускается при переводе макета в код. CX Codex +1 175установок google-docs Позволяет читать, создавать и редактировать документы Google Docs через официальный REST API с помощью curl и jq. CX Codex +1 175установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой