Skills Oficiais do Google pro Google Ads: Auditoria no Claude Code
Instale as skills oficiais do Google para Google Ads, ligue o MCP oficial ao Claude Code e rode o diagnóstico da sua conta passo a passo.
O que é
Skills Oficiais do Google pro Google Ads: Auditoria no Claude Code
O Google publicou, em repositório aberto (licença Apache-2.0), um pacote de skills para os produtos dele. São cerca de 150 skills, e três delas são de Google Ads: uma que diagnostica a conta, uma que instala o MCP oficial e uma que te leva do zero até o primeiro script com a API.
Neste tutorial você instala essas três skills no Claude Code, pede o developer token da Google Ads API, liga o MCP oficial (somente leitura) e pede ao Claude um diagnóstico: queda de conversão, impressões perdidas por orçamento ou por classificação, mudanças recentes na conta. A skill lê e aponta onde olhar. Ela não cria nem edita campanha, e não substitui quem gerencia a conta.
Você precisa de acesso a uma conta de Google Ads e de paciência com o developer token, que pode sair em minutos ou levar dias, dependendo do nível. Se travar nessa parte, o tutorial do Windsor (link em Próximos passos) é o caminho mais simples.
Skills oficiais, repositório aberto
As skills vêm do repositório google/skills, com licença Apache-2.0. Você instala só as três de Google Ads, com um comando.
MCP oficial, somente leitura
O MCP google-ads-mcp expõe três ferramentas: buscar dados, ler metadados e listar as contas acessíveis. Não há ferramenta de escrita.
Diagnóstico por roteiro
A skill de diagnóstico segue um roteiro de consultas: perda de conversão, parcela de impressões perdida por orçamento ou por rank, mudanças recentes.
Setup guiado pelo Claude
A skill de setup confere Python e pipx, instala o pacote e te mostra o comando de registro com placeholders para os seus segredos.
Resultado para conferir no painel
O diagnóstico aponta hipóteses. Você confirma tudo no painel do Google Ads antes de mudar qualquer coisa.
Nível: intermediário · Tempo estimado: ~30 min, mais a espera do developer token (de minutos a dias)
Ainda não rodamos este diagnóstico numa conta real de Google Ads. Os passos abaixo seguem a documentação oficial do repositório e das skills. O que depende da sua conta (token, OAuth, resultado do diagnóstico) é por sua conta e risco: confira cada resultado no painel antes de agir.
Pré-requisitos
- Claude Code instalado e Node.js (para rodar o comando npx)
- Acesso a uma conta de Google Ads. Se usa conta gerente (MCC), anote o ID dela: 10 dígitos, sem hífen
- Developer token da Google Ads API (pedido no API Center da conta gerente)
- Um projeto no Google Cloud com a Google Ads API habilitada, uma credencial OAuth do tipo Desktop e o refresh token
- Python 3.12 ou mais novo e pipx instalado (a skill de setup exige 3.12; o pacote no PyPI declara 3.10 como mínimo)
- Custo: as skills e o MCP são gratuitos. Verifique as regras de uso e cobrança da API na documentação do Google
Conceitos-chave
- 01
Skill
Um manual em arquivo (SKILL.md) que o Claude lê antes de trabalhar. Ela diz o que perguntar, que consultas rodar e o que evitar.
- 02
MCP
A ponte que dá ao Claude acesso à sua conta. O MCP oficial do Google Ads é somente leitura: busca dados, lê metadados e lista contas.
- 03
Skill de diagnóstico
Um roteiro de consultas em GAQL (a linguagem de consulta do Google Ads) que usa as ferramentas do MCP. Ela lê a conta e aponta onde olhar. Não cria nem edita campanha.
- 04
Developer token
A chave que libera a API para o seu uso. Tem níveis: Test (só contas de teste), Explorer (produção, com limite diário), Basic e Standard (exigem verificação). Para consultar conta real, precisa de pelo menos Explorer.
Privacidade: o MCP entrega os dados da sua conta ao modelo (o próprio README avisa). Se for conta de cliente, peça autorização. Nunca cole developer token, client secret ou refresh token no chat, e borre conta, ID e verba antes de postar qualquer print.
Passo a passo
- 01
Passo 1 — Conferir o repositório oficial
Abra o repositório do Google e entre na pasta skills/ads. É lá que ficam as skills de Google Ads. O repositório tem licença Apache-2.0 e cerca de 150 skills (o número muda; confira no README no dia em que for usar).
https://github.com/google/skills/tree/main/skills/ads - 02
Passo 2 — Instalar as 3 skills no Claude Code
Na pasta do seu projeto, rode o comando abaixo. Ele copia as três skills para .claude/skills/ e cria um skills-lock.json. Para instalar em todas as pastas, acrescente -g (vai para ~/.claude/skills/).
npx skills add google/skills \ --skill google-ads-api-account-diagnostics \ --skill google-ads-api-mcp-setup \ --skill google-ads-api-quickstart \ -a claude-code -y - 03
Passo 3 — Pedir o developer token e criar as credenciais OAuth
No API Center da sua conta gerente, peça o developer token. A aprovação pode ser automática (Explorer) ou levar dias (Basic e Standard). Peça cedo. Em paralelo, no Google Cloud, habilite a Google Ads API e crie uma credencial OAuth do tipo Desktop. Doc oficial do token no link abaixo; a skill google-ads-api-mcp-setup te guia no resto (use o prompt de instalar e configurar o MCP, mais abaixo; se faltar credencial, ela manda você ao quickstart).
https://developers.google.com/google-ads/api/docs/get-started/dev-token - 04
Passo 4 — Instalar o MCP oficial
No terminal, instale com pipx e confirme que o comando responde. No macOS, se não tiver pipx: brew install pipx e depois pipx ensurepath (reabra o terminal).
pipx install google-ads-mcp google-ads-mcp --help - 05
Passo 5 — Registrar o MCP no Claude Code
Troque os valores em caixa-alta pelos seus. Digite no seu terminal, não no chat do Claude, para o segredo não ficar na conversa. O GOOGLE_ADS_LOGIN_CUSTOMER_ID só é necessário se você acessa via conta gerente (MCC). A sintaxe do claude mcp add foi conferida no help do comando; a execução com credenciais reais não foi testada por nós.
claude mcp add google-ads \ -e GOOGLE_ADS_DEVELOPER_TOKEN=SEU_TOKEN \ -e GOOGLE_ADS_CLIENT_ID=SEU_CLIENT_ID \ -e GOOGLE_ADS_CLIENT_SECRET=SEU_SECRET \ -e GOOGLE_ADS_REFRESH_TOKEN=SEU_REFRESH_TOKEN \ -e GOOGLE_ADS_LOGIN_CUSTOMER_ID=ID_DO_MCC_SEM_HIFEN \ -- pipx run google-ads-mcp - 06
Passo 6 — Reiniciar e conferir a conexão
Feche e abra o Claude Code e rode /mcp. O servidor google-ads deve aparecer como conectado. Se não aparecer, veja a seção de erros comuns.
/mcp - 07
Passo 7 — Rodar o diagnóstico
Cole o prompt de diagnóstico geral. Se o seu problema é específico, use o de queda de conversão ou o de verba e impressões perdidas. O Claude vai listar as contas acessíveis e perguntar qual analisar.
- 08
Passo 8 — Ler o resultado e conferir no painel
Impressões perdidas por orçamento (budget) indicam verba curta. Perdidas por classificação (rank) indicam lance ou qualidade do anúncio. Trate o resultado como lista de hipóteses e confirme cada uma no painel do Google Ads antes de alterar qualquer coisa.
Prompts prontos
O primeiro prompt abaixo é o do post: o pedido de diagnóstico que roda a skill oficial. Copie e cole no Claude Code com o MCP conectado.
Prompt: diagnóstico geral da conta (o do post)
Use a skill google-ads-api-account-diagnostics. Liste as contas acessíveis pelo MCP, escolha só contas ativas que não sejam gerentes e me pergunte qual analisar. Compare os últimos 7 dias com os 7 anteriores. Mostre: variação de conversões e valor de conversão, custo (já convertido de micros para moeda), parcela de impressões perdida por orçamento e por classificação (rank), e o que mudou em change_event nesse período. No final, liste os 3 achados mais prováveis e o que eu devo conferir no painel. Não altere nada na conta.
Prompt: instalar e configurar o MCP (use no Passo 3 e 4)
Siga a skill google-ads-api-mcp-setup. Primeiro verifique se tenho Python 3.12+ e pipx. Se faltar algo, me diga o comando para o meu sistema operacional e espere. Depois instale o pacote google-ads-mcp com pipx, confirme com google-ads-mcp --help e me mostre o comando claude mcp add com as variáveis de ambiente, usando placeholders para os meus segredos. Não peça nem exiba meus tokens no chat.
Prompt: queda de conversão
Minhas conversões caíram nos últimos dias. Siga o fluxo 'Conversion and Conversion Value Loss' da skill de diagnóstico: segmente por dispositivo e por ação de conversão, diga se a queda é de tráfego ou de taxa de conversão e se há problema no envio de conversões offline. Responda em português com uma tabela.
Prompt: verba travada e impressões perdidas
Rode o fluxo 'Opportunities Lost (Impression Share)' da skill de diagnóstico. Liste as campanhas com maior search_budget_lost_impression_share e com maior search_rank_lost_impression_share, e explique em uma frase por campanha se o gargalo é orçamento ou lance e qualidade. Não altere nada na conta.
Prompt: primeiro script com a API (quickstart)
Siga a skill google-ads-api-quickstart com Python. Resolva a versão atual da Google Ads API antes de gerar código, me diga quais credenciais ainda faltam e, quando eu as tiver, gere o script que lista as campanhas da conta.
Se o Claude começar a escrever um script Python em vez de consultar a conta, avise: use as ferramentas do MCP google-ads. A skill de diagnóstico foi feita para usar o MCP, não scripts.
Erros comuns
- Erro 'The developer token is only approved for use with test accounts' → o token ainda está no nível Test → peça acesso Explorer ou Basic no API Center.
- DEVELOPER_TOKEN_NOT_APPROVED ou USER_PERMISSION_DENIED → token sem aprovação ou usuário OAuth sem acesso à conta → confira o login_customer_id (conta gerente, 10 dígitos, sem hífen) e se o usuário que autorizou tem acesso.
- google-ads-mcp: command not found → o PATH do pipx não está carregado → rode pipx ensurepath, reabra o terminal ou teste ~/.local/bin/google-ads-mcp --help.
- ID da conta com hífen (123-456-7890) → a API não aceita → use só os dígitos.
- Erro ao consultar conta gerente ou desativada → a consulta de métricas não vale para esse tipo de conta → a skill filtra contas ENABLED e não gerentes; escolha uma conta de anúncios ativa.
- change_event falhando → exige LIMIT de no máximo 10000, janela de até 30 dias e nenhuma coluna metrics.* → peça ao Claude para ajustar a consulta a essas regras.
- Custo com valores gigantes → o campo vem em micros → divida cost_micros por 1.000.000.
- O servidor google-ads não aparece em /mcp → reinício pendente ou comando de registro com erro → feche o Claude Code, abra de novo e rode claude mcp list para ver o status.
Checklist final
- As 3 skills aparecem em .claude/skills/ (ou ~/.claude/skills/)
- O developer token tem acesso a produção (Explorer ou superior)
- OAuth client e refresh token guardados fora do repositório e do chat
- pipx install google-ads-mcp concluído e google-ads-mcp --help responde
- /mcp mostra google-ads como conectado
- O diagnóstico rodou numa conta e você conferiu o resultado no painel do Google Ads
- Nenhum segredo foi colado em chat ou commit, e os prints têm conta, ID e verba borrados
Próximos passos
- Travou no token? O caminho mais simples, com o Windsor: /open-source/integracoes/google-ads-no-claude-code-em-3-passos
- Como instalar MCPs no Claude Code, com o passo a passo geral: /open-source/integracoes/como-instalar-mcps-no-claude-code-em-5-passos
- Meta Ads no Claude em 3 passos, para olhar o outro lado dos seus anúncios: /open-source/integracoes/meta-ads-no-claude-em-3-passos
- Documentação oficial do MCP: https://github.com/googleads/google-ads-mcp
- Níveis de acesso do developer token: https://developers.google.com/google-ads/api/docs/api-policy/access-levels
Comece agora
Pronto para colocar Skills Oficiais do Google pro Google Ads: Auditoria no Claude Code para rodar?
Ver as skills oficiais no GitHubPróximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo