Lista os clientes cadastrados no PostGrowth, opcionalmente filtrando por nome. Somente leitura. Use para descobrir o cliente_id antes de qualquer outra ferramenta. Nunca devolve tokens nem credenciais do cliente.

Lista os posts de um cliente, com status de aprovação de texto e de design. Somente leitura. Requer o cliente_id obtido em listar_clientes.

Consulta um post específico: título, legenda, roteiro, datas, mídia e status de aprovação. Somente leitura.

ESCRITA. Cria um post de texto no PostGrowth (sem arte). Efeito colateral relevante: o PostGrowth cria automaticamente a tarefa correspondente no ClickUp, e essa tarefa NÃO é apagada mesmo que o post seja excluído depois. Não use para testes. Confirme com a pessoa antes de criar. O status de aprovação é derivado pelas regras do PostGrowth e não pode ser enviado.

ESCRITA. Altera campos de texto de um post existente: título, legenda, roteiro, data e horário. Só os campos enviados são alterados; os demais ficam intactos. Não toca em mídia. Alterar o roteiro pode reabrir o fluxo de aprovação de texto do cliente — confirme antes.

Somente leitura. Inspeciona uma tarefa do ClickUp: nome, anexos disponíveis e a qual post do PostGrowth ela está vinculada. Use SEMPRE esta ferramenta antes de subir_midia_clickup, para conferir o vínculo e o cliente sem disparar download nem upload.

⚠️ AÇÃO REAL E IRREVERSÍVEL — NÃO USE SEM CONFIRMAÇÃO EXPLÍCITA DE UMA PESSOA, NESTA CONVERSA. Baixa os anexos da tarefa do ClickUp e faz UPLOAD REAL na biblioteca de mídia do ROI SENSEI da subconta do cliente, através do PostGrowth. A arte enviada passa a aparecer na página pública de aprovação que o cliente vê. Com confirmar_substituicao=true, a mídia que já existe no post é APAGADA e substituída pelo conjunto novo — não existe 'acrescentar uma imagem', toda escrita substitui o conjunto inteiro. Nada disso pode ser desfeito por este shim. REGRAS DE USO: (1) rode consultar_tarefa_clickup antes e mostre o vínculo à pessoa; (2) peça confirmação explícita, citando o cliente e o post; (3) só passe confirmar_substituicao=true se a pessoa autorizar apagar a arte atual, com essas palavras; (4) NUNCA use em lote nem em laço sobre várias tarefas — uma chamada por vez, cada uma com sua confirmação.