BYOD para operações de anúncios de IA — forneça ao agente um CSV, não seu token de atualização

TL;DR:

• mureo v0.7.1 (lançado em 2026-04-29) permite que um agente de IA analise suas contas reais do Google Ads e Meta Ads a partir de um XLSX local. Sem OAuth, sem token de desenvolvedor, sem login em SaaS.
• Ferramentas de mutação retornam {"status": "skipped_in_byod_readonly"} por construção. O agente pode recomendar uma mudança de orçamento; ele não pode executar uma.
• Somente leitura por construção é a resposta estrutural ao modelo de ameaça que escrevi aqui. Este post é o guia.

Há algumas semanas, eu publiquei sobre os três modos de falha de agentes de IA que tocam contas de anúncios: injeção de prompt, exfiltração de credenciais e mutações ilimitadas. A conclusão honesta foi que "tenha cuidado com seu token de atualização" não é uma resposta séria quando o LLM eventualmente será enganado.

A resposta estrutural é: não conecte o agente à conta. Envie um CSV. Deixe o agente raciocinar sobre os números, redigir o diagnóstico e propor mudanças que você executa manualmente se confiar nelas.

Esse modo foi lançado hoje como mureo v0.7.1. Este é o guia.

O que você realmente obtém em 5 minutos

Um verdadeiro /daily-check do Claude Code, executado contra seu próprio gasto em anúncios, sem ID de Cliente OAuth registrado e sem aplicação de token de desenvolvedor do Google Ads aguardando revisão.

A coisa que ele produz se parece com isso. Extraído de um pacote BYOD de 30 dias em uma conta B2B SaaS anônima, termos de marca substituídos por <brand>, números inalterados:

<brand> em Search_Brand-Performance / Grupo de anúncios de marca: 6 conversões a ¥4,550 CPA.
<brand> em Search_Lead-Gen / Grupo genérico: 0 conversões, ¥31,800 gastos em 30 dias.
O mesmo para <brand-en> em Search_Lead-Gen: 0 conversões, ¥14,300 gastos.
O tráfego da marca deve ser consolidado no grupo de anúncios da marca; adicione os termos da marca como negativos em nível de campanha em Search_Lead-Gen. ~¥250,000/mês redirecionáveis.

Esse diagnóstico existe porque o agente teve acesso à aba de termos de pesquisa da sua planilha do Google Ads, além da persona/USP do seu STRATEGY.md. Não existe porque o mureo tem um token de atualização. Ele não pode executar a mudança; ele pode apenas te dizer que a mudança vale a pena.

Configuração

mureo está no PyPI a partir da v0.7.1:

pip install mureo                  # instala 0.7.1
mureo setup claude-code --skip-auth
# => Escreveu ~/.claude/.../mcp.json
# => Guardião de credenciais PreToolUse instalado
# => Comandos de fluxo de trabalho instalados (/daily-check, /search-term-cleanup, ...)
# => OAuth pulado (modo BYOD, nenhuma credencial necessária)

--skip-auth é a coisa a ser notada. Ele registra o servidor MCP, os comandos de barra, as habilidades mureo-* e o guardião ~/.mureo/credentials.json PreToolUse, mas nunca abre um navegador. Nada em ~/.mureo/credentials.json existe ainda. Nada deveria.

Python 3.10+ é necessário. A única nova dependência de tempo de execução em relação à v0.6 é openpyxl>=3.1,<4 para o leitor de pacotes.

Produzindo o pacote

Duas plataformas, dois fluxos. Escolha qual você gastou primeiro; eles são independentes.

Google Ads — Scripts de Apps, sem projeto GCP

Abra o Google Ads. Ferramentas → Ações em massa → Scripts → +. Cole o conteúdo de scripts/sheet-template/google-ads-script.js do repositório mureo, defina TARGET_SHEET_URL no topo para uma planilha do Google que você possui, clique em Autorizar, clique em Executar.

