analise_agregada
ChatGPTAgregador: combina TODAS as análises (matchup, regression, xG, consistency, stacking, ownership, captain EV) em uma recomendação unificada. Modos: "liga_longa" (consistência + matchup + regression), "mata_mata_favorito" (piso alto + chalk + captain chalk), "mata_mata_azarao" (teto + differential + leverage + stacking explosivo). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
analise_arbitragem
ChatGPTAnálise de ARBITRAGEM da rodada: por jogo, mostra o ÁRBITRO designado e o perfil dele — jogos apitados, média de CARTÕES AMARELOS, de VERMELHOS e de PÊNALTIS por jogo (mais a média de FALTAS quando o campeonato registrar esse dado). Use quando o usuário perguntar "quem apita o jogo?", "análise da arbitragem", "esse árbitro dá muito cartão?", "árbitro do [time]". Útil pra risco de CA/CV (cartão) e chance de FS/pênalti. O árbitro costuma sair só ~24h antes do jogo — antes disso vem "a definir". Usa SOMENTE os dados em CACHE dos confrontos (não busca/calcula nada ao vivo); se não houver árbitro em cache, avisa que ainda não tem. Passe nome_clube para um jogo específico.
analise_final_pesos
ChatGPTConsolidação final para gerar MÚLTIPLOS times: junta o MME Completo (fechamentos de defesa) + o Ownership Leverage SG numa distribuição única de variações. Reserva pct_mme (padrão 60%) para os clubes recomendados pelo MME e o restante para os clubes de leverage (forte de verdade mas pouco escalado). Use para "distribuição final dos meus times", "fechar a estratégia de loteria". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
analise_sg
ChatGPTAnálise completa de chances de SG para um confronto. Retorna DOIS blocos distintos: defesa_propria (gols/finalizações SOFRIDOS pelo clube em foco — use para avaliar atacante adversário VS essa defesa) e perfil_adversario (gols/finalizações que o adversário PRODUZ atacando — use para estimar SG do clube em foco). Também: cs_rate, sg_cedido_rate, score_sg_combinado. NUNCA confunda os dois blocos. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
analise_sg_geral
ChatGPTVersão enxuta da analise_sg para TODOS os clubes da rodada atual. Retorna ranking por score_sg_combinado (blend defesa do clube + ofensiva do adversário + odds se disponíveis). Sem zonas/perfis pesados — use analise_sg quando precisar de detalhes de um clube específico. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
aplicar_troca_estado
ChatGPTOBRIGATÓRIO para QUALQUER troca/substituição de jogador na escalação atual do usuário. Remove um jogador (por atleta_id ou id footstats) e adiciona outro no lugar. Atualiza o escalacao_estado canônico. NUNCA descreva uma troca em texto sem chamar esta tool — se não chamar, o estado não muda e o salvamento sai errado. MODO RESERVA: para PREENCHER um slot de reserva VAZIO, chame só com adicionar_atleta_id/adicionar_id (SEM remover_) — o jogador entra como reserva da posição dele (regra do Cartola: mais barato que o titular mais barato da posição; use sugerir_reservas para candidatos válidos). RESERVA DE LUXO: passe reserva_luxo=true para marcar o jogador adicionado como luxo; para marcar luxo em quem JÁ é reserva, chame com adicionar_atleta_id dele + reserva_luxo=true (sem remover_).
avaliar_conflito
ChatGPTAvalia o conflito ataque × defesa na escalação. Com 2+ defensores do adversário, quase NUNCA compensa: 1 gol = +8 atacante − 6×N defensores. Prefira ids. Informe OBRIGATORIAMENTE os defensores que estão na SUA escalação. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
avaliar_duplicidade
ChatGPTAvalia se compensa escalar 2 jogadores da mesma posição (ATA ou MEI) do mesmo clube como titulares. Prefira ids. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
avaliar_fechamento_defesa
ChatGPTAvalia as melhores equipes para "fechar defesa" (TEC+GOL+LAT+ZAG do mesmo time apostando em clean sheet). Ranking por sg_combinado = cs_rate_proprio × 60% + sg_cedido_adversário × 40%. Retorna: cs_rate, sg_cedido_rate do adversário, sg_combinado, jogadores disponíveis com PE/preço, técnico. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
avaliar_indicacoes
ChatGPTAvalia e RANQUEIA as indicações da comunidade da rodada atual: para cada uma, calcula a MÉDIA da PE (pontuação esperada) dos jogadores PROVÁVEIS que ela indicou — a NOSSA avaliação ao vivo (funciona ANTES da rodada) — e ordena da melhor pra pior, mostrando o autor. Use para "qual a melhor indicação da rodada?", "ranqueia as dicas", "quem indicou melhor?". Só Brasileirão. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
avaliar_minha_escalacao
ChatGPTAvalia cada jogador do time com nossas análises: PE, matchup score, consistência, conflitos ataque×defesa, stacking, sg_combinado. Retorna diagnóstico com pontos fortes/fracos e sugestões. CLIENT-SIDE: passe "time" = o JSON que você buscou via escalacao_confirmada (/auth/time) — assim a leitura sai do seu IP. Sem "time", cai no fallback server-side (precisa de conta conectada).
bola_parada
ChatGPTIdentifica os COBRADORES DESIGNADOS de pênalti, escanteio e falta (quem BATE / quem já bateu — histórico do campeonato), independente de estar provável na rodada atual. Dados reais quando disponíveis, senão inferência pelos scouts. Cada jogador traz 'provavel_rodada' (se é provável de jogar agora) como informação, não como filtro. Use para "quem cobra pênalti?", "quem bate falta?", "cobradores", "bola parada". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
captain_ev
ChatGPTCalcula valor esperado (EV) de cada candidato a capitão combinando: Matchup Score, xG proxy, consistência e volatilidade. Retorna ranking CHALK (seguro, alto EV) e DIFFERENTIAL (alto EV mas baixa popularidade). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
card_clube
ChatGPTReúne TODOS os dados de um clube para a IA montar um CARD visual (devolve dados + URLs, não desenha). Inclui identidade, escudo + CORES do clube, stats defensivas/ofensivas (clean sheets, gols sofridos/feitos, SG, aproveitamento) e próximo jogo. Use quando o usuário pedir um "card"/"imagem" de um clube. TODOS os rótulos/legendas/textos do card devem ser em PORTUGUÊS DO BRASIL. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
card_confronto
ChatGPTReúne os dados dos DOIS clubes de um confronto para a IA montar um CARD de jogo (devolve dados + URLs). Inclui identidade, escudo + cores de cada lado, stats de cada clube e o contexto do confronto (rodada, mando). Passe um clube (acha o próximo adversário dele na rodada) OU os dois clubes. Use para "card do jogo X x Y", "card do confronto do [clube]". TODOS os rótulos/legendas/textos do card devem ser em PORTUGUÊS DO BRASIL. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
card_jogador
ChatGPTReúne TODOS os dados de um jogador para a IA montar um CARD visual (a tool NÃO desenha — devolve dados + URLs). Inclui identidade, foto (URL), escudo + CORES do clube (pra temar o card), stats (média, PE, preço, status, jogos), scouts/totais (gols, assistências, etc.) e próximo jogo. Identifique por id/atleta_id, nunca por apelido. Passe "tema" e/ou "destaques" conforme o pedido do usuário (ex.: "card do Rossi mostrando média, PE e gols, nas cores do clube"). Use sempre que o usuário pedir um "card"/"figurinha"/"imagem" de um jogador. TODOS os rótulos/legendas/textos do card devem ser em PORTUGUÊS DO BRASIL. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
cartoes_suspensao
ChatGPTAnálise de cartões amarelos/vermelhos e risco de suspensão. Mostra progresso até suspensão (X/3), histórico e alerta. Use para "risco de cartão", "vai ser suspenso?", "cartões acumulados". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
cedido_por_zona
ChatGPTRanking de CLUBES por PONTOS que CEDEM numa REGIÃO do campo (lado esquerdo/central/direito × ataque/meio/defesa). Responde "quem mais cede ponto pelo lado direito?", "qual defesa cede mais pela esquerda?", "quem cede mais pra atacante?". Soma o que os ADVERSÁRIOS produziram contra o clube, por quadrante de atuação (grid 6×6). Combine lado e setor; filtre scouts, a posição de QUEM MARCOU, e/ou um clube (nome_clube = só ele; sem = ranking de todos). Respeita rodadas/mando. Cada clube vem com por_quadrante (1-36) e uma matriz grid 6×6 (topo=ataque, base=defesa; esquerda→direita) pronta pra renderizar como CAMPINHO/heatmap. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
cedidos_por_clube
ChatGPTMédia de pontos que um clube CEDE a cada posição adversária (quanto MAIOR, mais frágil contra aquela posição — bom para quem o enfrenta). Use para "o [clube] cede muito pra [posição]?", "vale a pena pegar [posição] contra o [clube]?". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
ceiling_floor
ChatGPTAnalisa P10/P25/P50/P75/P90/Max de cada jogador (percentis históricos). Classifica em: GPP_PREMIUM (alto ceiling, mitou >25%), GPP_SOLID, CASH_SAFE (alto floor, baixo blank rate), BOOM_OR_BUST. Ideal para escolher entre perfis safe vs explosive. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
clubes_que_mais_cedem
ChatGPTRanking de clubes que mais cedem pontos a uma posição (piores defesas contra essa posição). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
comparar_jogadores
ChatGPTComparação direta entre dois jogadores: média, scouts por jogo, taxas de conversão, matchup contra adversário da rodada, zonas do campo. Prefira id/atleta_id. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
configurar_filtros
ChatGPTDefine e CONSULTA os filtros padrão da conversa do assinante (persistem no servidor entre chamadas e conversas): rodadas (últimas N), mando, campeonato e patrimônio. Chame SEM argumentos para consultar o que está ativo. Com argumentos, define parcialmente (só muda o que for passado). Use quando o usuário expressar preferência: "considera só as últimas 5 rodadas", "só jogos como visitante", "meu orçamento é 120", "vamos analisar a Premier". Os filtros viram padrão de TODAS as tools seguintes; passar rodadas/mando/campeonato direto numa tool específica tem prioridade só naquela chamada.
confronto_scouts
ChatGPTCruza o que o jogador CONQUISTA vs o que o adversário da rodada CEDE, scout a scout. DOIS MODOS — (1) id/atleta_id → de um jogador; (2) posicao + top_n (sem jogador) → ranking da posição por qualidade do confronto. Identifique por id/atleta_id. Use para "como é o confronto do [jogador]", "melhores matchups de [posição]". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
confrontos_rodada
ChatGPTLista os jogos da rodada atual com mandante e visitante.
consistency_analysis
ChatGPTClassifica jogadores em buckets de consistência: ELITE (alto piso + alto teto), ANCORA_CONFIAVEL (piso alto, teto baixo), DIFERENCIAL_ARRISCADO (piso baixo, teto alto), EVITAR. Retorna percentis (p25/p50/p75/p90), desvio padrão, blank rate, consistency index. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
cruzamento_quadrantes
ChatGPTCruzamento por zona do campo: onde o jogador conquista um scout vs onde o adversário cede. Identifica sobreposição de zonas quentes. Prefira id/atleta_id. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
curso_aula
ChatGPTConteúdo de uma aula específica do curso (resumo, pontos-chave, conceitos, link e tools relacionadas). Use quando o usuário quiser aprofundar numa aula ("me explica a aula X", "detalha a aula do capitão"). Passe "numero". Por padrão não traz a transcrição inteira; passe incluir_transcricao=true se o usuário pedir.
curso_buscar
ChatGPTBusca no CURSO Cartomante FC (curso em vídeo sobre Cartola, do método ao "como fazer"). Acha as aulas que falam de um tema e devolve resumo + trecho + LINK no minuto exato do vídeo. Use quando o usuário perguntar "como o curso ensina X", "tem aula sobre Y", "o que o método diz sobre Z", ou quando uma explicação se beneficiar do conteúdo do curso. Muitas aulas têm tools_relacionadas — depois de ensinar, ofereça aplicar nos dados ao vivo.
curso_listar
ChatGPTLista todas as aulas do curso Cartomante FC (número, título, módulo, tópicos, link). Use para "o que tem no curso", "lista as aulas", "quais aulas sobre estratégia".
definir_reserva_luxo
ChatGPTANALISA qual reserva vale mais como RESERVA DE LUXO (pontua se superar titular da mesma posição) — normalmente ATA. Esta tool só RECOMENDA; para GRAVAR a escolha na escalação atual, chame aplicar_troca_estado com adicionar_atleta_id do reserva escolhido + reserva_luxo=true. Prefira ids. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
detalhar_clube
ChatGPTEstatísticas defensivas detalhadas de um clube. Use para "como está a defesa do [clube]", "stats defensivas do [clube]". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
detalhar_jogador
ChatGPTFicha do jogador: média filtrada, próximo adversário e mando. DOIS MODOS — (1) id/atleta_id de um jogador → ficha individual; (2) posicao + top_n (sem jogador) → tabela comparativa da posição. Identifique por id/atleta_id, nunca por apelido. Use para "como está o [jogador]", "tabela dos [posição]". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
distribuicao_fechamentos
ChatGPTPara geração de MÚLTIPLOS times: distribui os fechamentos de defesa (GOL+ZAG+LAT+TEC do mesmo clube) entre as equipes ao longo de N variações. Rankeia clubes por SG potencial (stats + odds), determina quantos fechar e atribui pesos (quantos times) a cada um. Retorna a base ideal e o custo por clube. Use para "distribuir defesas nos meus times", "quantas defesas fechar".
enriquecer_time
ChatGPTRecebe o JSON CRU do time (a resposta de /time/id que o cliente buscou via escalacao_confirmada) e devolve enriquecido: posição por extenso, clube, foto, PE (pontuação esperada da próxima rodada), status e capitão. É stateless e respeita o "campeonato". Use sempre logo após escalacao_confirmada.
escalacao_atual
ChatGPTBusca a escalação atual (rascunho) da conta Cartola do usuário, NO CAMPEONATO ATIVO da conversa (Brasileirão OU Copa do Mundo — a API certa é escolhida pelo filtro de campeonato). Lê PELO SERVIDOR — use quando seu host NÃO faz requisições HTTP (ex.: claude.ai); se faz, prefira escalacao_confirmada + enriquecer_time para ler do IP do cliente. Retorna os 11 titulares + reservas com nome, posição, clube, preço, PE (pontuação esperada), capitão, reserva de luxo, esquema tático e valor total. Requer conta Cartola conectada.
escalacao_confirmada
ChatGPTDevolve a RECEITA para o CLIENTE buscar o time da RODADA ATUAL de uma conta DIRETO na API do Cartola, do próprio IP do cliente — aliviando a plataforma e distribuindo o limite de 100 req/min do Cartola por usuário. A receita já vem com a URL certa por campeonato (Brasileirão vs Copa) e o header Authorization: Bearer <token da conta>. Use quando o usuário pedir "o que tenho escalado"/"meu time" E o seu host conseguir fazer requisições HTTP: faça o GET com o header e passe o JSON cru para enriquecer_time. Se o host NÃO faz fetch (ex.: claude.ai), use escalacao_atual. Passe time_id (de listar_contas_cartola) ou tenha uma conta selecionada.
escalacao_provavel
ChatGPTEscalação PROVÁVEL de um clube para a rodada. A FONTE respeita o filtro provavel: "cartola" (PADRÃO) usa os prováveis do mercado Cartola (status provável); "cartomante" usa o NOSSO consolidado (SofaScore + GE + Oficial). Devolve o esquema, os 11 titulares agrupados por posição (com preço, média FILTRADA e PE), o TÉCNICO, o adversário e a justificativa. A média e o PE de cada jogador respeitam os filtros da conversa. Use quando o usuário perguntar "qual a provável escalação do [time]?", "quem joga no [time]?", "escalação provável do [time]". Prefira nome do clube. NÃO precisa da conta Cartola. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
escolher_capitao
ChatGPTAnalisa os titulares escalados e recomenda o melhor capitão (bônus 50%). Prioriza: ATA > MEI > LAT (raríssimo). Nunca GOL/ZAG. Prefira ids. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
escolher_tecnico
ChatGPTEscolhe o técnico para a escalação. Prioriza o técnico do clube com mais jogadores titulares na escalação. Prefira ids.
exportar_pesos
ChatGPTGRAVA no Firebase (coleção "pesos") da conta do assinante os pesos/tiers da geração de MÚLTIPLOS times — é o que o app do Cartomante FC usa pra montar as escalações em massa. Calcula no servidor (MME Completo por padrão; modo="analise_final_pesos" usa a consolidação final) e exporta. ESCREVE na conta do usuário — só chame após o usuário pedir explicitamente ("exportar os pesos", "mandar pro Firebase", "salvar a estratégia de loteria"). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
forma_recente
ChatGPTÍndice de forma recente: média ponderada das últimas 5 rodadas (peso decrescente), tendência (subindo/caindo/voltando), classificação (EM_ALTA/ESTAVEL/EM_QUEDA/FRIO). Use para "tá em forma?", "tá jogando bem?", "momento atual". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
game_environment
ChatGPTAnalisa ambiente de cada jogo da rodada: gols esperados (over/under), probabilidade de clean sheet, classificação (SHOOTOUT/OVER/EQUILIBRADO/UNDER). Quando odds de mercado estão disponíveis, combina com stats históricas (60% odds / 40% stats). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
game_stacking
ChatGPTOportunidades de stacking por jogo: team stacks (2-3 jogadores do mesmo time) e bring-back stacks (atacante de um time + defensor do outro em jogos com muitos gols). Baseado em estratégia DFS profissional. AUTOSSUFICIENTE — calcula a exposição internamente (não precisa chamar pesos_exposicao antes). Use para "stacks por jogo", "empilhar jogadores do mesmo time". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
gerar_infografico
ChatGPTGera um INFOGRÁFICO HORIZONTAL 16:9 (HTML dark, tema Cartomante FC) a partir de uma análise e devolve um LINK público. FRONTEIRA: se o usuário pedir "story"/"storie"/"reels"/"vídeo"/imagem VERTICAL/9:16 (pra Instagram/WhatsApp Stories), use a tool gerar_story — NÃO esta (esta é o infográfico horizontal 16:9, sem vídeo). Use ESTA quando pedirem "infográfico"/"resumo visual"/"card" (horizontal) da última resposta. Passe em conteudo o TEXTO INTEGRAL da resposta a transformar (NÃO resuma!) e em titulo um título curto. Se o conteúdo for uma ESCALAÇÃO (time com 11 titulares, ou 12 com técnico), o infográfico mostra um CAMPINHO com os jogadores posicionados — passe escalacao (o objeto dados_para_salvar do montar_escalacao) para o campo sair 100% correto. O link fica pronto em ~40s (a página atualiza sozinha). Custa 10 créditos Cartomante por infográfico gerado (avise o usuário se ele não pediu explicitamente).
gerar_story
ChatGPTÉ A TOOL DE STORY. Use SEMPRE que o usuário pedir "story"/"storie"/"stories"/"reels"/"vídeo"/"vídeo vertical"/imagem 9:16 (pra Instagram/WhatsApp) da última resposta — ESTA, e não gerar_infografico (que é horizontal 16:9 e não faz vídeo). Gera um STORY VERTICAL 9:16 e devolve um LINK público com DOIS botões: "Download Imagem" (PNG) e "Download Vídeo" (vídeo animado 15s com música e um card final de CTA da IA — os elementos entram de forma ALEATÓRIA a cada geração, pra nenhum story ficar igual). Passe em conteudo o TEXTO INTEGRAL da resposta a transformar (NÃO resuma!) e em titulo um título curto. O link fica pronto em ~40s (a página atualiza sozinha). Custa 10 créditos Cartomante por story gerado (avise o usuário se ele não pediu explicitamente).
historico_scout
ChatGPTRanking de jogadores que mais produzem um scout específico (G, A, DE, DS, SG, FC, FS, F, etc). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
jogadores_de_uma_indicacao
ChatGPTMostra QUAIS JOGADORES estão em UMA indicação específica de um usuário (rodada atual), agrupados por posição, com apelido, clube, média e PE. Identifique por indicacao_id (de listar_indicacoes) OU por iduser (pega a indicação dele na rodada atual). Use para "quais jogadores o [usuário] indicou?", "o que tem na indicação X?". Só Brasileirão. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
jogadores_mais_indicados
ChatGPTRanking dos jogadores MAIS INDICADOS pela comunidade Cartomante na RODADA ATUAL — em quantas indicações cada um foi citado, com % dentro da posição. Dado AGREGADO/anônimo (não expõe quem indicou). Use para "quem são os mais indicados?", "jogador mais indicado da rodada", "os mais indicados de [posição]". Só Brasileirão. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
knapsack_escalacao
ChatGPTOtimizador matemático de escalação via Branch & Bound. Encontra a combinação ÓTIMA de 11 jogadores que maximiza PE total dentro do orçamento. Mais preciso que as heurísticas das propostas A/B/C. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
leverage_analysis
ChatGPTCruza nossos pesos de exposure com o ownership estimado do campo (via obvious_score). Identifica: OVERWEIGHT (apostamos mais que o campo), UNDERWEIGHT (apostamos menos), leverage plays (baixo ownership + alto score = diferencial). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
listar_campeonatos
ChatGPTLista os campeonatos disponíveis para análise (slug, nome, rodada atual). Use PRIMEIRO sempre que o usuário quiser escolher ou trocar o campeonato da conversa, ou mencionar um campeonato diferente do padrão. Depois da escolha, passe o slug no parâmetro "campeonato" de TODAS as outras tools.
listar_clubes_por_score_defensivo
ChatGPTRanking de clubes pela solidez defensiva (clean sheets e gols sofridos). Use para "quais as melhores defesas", "quem toma menos gol". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
listar_contas_cartola
ChatGPTLista as contas Cartola vinculadas ao assinante autenticado (time_id, nome e patrimônio NO CAMPEONATO ATIVO da conversa — Brasileirão ou Copa) e indica qual está selecionada. Use quando o usuário quiser usar tools da conta (escalacao_atual, escalacao_confirmada, avaliar_minha_escalacao, trocas...) e houver dúvida sobre qual conta usar, ou quando uma tool de conta pedir seleção.
listar_indicacoes
ChatGPTLista as INDICAÇÕES (dicas) que os usuários da COMUNIDADE Cartomante postaram para a RODADA ATUAL do Brasileirão: quem postou (autor), nome da indicação, quando postou e quantos jogadores indicou. Use para "quais indicações tem essa rodada?", "quem já colocou dicas?", "lista as indicações da comunidade". Só Brasileirão. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
listar_jogadores_por_clube
ChatGPTTodos os jogadores de um clube com médias. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
listar_jogadores_por_posicao
ChatGPTMelhores jogadores de uma posição pela média de pontos. Posições: GOL, LAT, ZAG, MEI, ATA, TEC. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
logo_cartomante
ChatGPTDevolve as URLs da LOGO oficial da Cartomante FC (imagens reais que servem 200) para usar em artes/posts (ex.: Instagram). Use SEMPRE que o usuário pedir "coloque a logo da Cartomante FC", "logo da marca", "usa o logo da Cartomante". Retorna a logo principal (quadrada/vertical) e a horizontal — escolha a que melhor cabe na arte.
manual_buscar
ChatGPTBusca no MANUAL do APLICATIVO Cartomante FC (COMO USAR o app: criar conta, assinar, vincular Cartola, comparar jogadores, geração/escalação automática de times, avaliação automática, ligas e grupos, compra/venda de escalações, estatísticas, arbitragem, gerenciador de contas, Cartomante BI, etc.). Responde dúvidas de "COMO FAZER algo no app" — devolve a seção certa + resumo/passo a passo + LINK no minuto exato do vídeo do manual. Use quando perguntarem "como faço X no app?", "onde vejo Y?", "como escalo/comparo/assino pelo aplicativo?". FRONTEIRA IMPORTANTE: o manual só ensina COMO USAR/ONDE FICA no app — NÃO responde DADO da rodada. Perguntas por dado real ("quais árbitros da rodada / árbitro que dá pênalti", "quem cede mais", "escalação provável", "quem indicar", "como está a arbitragem deste jogo") vão para as tools de DADOS (analise_arbitragem, cedidos_por_clube, escalacao_provavel, etc.), NÃO para o manual. Só caia no manual quando o usuário quiser aprender a MEXER no aplicativo. NÃO confundir com curso_buscar (CURSO = estratégia de Cartola; MANUAL = uso do aplicativo).
manual_listar
ChatGPTLista todas as seções do MANUAL do aplicativo Cartomante FC (número, título, duração, link). Use para "o que o manual cobre", "lista o manual do app", "quais tutoriais do aplicativo tem".
manual_secao
ChatGPTConteúdo de UMA seção específica do MANUAL do app (resumo, passo a passo/"como fazer", link). Use quando o usuário quiser aprofundar num tutorial ("detalha como gerar times no app", "a seção de arbitragem do aplicativo"). Passe "numero". incluir_transcricao=true traz a transcrição completa.
matchup_analysis
ChatGPTAnálise de matchup para a rodada atual: cruza produção do jogador com o que o adversário cede. Retorna Matchup Score, PE, produção ofensiva/defensiva, zonas de vulnerabilidade e — IMPORTANTE — dois campos distintos que NÃO devem ser confundidos: (1) 'oportunidade_adv.pts_que_adv_cede_a_pos' (alias 'cedido') = pontos que o ADVERSÁRIO costuma ceder à posição do jogador; mede fraqueza do rival, NÃO é defesa sólida do clube do jogador. (2) 'defesa_propria' = solidez defensiva do PRÓPRIO clube do jogador (cs_rate, media_gs); use este campo para justificar que um GOL/ZAG/LAT "tem defesa sólida". Use para avaliar se um jogador específico é bom nesta rodada. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
mee_etapa1_confrontos
ChatGPTMÉTODO MEE — Etapa/Módulo 1 (Análise Lógica dos Confrontos). Ranqueia os confrontos da rodada pela pontuação CEDIDA por cada clube em cada posição (quanto mais cede, mais favorável o confronto para quem enfrenta). Passe "posicao" para um ranking direto daquela posição. Não prioriza por grandeza/tabela/mando — só pelos números. Use quando o usuário pedir o método estruturado, "análise dos confrontos", "onde atacar na rodada". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
mee_etapa2_tira_teima
ChatGPTMÉTODO MEE — Etapa/Módulo 2 (Tira-Teima / Seleção). Candidatos por posição com esperada_proxima=(média+cedido)/2 e consistência=vezes_esperado/jogos. Priorize maior esperada_proxima; desempate por consistência. Passe "posicao". Use para "quem escalar na posição X pelo método". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
mee_etapa3_comparacao
ChatGPTMÉTODO MEE — Etapa/Módulo 3 (Comparação Estratégica). Desempata jogadores empatados no Tira-Teima pelos scouts da posição: GOL=defesas, LAT/ZAG=desarmes, MEI=assistências+gols, ATA=gols+assistências. Passe "posicao" e "ids" (footstats) dos empatados (2+). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
mee_etapa4_balizamento
ChatGPTMÉTODO MEE — Etapa/Módulo 4 (Balizamento). Top 5 da temporada por posição para validar as escolhas; quem não está no Top 5 exige justificativa pelos dados do Tira-Teima. Passe "posicao" (opcional). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
melhor_reserva_luxo
ChatGPTRecomenda a MELHOR opção de RESERVA DE LUXO da rodada analisando MEIAS e ATACANTES disponíveis no mercado (NÃO precisa da conta Cartola). REGRAS: (1) só jogadores PROVÁVEIS e em JOGO VÁLIDO da rodada — NUNCA nulos, em dúvida ou sem jogo; (2) o indicado NÃO pode ser o mais caro da posição — tem que existir pelo menos 2 jogadores mais caros que ele na MESMA posição (senão ele seria titular, não reserva); (3) prioriza MAIOR potencial/teto, porque o reserva de luxo só pontua se SUPERAR o titular de menor pontuação da mesma posição. Use quando perguntarem "qual a melhor opção de reserva de luxo?" / "quem coloco de reserva de luxo?". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
melhor_tecnico
ChatGPTRanqueia os MELHORES TÉCNICOS da rodada. O técnico pontua pelo RESULTADO do time dele (vitória + saldo de gols/clean sheet), então cruza a MÉDIA do técnico com a chance do time VENCER (odds) e de não sofrer gol (clean sheet). Considera só técnicos PROVÁVEIS de times que JOGAM a rodada. Use quando perguntarem "qual o melhor técnico da rodada?", "que técnico pego?", "melhor técnico pra pegar". NÃO precisa da conta Cartola — analisa o mercado. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
meus_dados
ChatGPTRetorna os dados do próprio assinante autenticado: id, e-mail, plano (descrição e VALIDADE/vencimento), vip, SALDO de créditos Cartomante e o campeonato/filtros ativos da conversa. Use quando o usuário perguntar "quantos créditos eu tenho?", "qual meu plano / até quando minha assinatura vale?", "meus dados", "minha conta". Somente leitura; não cobra crédito.
minimo_valorizar
ChatGPTRanking oficial de VALORIZAÇÃO: jogadores com a MENOR pontuação mínima necessária para valorizar na rodada (quanto menor, melhor/mais fácil valorizar). Dado direto do Cartola (minimovalorizar). Use APENAS quando o cartoleiro pedir valorização/ganhar cartoletas como prioridade — valorização NUNCA entra como critério nas recomendações normais, e custo-benefício (pontos por preço) NUNCA é critério de nada. Só vale para o Cartola/Brasileirão.
minutagem_rotacao
ChatGPTAnálise de minutagem e risco de rotação. Classifica em TITULAR_ABSOLUTO, TITULAR, RODIZIO, RESERVA baseado na taxa de participação em jogos. Use para "joga sempre?", "risco de rotação", "titular absoluto?". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
mme_completo
ChatGPTMME Completo para gerar MÚLTIPLOS times: combina os tiers de jogadores por posição (core/secondary/leverage) + a distribuição de fechamentos de defesa por clube (PRIMARY/SECONDARY/LEVERAGE), tudo em uma chamada. Use para "MME completo", "estratégia de loteria/múltiplas escalações". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
mme_tiers
ChatGPTTiers DFS para gerar MÚLTIPLOS times (MME): classifica jogadores por posição em core (proteção), secondary (diferencial qualificado) e leverage (contrarian). Calcula índice de concentração Herfindahl, jogadores efetivos, alertas de risco. AUTOSSUFICIENTE — calcula a exposição internamente (não precisa chamar pesos_exposicao antes). Use para "tiers de jogadores", "MME", "montar vários times". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
montar_escalacao
ChatGPTPipeline completo de escalação. Gera 4 propostas base (A-pontuação, B-equilibrada, C-econômica, D-fechamento defesa) + 1 proposta de ESTRATÉGIA se solicitada. Estratégias: stars_and_scrubs, balanced, mid_range, barbell, stacking, game_stack, bring_back, ceiling, floor, regression, captain_differential. Cada proposta: 11 titulares + capitão + técnico + reservas. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
montar_escalacao_mee
ChatGPTMÉTODO MEE COMPLETO — roda os 4 módulos de uma vez e devolve TODOS os dados (confrontos do Módulo 1, Tira-Teima do Módulo 2, balizamento do Módulo 4) + as regras, a regra de conflito e o esquema 4-3-3, para a IA montar a escalação estruturada aplicando o método. Use quando o usuário pedir "monta meu time pelo método", "escalação estruturada", "aplica o MEE completo". NÃO efetiva — devolve os dados; para salvar na conta use salvar_escalacao. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
monte_carlo_capitao
ChatGPTSimulação Monte Carlo (5000 cenários) para escolha de capitão. Retorna win_rate (% de vezes que cada jogador foi o melhor capitão), P10/P50/P90, upside probability. Mais preciso que captain_ev para decisões de risco. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
odds_mercado
ChatGPTMostra as odds de mercado (casas de aposta) para cada jogo da rodada: probabilidade implícita de vitória, clean sheet e over 1.5 gols por clube. Dados complementares às análises estatísticas.
ownership_leverage_sg
ChatGPTEstratégia de leverage de defesas (SG): para achar clubes "fortes de verdade mas pouco percebidos". Cruza profundidade (sg_score completo = cs_rate próprio + sg_cedido do adv + odds) vs superfície (cs_rate + prob_cleansheet — métricas que todo escalador olha primeiro). Ownership é INFERIDO do que o público vê, não de maisescalados. Classifica em CHALK (superfície alta + profundidade alta), LEVERAGE (profundidade alta + superfície baixa — forte de verdade mas ninguém percebe), TRAP (superfície alta mas profundidade baixa — crowd vai errar), FADE (ignorar). Medianas adaptativas à rodada. Use para "defesas diferenciais", "qual defesa fechar que ninguém vai". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
ownership_proxy
ChatGPTMostra o ownership REAL (% de escalações do campeonato, dado oficial do Cartola) por jogador. Classifica em CHALK (muito escalados) vs LEVERAGE (poucos escalaram mas com indicadores fortes = diferencial). Use para "quem mais escalou", "quero me diferenciar", "jogador popular/óbvio". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
perfil_jogador_completo
ChatGPTRadiografia completa: scouts por jogo, taxas de conversão, distribuição por zona do campo, comparação com média da posição. Prefira id/atleta_id. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
pesos_exposicao
ChatGPTMotor de geração de MÚLTIPLOS times (loteria/DFS): calcula pesos e taxa de exposição por jogador via 17 dimensões analíticas com pesos assimétricos por posição (sg_clube favorece defensores com sg_score do próprio time; atacantes/meias usam matchup + vulnerabilidade do adv). Classifica cada jogador em CHALK/LEVERAGE/TRAP/FADE por quadrantes (score_composto × PE). Modo adaptativo: ratio < 5 (concentrado 55/35/5/0 com tercis+zona morta), ratio >= 5 (expandido 50/35/10/5 com mediana). Todos os jogadores aparecem no pool (não-classificados com peso=0). Use para "gerar N times", "exposição/pesos por jogador", "loteria". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
pontuacao_esperada
ChatGPTPontuação esperada (PE) na rodada = (média do jogador + o que o adversário cede à posição) / 2. DOIS MODOS — (1) id/atleta_id → PE de um jogador; (2) posicao + top_n (sem jogador) → ranking da posição por PE. Identifique por id/atleta_id. Use para "qual a média esperada do [jogador]", "melhores PE de [posição]". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
prever_placar
ChatGPTPREVISÃO de resultado/gols dos jogos da rodada — responde "quanto será o resultado do jogo?", "quantos gols vai ter?", "qual o placar provável?". Estima os gols esperados de cada lado cruzando os SCOUTS de gols (feitos e sofridos/cedidos pelos times) com as ODDS de over 1.5 e de clean sheet (blend 60% odds / 40% stats quando há odds). Devolve o PLACAR PROVÁVEL, os gols esperados por time, o total e o "ambiente" do jogo (SHOOTOUT/OVER/EQUILIBRADO/UNDER). Passe nome_clube para prever só um jogo. É uma ESTIMATIVA, não garantia. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
price_rise_prediction
ChatGPTPrevê jogadores com maior probabilidade de pontuar acima da média e valorizar na rodada. Combina: matchup favorável, xG proxy, consistência. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
producao_por_zona
ChatGPTRanking de JOGADORES por PONTOS gerados numa REGIÃO do campo (lado esquerdo/central/direito × ataque/meio/defesa). Responde "quem faz mais ponto pelo lado direito?", "quem mais pontua atacando pela esquerda?", "melhores desarmes pela direita". Soma peso Cartola × quantidade dos scouts no quadrante de ATUAÇÃO do jogador (grid 6×6). Combine lado e setor (ex.: setor=ataque + lado=direita). Filtre scouts (ex.: ["DS"] p/ desarmes), posição e/ou clube. Respeita rodadas/mando. Cada jogador vem com por_quadrante (1-36) e uma matriz grid 6×6 (topo=ataque, base=defesa; esquerda→direita) pronta pra renderizar como CAMPINHO/heatmap no client. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos. cedida_individual: PADRÃO false (cedido do adversário por POSIÇÃO); true usa a cedida INDIVIDUALIZADA por jogador (afeta PE e matchup_analysis). excluir_mais_escalados: PADRÃO false; true monta/indica SEM os jogadores mais escalados (ownership > ~15%). max_ownership=N: exclui quem tem mais de N% de escalação (ajuste fino).
ranquear_jogadores_posicao
ChatGPTRanqueia uma lista de jogadores da mesma posição via score composto (min-max normalização + pesos). Métricas por posição — GOL: meta, potencial, média_mando, cede_adv, SG, defesa. LAT/ZAG: meta, potencial, média_mando, cede_adv, SG, DS, F, G, A. MEI/ATA: meta, potencial, média_mando, cede_adv, DS, F, G, A. Candidatos preferem id/atleta_id. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
regression_analysis
ChatGPTDetecta over/underperformers: compara média longa vs curta (últimas 3 rodadas) e mede divergência em desvios padrão. Overperformers = risco de queda (vender). Underperformers = candidatos a retomada (comprar). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
scouts_clube
ChatGPTScouts agregados de todos os jogadores de um clube. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
scouts_jogador
ChatGPTScouts conquistados por um jogador (gols, assistências, etc). Prefira id/atleta_id. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
selecionar_conta_cartola
ChatGPTSeleciona a conta Cartola ativa do assinante (persiste no servidor para as próximas chamadas e conversas). Obrigatória quando o assinante tem mais de uma conta — com uma só, a seleção é automática. Passe o time_id retornado por listar_contas_cartola.
stacking_analysis
ChatGPTAnalisa correlação (Pearson) entre pares de jogadores do mesmo clube para identificar stacks eficientes. Retorna pares com correlação forte/moderada, ideal para escalar juntos. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
sugerir_reservas
ChatGPTSugere 5 reservas (1 por posição) para substituir titulares que não joguem. Reservas devem ser mais BARATOS que os titulares da mesma posição. Prefira ids. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
sugerir_substitutos
ChatGPTLista os melhores substitutos para um jogador específico (mesma posição, dentro do orçamento). Use SEMPRE que recomendar trocar/substituir um jogador — devolve candidatos com atleta_id prontos para a troca (basta chamar aplicar_troca_estado com o escolhido). Respeita o patrimônio do estado atual; sem patrimônio aceita até +15% do preço do que sai.
sugestoes
ChatGPTRetorna o ESTADO atual (campeonato, rodada, jogos de hoje, filtros ativos, saldo de créditos) + 5 sugestões de início e um catálogo resumido das capacidades. Use NO INÍCIO da conversa (primeira mensagem, ou quando o usuário disser "oi", "o que você faz", "por onde começo", "me dá sugestões"). REGRA: se a conversa JÁ tem histórico, NÃO repita as sugestões genéricas — proponha 5 próximos passos relacionados ao que já foi discutido (a tool não conhece o histórico; você adapta). Apresente como lista curta. Somente leitura; não cobra crédito.
tabela_campeonato
ChatGPTClassificação do campeonato: vitórias, empates, derrotas, gols, pontos. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
taxa_conversao
ChatGPTRanking de eficiência ofensiva: conversão de finalizações em gol (G/F), contribuição ofensiva (G+A)/jogo, volume defensivo (DE+DS)/jogo. Use para "quem é mais eficiente/decisivo", "quem mais finaliza/converte". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
tira_teima
ChatGPTConfiabilidade: quantas vezes o jogador entregou 80%+ da pontuação esperada. DOIS MODOS — (1) id/atleta_id → de um jogador; (2) posicao + top_n (sem jogador) → ranking da posição por confiabilidade. Identifique por id/atleta_id. Use para "o [jogador] é confiável?", "quem mais entrega em [posição]". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
top_jogadores_filtrado
ChatGPTRanking de jogadores por média de pontos, com filtros de posição, mando e rodadas. Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
vulnerabilidade_clube
ChatGPTPerfil de fragilidade de um clube: quais scouts mais cede por posição, com distribuição por zona do campo. Use para "onde o [clube] é frágil", "por onde atacar o [clube]". Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
xg_proxy
ChatGPTxG/xA aproximado via finalizações por quadrante de campo × peso de conversão. Identifica jogadores SUBVALORIZADOS (finalizam mais do que convertem → tende a melhorar) e SUPERVALORIZADOS (convertem demais → risco de regredir). Opcional: rodadas=N para considerar apenas as últimas N rodadas. mando="rodada_atual"|"mandante"|"visitante"|"todos" para filtrar por mando de campo. provavel="cartola" (padrão, status_id do mercado) ou "cartomante" (provável da Cartomante FC: SofaScore+GE+Oficial). jogos_validos: PADRÃO true (só jogos válidos pelo Cartola na rodada); false inclui não-válidos.
