gaql-reference — скилл для Claude Code: GAQL и установка
Скилл помогает составлять запросы GAQL для отчётов Google Ads и разбираться в ресурсах, полях и фильтрах. Пригодится, когда нужно подготовить запрос или проверить его структуру.
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a claude-codeЧто делает gaql-reference
Скилл объясняет устройство запросов GAQL: выбор полей и ресурса, условия фильтрации, сортировку, лимит строк и параметры. В справке разобраны ресурсы кампаний, групп объявлений, поисковых запросов, географии и истории изменений. По теме можно запросить готовый шаблон, например для анализа показателя качества или поисковых запросов.
При подключённых инструментах Cogny MCP скилл может передать запрос Google Ads на выполнение и обратиться к документации API. Без подключения справочная часть всё равно работает, но запросы не запускаются. Для Microsoft Ads предусмотрен отдельный инструмент отчётов: GAQL там не используется, поэтому запросы Google Ads к нему неприменимы.
Какие задачи решает
- составить GAQL-запрос для отчёта по поисковым запросам
- выбрать ресурс для анализа географических показателей
- отфильтровать кампании по статусу и периоду
- проверить структуру запроса перед запуском
- найти запрос для аудита истории изменений
Примеры запросов агенту
- Составь GAQL-запрос для отчёта по поисковым запросам за последние 30 дней.
- Покажи запрос для анализа показателя качества в Google Ads.
- Объясни, какой ресурс выбрать для отчёта по географическим показателям.
Как установить gaql-reference
1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a claude-code2Вручную: положить файлы
~/.claude/skills/gaql-reference/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gaql-reference/
1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a codex2Вручную: положить файлы
.agents/skills/gaql-reference/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a cursor2Вручную: положить файлы
.cursor/skills/gaql-reference/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills gaql-reference2Вручную: положить файлы
.github/skills/gaql-reference/SKILL.md1Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a gemini-cli2Командой платформы
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skills/gaql-referenceВручную: положить файлы
.devin/skills/gaql-reference/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gaql-reference
Как установить gaql-reference в Claude Code?
Выполните npx skills add cognyai/claude-code-marketing-skills --skill gaql-reference -a claude-code. Файл скилла находится по пути ~/.claude/skills/gaql-reference/SKILL.md.
Что делает gaql-reference?
Помогает писать и разбирать запросы GAQL для отчётности Google Ads: подсказывает ресурсы, поля и условия, а также даёт шаблоны запросов.
Можно ли запускать запросы Google Ads через скилл?
Да, если подключены инструменты Cogny MCP и доступен аккаунт Google Ads. Без подключения скилл остаётся справочником, но запросы не выполняет.