Ignore este parágrafo se você já sabe como funcionam os Scripts do Google Ads. A coisa que vale a pena saber para todos os outros: isso não é Google Apps Script. Ele é executado dentro da interface do Google Ads sob a identidade da sua conta de anúncios, na infraestrutura do Google. Não há projeto GCP a ser criado, nenhum cliente OAuth a ser registrado, nenhuma fila de revisão de token de desenvolvedor para esperar. O mureo não obtém nenhuma credencial disso. O script escreve na sua planilha em seu Drive, e o próximo passo é você clicar em Arquivo → Baixar.

Se você trabalha em uma empresa no Google Workspace onde a criação de projetos GCP pessoais é bloqueada no nível da organização, isso é o que importa. O caminho "fazer login no Editor de Apps Script" que a maioria das ferramentas do estilo BYOD segue está morto nessas organizações. Scripts do Google Ads não. Runtime completamente diferente.

Quatro abas são preenchidas na planilha: campaigns, ad_groups, search_terms, keywords. Insights de leilão são intencionalmente pulados. Scripts do Google Ads não expõem auction_insight_domain do GAQL, e o legado AWQL AUCTION_INSIGHT_PERFORMANCE_REPORT retorna "Relatório não mapeado" de dentro do runtime dos Scripts. Eu tentei ambos. Eles não funcionam. Se você precisar de /competitive-scan, o caminho da API real é inevitável para essa ferramenta.

Então Arquivo → Baixar → Microsoft Excel (.xlsx) e salve em algum lugar que você consiga encontrar.

Meta Ads — relatório salvo, dois cliques

Ads Manager → Relatórios → Personalizar → Exportar. Configure uma vez com a divisão Por Tempo → Dia, nível Anúncio, e as colunas: Dia, Nome da campanha, Nome do conjunto de anúncios, Nome do anúncio, Impressões, Cliques (todos), Valor gasto, Resultados. Salve como um Relatório Salvo (chame-o de mureo BYOD ou o que quiser) e na próxima vez você só precisa de Relatórios Salvos → mureo BYOD → Exportar → Excel. Cerca de 10 segundos.

Idioma da conta: qualquer um dos nove. O adaptador Meta reconhece cabeçalhos de coluna em Inglês / 日本語 / 简体中文 / 繁體中文 / 한국어 / Español / Português / Deutsch / Français, verificado contra exportações reais do Ads Manager em cada local. Você não precisa mudar o idioma do seu Ads Manager para inglês apenas para alimentar o pacote ao mureo.

A história do local também é onde o meio bagunçado de obter a v0.7.1 saiu. Eu voltarei a isso.

Importando

mureo byod import ~/Downloads/<google-ads-bundle>.xlsx
mureo byod import ~/Downloads/<meta-ads-export>.xlsx

A saída se parece com isso:

=== mureo byod import ===

  [google_ads] formato: mureo_sheet_bundle_google_ads_v1
    421 linhas, intervalo de datas 2026-04-01..2026-04-30
    escrito em /Users/you/.mureo/byod/google_ads/
      - campaigns.csv
      - metrics_daily.csv
      - ad_groups.csv
      - keywords.csv
      - search_terms.csv

Resumo do modo:
  google_ads        BYOD (421 linhas, 2026-04-01..2026-04-30)
  meta_ads          não configurado (sem dados BYOD, sem credentials.json)

Próximo: pergunte ao Claude Code: 'Execute /daily-check'

Não há --byod flag e nenhum toggle global. O importador de pacotes despacha o adaptador do Google Ads quando vê uma aba campaigns do modelo da planilha; ele despacha o adaptador Meta quando o cabeçalho da pasta de trabalho se parece com uma exportação do Ads Manager. As abas são distintas por formato de cabeçalho (Google Ads usa campaign em forma curta, Meta usa Campaign name em forma longa), então você não pode misturá-las em uma única pasta de trabalho, mesmo que tentasse.

A presença de ~/.mureo/b