Reddit Ads no Claude Code com um comando
Claude Code
Para conectar o Reddit Ads ao Claude Code, adicione o PaidSync.ai: rode claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, digite /mcp e entre com seu login do PaidSync.
O Claude Code acessa suas contas do Reddit com 14 ferramentas: desempenho por conta, campanha, grupo ou anúncio, mais pausar, ativar e alterar orçamentos e grupos de anúncios em campanhas existentes. Ele pergunta antes de cada ferramenta.
Nível Manage. O Claude Code trabalha em campanhas que você já veicula. Ele não cria novas campanhas no Reddit.
O comando
O Claude Code conversa com servidores MCP remotos por Streamable HTTP. O PaidSync é um deles. Adicione uma vez e o mesmo terminal que edita seu código passa a mostrar relatórios e gerenciar suas campanhas do Reddit.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor padrão, isso registra o servidor só para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina.
Execute claude mcp list para confirmar que ele está lá, depois inicie uma sessão e digite /mcp para entrar.
Configuração em 5 passos
1Cadastre-se em paidsync.ai/signup
Leva 10 segundos. Login com Google ou e-mail. O plano gratuito tem 100 tarefas por mês, no valor de $50, por $0, sem cartão.
2Conecte Reddit Ads no painel do PaidSync
Clique em Conectar no Reddit Ads e entre com o login do Reddit que abre suas contas de anúncios. O Reddit Ads autoriza via Reddit OAuth, e o PaidSync nunca vê sua senha do Reddit.
Já está dentro do Claude Code? Peça que ele execute connect_reddit_ads. A ferramenta devolve um link para abrir no navegador.
3Escolha a conta de anúncios em que o Claude Code deve trabalhar
Dentro de uma sessão, list_reddit_accounts mostra todas as contas de anúncios que o seu login do Reddit alcança, e set_active_reddit_account escolhe a conta em que o Claude Code trabalha.
4Adicione o PaidSync ao Claude Code
No seu terminal, rode:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicie uma sessão, digite /mcp, escolha paidsync e entre com o seu login do PaidSync na janela do navegador que abrir. O Claude Code guarda o token OAuth para você. Nenhuma chave é colada em lugar nenhum.
Configurando para uma equipe? Faça commit de um .mcp.json na raiz do repositório para que todo engenheiro receba o mesmo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Prefere uma chave de API, por exemplo para execuções sem interface? Envie-a em um cabeçalho, nunca na URL, onde ela iria parar nos logs:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Em um .mcp.json commitado, adicione "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que a chave fique no ambiente de cada engenheiro e nunca entre no git. Aplicar uma alteração no Google Ads ainda exige o login OAuth. Em outras plataformas, uma chave também pode aplicar alterações, então trate-a como uma senha e prefira OAuth.
5Teste a conexão
Em uma sessão do Claude Code, peça: “Show me Reddit spend, clicks and conversions by campaign for the last 7 days”
O Claude Code devolve impressões, cliques, gasto e conversões de cada campanha. A conexão está ativa.
O plano gratuito inclui 100 tarefas por mês. Pro a partir de $99 por mês, Team a partir de $249.
Prompts de Reddit Ads no Claude Code
Cada prompt abaixo corresponde a ferramentas do grupo Reddit Ads do PaidSync. O Claude Code escolhe a ferramenta. A última coluna diz se a chamada pode alterar algo na conta de anúncios.
| Pedido | Ferramentas que chama | Altera sua conta? |
|---|---|---|
| “List my Reddit ad accounts and make Acme the active one” | list_reddit_accounts, set_active_reddit_account | Não |
| “Show my campaigns from the last 7 days with spend, clicks and conversions” | get_reddit_performance | Não |
| “Which ad groups spent more than $100 in the last 14 days with no key conversions” | get_reddit_performance | Não |
| “List the ad groups and ads on the account” | list_reddit_adgroups, list_reddit_ads | Não |
| “Pause the Spring Launch campaign” | list_reddit_campaigns, pause_reddit_campaign | Sim, depois que você confirma |
| “Preview lowering the daily budget of the Retargeting ad group to $40” | update_reddit_adgroup | Sim, depois que você confirma |
| “Raise the bid on the Prospecting ad group to $1.20 and rename it Prospecting US” | update_reddit_adgroup | Sim, depois que você confirma |
Execute em modo headless com claude -p
A flag -p executa o Claude Code sem a sessão interativa. Entre uma vez por /mcp e o token OAuth guardado continua valendo. Um relatório que cai em um arquivo fica assim:
claude -p "Pull last 7 days Reddit performance at ad group level and list the ad groups with spend and no key conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/reddit-ads-$(date +%F).jsonAs leituras rodam direto, e as escritas também. --allowedTools "mcp__paidsync" permite todas as ferramentas do PaidSync, escritas incluídas, sem prompt.
Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa, cada uma pelo nome como mcp__paidsync__tool_name.
O que lê e o que grava
Das 14 ferramentas do Reddit Ads, 7 só leem e 5 podem escrever. As leituras cobrem contas de anúncios, campanhas, grupos de anúncios, anúncios e desempenho.
Ler mais
As escritas cobrem pausar e ativar campanhas, orçamentos e nomes de campanhas, e status, orçamento diário, lance e nome de grupos de anúncios.
Alterações feitas com as ferramentas de atualização mostram uma prévia por padrão com dry_run, e o PaidSync lê cada alteração de volta do Reddit depois. Uma pausa não tem dry run.
Via MCP, a etapa de aprovação é o próprio prompt do Claude Code. Ele pergunta antes de executar uma ferramenta, a menos que você a tenha permitido com --allowedTools ou nas suas configurações. O PaidSync acrescenta verificações do seu lado. Exclusões, pausas e alterações de orçamento exigem confirm_destructive, e uma verificação de regras antes da gravação bloqueia argumentos inseguros. O cartão de aprovação, e o Undo em um cartão aplicado cuja alteração tem inverso seguro, valem apenas no workspace do PaidSync.
Adicionar ao ChatGPT: abra o PaidSync.ai no diretório de plugins do ChatGPT, instale e faça login.
Adicionar ao Claude: abra o PaidSync.ai no diretório de conectores do Claude, clique em Conectar e faça login.
O que o Claude Code não faz no Reddit
- O PaidSync não cria campanhas, grupos de anúncios nem anúncios no Reddit. Crie-os no Reddit Ads Manager e depois gerencie-os pelo Claude Code.
- Criativos, subreddits, interesses e públicos são definidos no Reddit Ads Manager.
- O PaidSync não tem ferramenta para excluir ou arquivar no Reddit.
update_reddit_campaign_budgetdefine o orçamento diário de uma campanha que usa otimização de orçamento da campanha. Os demais orçamentos diários ficam no grupo de anúncios.- Os valores estão na moeda da sua conta de anúncios.
Perguntas frequentes
Como conectar Reddit Ads ao Claude Code?
Crie sua conta em paidsync.ai, conecte o Reddit Ads por OAuth no painel e execute claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp no terminal. Digite /mcp dentro de uma sessão, escolha paidsync e entre com seu login do PaidSync.
O Claude Code cria campanhas no Reddit?
Não. O Reddit é uma plataforma de nível Manage no PaidSync. O Claude Code pode gerar relatórios de campanhas existentes, pausá-las e ativá-las, e alterar orçamentos, lances e configurações de grupos de anúncios. Novas campanhas são criadas no Reddit Ads Manager.
O Claude Code altera orçamentos no Reddit?
Sim. update_reddit_campaign_budget altera o orçamento diário de uma campanha que usa otimização de orçamento da campanha, e update_reddit_adgroup altera o orçamento diário de um grupo de anúncios. Os dois mostram antes uma prévia em simulação, e o Claude Code pergunta antes de executar cada ferramenta.
Funciona em modo headless com claude -p?
Sim. Depois de entrar por /mcp, o claude -p reutiliza o token OAuth guardado. As leituras rodam direto. As escritas exigem cuidado. Ninguém está lá para responder ao prompt do Claude Code, então qualquer ferramenta de escrita que você permitiu com --allowedTools roda direto. Em uma tarefa sem supervisão, permita só as ferramentas de leitura de que ela precisa.
É grátis?
Sim. O plano gratuito custa $0 para 100 tarefas por mês, sem cartão. O Pro começa em $99 por mês e o Team em $249 por mês.
Relatórios e gestão de campanhas do Reddit. Um comando no Claude Code.