Os manuais oficiais do Google no Claude Code (Google Ads)

O que é isso

O Google mantém no GitHub o repositório oficial google/skills, com 150 manuais (o nome técnico é skill: um arquivo de instruções que ensina o assistente a usar uma ferramenta). Tem manual de Cloud, Gemini, Firebase, Analytics e anúncios. A licença é Apache 2.0, aberta.

Na parte de anúncios são 14. Para quem anuncia no Google Ads, importam 3:

google-ads-api-quickstart: guia você para gerar as credenciais da API do Google Ads.
google-ads-api-mcp-setup: instala e configura o conector oficial.
google-ads-api-account-diagnostics: o diagnóstico. Mostra por que a conversão caiu, se o volume de leads caiu por tráfego ou por taxa de conversão, e se os anúncios deixam de aparecer por falta de verba ou por perder o leilão.

As outras 11 são para quem desenvolve app (anúncios dentro de aplicativo) ou envia conversões e públicos por API.

Antes de começar

Você precisa do Claude Code, que exige um plano pago do Claude (Pro, Max, Team ou Enterprise). Também precisa do Node (para o comando npx), do Python 3.12 ou mais novo e do pipx.

Conector (o nome técnico é MCP) é o que liga o Claude a outro sistema. O conector oficial do Google Ads tem só duas ferramentas, as duas de consulta: search (lê os dados da conta) e list_accessible_customers (lista as contas que você acessa). Ele não cria, não pausa e não muda nada.

Passo 1: instalar os 3 manuais

No terminal, rode:

npx skills add google/skills -g --agent claude-code --skill google-ads-api-quickstart google-ads-api-mcp-setup google-ads-api-account-diagnostics

O -g instala para o seu usuário (vale em qualquer pasta). Se quiser ver os 150 antes, troque o fim por --list.

Passo 2: gerar as credenciais

O conector precisa de 4 dados da sua conta: o token de desenvolvedor do Google Ads, um client ID e um client secret do Google Cloud e um refresh token. Abra o Claude Code e peça:

Use a skill google-ads-api-quickstart e me guie, passo a passo, para gerar as credenciais da API do Google Ads.

O token de desenvolvedor fica na Central de API da sua conta do Google Ads. Para ler uma conta de verdade ele precisa do acesso Explorer, que se pede ali mesmo e tem revisão automática. Não precisa mais de conta de administrador, só se você gerencia várias contas.

Passo 3: ligar o conector

Com os 4 dados em mãos, rode no terminal, trocando cada SEU_... pelo seu valor:

claude mcp add google-ads --scope user \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=SEU_TOKEN \
  -e GOOGLE_ADS_CLIENT_ID=SEU_CLIENT_ID \
  -e GOOGLE_ADS_CLIENT_SECRET=SEU_CLIENT_SECRET \
  -e GOOGLE_ADS_REFRESH_TOKEN=SEU_REFRESH_TOKEN \
  -- pipx run google-ads-mcp

Se você gerencia várias contas por uma conta de administrador, acrescente -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=ID_DO_ADMINISTRADOR (10 dígitos, sem traço). Depois abra o Claude Code e digite /mcp: o google-ads tem que aparecer como conectado.

Cuidado com os dados: o token e o secret são senhas. Não cole em documento compartilhado nem em print.

Passo 4: perguntar em português

Abra uma conversa nova e comece com "use a skill google-ads-api-account-diagnostics". Depois, pergunte:

Por que as conversões da minha conta caíram nos últimos 7 dias, comparando com os 7 anteriores?
Quais campanhas estão perdendo impressão por falta de verba, e quais por perder o leilão?
O meu volume de leads caiu essa semana. Foi o tráfego que caiu ou a taxa de conversão?
Alguém mudou lance, orçamento ou segmentação nos últimos 30 dias? O que mudou e quando?
Me dá um resumo da conta em 5 linhas: o que está bem, o que piorou e o que eu olho primeiro.

Ele consulta a conta e responde com os números e onde está o problema. Quem decide o que mudar na campanha é você, no painel do Google Ads.

Limite

O conector só lê: ele não pausa campanha nem muda lance. Sem o token de desenvolvedor com acesso Explorer, ele não liga em conta de verdade. O diagnóstico olha conversão, leads, parcela de impressões perdida por verba ou por classificação e alterações dos últimos 30 dias; o que não está na conta do Google Ads (venda no balcão, WhatsApp) fica de fora. Repositório, comandos e requisitos conferidos em 7 de outubro de 2026 no GitHub do Google e na documentação do Google Ads; se mudar, vale o que está lá.

Próximo passo: o pack

Cada ferramenta deste guia faz uma tarefa. O pack são 10 assistentes e 4 skills para o Claude Code que leem o contexto do seu cliente antes de escrever: copy, página, automação, auditoria e relatório.

R$47,90, pagamento único, mais R$0,99 de taxa no checkout. 7 dias para desistir, por lei.

Ver o que vem no pack

GRUPO DO WHATSAPP

Os próximos guias saem primeiro no grupo

É onde eu mando o material novo e respondo dúvida de quem está montando o próprio sistema. Entrar e sair é livre.

Entrar no grupo do WhatsApp