Skip to main content
Glama

Expeditto

Seu segundo expediente, resolvido. Assistente da burocracia docente. Hoje ele prepara o Relatório Individual de Trabalho (RIT) do SUAP IFMA: garimpa seus comprovantes, organiza por semestre e tópico, redige os relatos e deixa o rascunho salvo no SUAP para você conferir e entregar.

Ferramenta independente e não oficial. Roda no seu computador, com a sua sessão do SUAP, e nunca entrega o relatório por você. Licença AGPL-3.0.

Funciona pelo terminal (expeditto) e dentro do seu assistente de IA (servidor MCP para Claude Desktop, Claude Code, Codex e Gemini/Antigravity CLI).

Instalação

Windows (PowerShell):

irm https://expeditto.fabitz.com.br/install.ps1 | iex

macOS e Linux:

curl -LsSf https://expeditto.fabitz.com.br/install.sh | sh

O instalador coloca o uv se faltar, instala o Expeditto e abre o assistente expeditto instalar: navegador para o login, pasta de dados, conexão com os apps de IA (Claude Desktop, Claude Code, Codex, Gemini CLI, Antigravity), login no SUAP e diagnóstico. Depois: expeditto atualizar e expeditto desinstalar (tira o Expeditto dos apps; os dados só saem se você pedir).

Related MCP server: Apps Script + Sheets + Shopee CSV MCP

Interface visual (terminal)

uv sync
uv run expeditto                  # tela cheia: semestres, preparar RIT, pendências, anexos, relatos, salvar
uv run expeditto --semestre 2025.2 --alto-contraste
uv run expeditto doctor           # diagnóstico: navegador, sessão, apps de IA conectados

O despertador laranja é o mascote do Expeditto (pixel art em docs/marca/). Mouse e teclado funcionam em todas as telas; em janelas pequenas o mascote dá lugar ao conteúdo.

Uso (comandos)

uv run expeditto login            # janela do SUAP para login (CAPTCHA/Gov.br); fecha sozinha
uv run expeditto semestres        # estado do PIT/RIT por semestre + links
uv run expeditto coletar 2025.1   # coleta, classifica e baixa comprovantes
uv run expeditto status 2025.1    # resumo por tópico + pendências
uv run expeditto montar 2025.1    # 1 PDF por tópico (capa + índice), ≤ 10 MB
uv run expeditto textos 2025.1    # rascunhos dos Relatos (HTML)
uv run expeditto entrada 2025.1   # onde colocar comprovantes próprios
uv run expeditto preencher 2025.1 [--salvar]   # prévia; com --salvar grava rascunho (nunca entrega)
uv run expeditto gmail-login / gmail-atas 2025.1   # backup de atas por e-mail
uv run expeditto mcp              # servidor MCP (ver docs/integracao-hosts.md)
uv run expeditto logout           # apaga a sessão do keyring e o perfil do navegador

O acervo fica em ~/expeditto/ (ou em EXPEDITTO_HOME):

perfil.json                      # contexto do docente (allowlist, sem dados sensíveis)
_cache/                          # downloads e textos de portarias, por chave estável
2025.1/manifest.json             # evidências, tópicos, motivos e pendências
2025.1/01-apoio-ensino/*.pdf     # uma pasta por tópico do RIT (cópia física)
...

Estado

O protótipo 1 foi validado com dados reais (2025.1): 72 evidências nos 7 tópicos, 65 delas comprovadas por 54 PDFs distintos, e 1 pendência legítima. Os números estão em docs/decisoes.md §10. Próximo passo: servidor MCP, Gmail, junção dos PDFs, textos e "Salvar" (protótipo 2).

Garantias

  • Somente leitura no protótipo 1. Nada é salvo nem enviado no SUAP.

  • Allowlist de rotas (client.py): só páginas e documentos do próprio usuário. /admin/, entregar_relatorio e enviar_plano ficam bloqueados.

  • Minimização de dados: o perfil lê só os campos da allowlist (D26). CPF, dados bancários, endereço etc. nem são extraídos.

  • Sessão no keyring do SO, válida por cerca de 90 min. A senha nunca passa pela ferramenta.

Testes

uv run pytest

Available Tools

26 tools
abrir_no_navegadorA
Idempotent

Abre no navegador do docente um link do SUAP, um PDF do acervo (file://) ou um DOI. Só esses: use os links que vieram nos resultados (links) quando o docente pedir para ver algo.

Inputs: url (required).

aguardar_tarefaA
Read-only

Acompanha uma tarefa em segundo plano (login, coleta). Volta em até segundos (padrão 10, máx. 25) ou antes, quando muda de etapa. Mostre a linha progresso ao docente a cada chamada e chame de novo.

Inputs: tarefa_id (required), segundos.

atualizar_expedittoA
DestructiveIdempotent

Atualiza o Expeditto para a versão mais nova. Só chame com confirmado=true se o docente pedir. Depois, o app de IA precisa ser reiniciado (ou o Expeditto reconectado) para usar a versão nova.

Inputs: confirmado.

buscar_atas_gmailA
Read-only

BACKUP para hosts SEM integração de e-mail: busca atas no Gmail das contas autorizadas na CLI (expeditto gmail-login). Devolve candidatas numeradas; o docente escolhe quais registrar.

Inputs: semestre (required).

classificar_entradaC
Idempotent

Move um arquivo solto da pasta de entrada para o tópico informado pelo docente.

Inputs: topico (required), arquivo (required), semestre (required).

coletar_semestreA
Idempotent

Coleta os comprovantes do semestre (AAAA.P) no SUAP, em segundo plano (2 a 8 minutos). Devolve tarefa_id: acompanhe com aguardar_tarefa, mostrando a barra ao docente.

Inputs: semestre (required).

completar_lattesA
Idempotent

Busca data, tipo (artigo, capítulo, anais...), veículo e DOI das publicações do Lattes pendentes em bases públicas (Crossref, OpenAlex), para sugerir o semestre de cada uma. A coleta já faz isso; use em coletas antigas ou quando os itens vierem sem data.

Inputs: semestre (required).

contexto_topicoC
Read-only

Fatos de um tópico para redigir o Relato. topico: apoio_ensino, programas_projetos_ensino, orientacao_alunos, reunioes, pesquisa, extensao, gestao.

Inputs: topico (required), semestre (required).

detalhar_pendenciaA
Read-only

Explica UMA pendência ao docente: o que é, por que importa, o efeito de cada opção, a sugestão e os links para conferir (SUAP, comprovante, DOI). Use quando ele tiver dúvida sobre um item.

Inputs: numero (required), semestre (required).

diagnosticoA
Read-only

Verifica se o Expeditto está pronto: versão, pasta de dados, navegador, sessão no SUAP, perfil, apps de IA conectados e e-mail. Cada item traz como_resolver quando há problema.

Inputs: verificar_suap.

gerar_alteracoesB
Idempotent

Monta 'Alterações de Atividades' a partir das pendências justificadas pelo docente.

Inputs: semestre (required).

gerar_rascunhosB
Idempotent

Gera rascunhos automáticos dos Relatos (não sobrescreve textos já revisados, salvo se pedido).

Inputs: semestre (required), sobrescrever.

guiaA
Read-only

Guia do Expeditto para você (assistente): fluxo, topicos, pendencias, relatos, lattes, regras. Leia fluxo no começo de uma conversa sobre o RIT e o assunto específico quando precisar.

Inputs: assunto. Returns: result

listar_semestresB
Read-only

Semestres com o estado do PIT/RIT e o link correspondente no SUAP.

Inputs: no named parameters. Returns: result

loginA
Idempotent

Abre uma janela do SUAP para o docente fazer login (CAPTCHA/Gov.br); ela fecha sozinha. Devolve tarefa_id: acompanhe com aguardar_tarefa e avise o docente para olhar a janela.

Inputs: no named parameters.

montar_anexosB
Idempotent

Gera o PDF de anexo de cada tópico (capa + índice + comprovantes, até 10 MB).

Inputs: semestre (required).

pasta_entradaC
Read-only

Onde o docente coloca comprovantes próprios (PDF/JPG/PNG), uma subpasta por tópico (E8).

Inputs: semestre (required).

preparar_ritA
Read-only

PONTO DE PARTIDA para qualquer pedido sobre o RIT (Relatório Individual de Trabalho), o relatório do semestre ou os comprovantes do SUAP. Diz em que passo o semestre (AAAA.P) está e qual ferramenta chamar em seguida. Sem semestre, lista os RITs a preencher para o docente escolher.

Inputs: semestre, seguir_sem_decidir.

previa_preenchimentoB
Read-only

O que será enviado ao formulário do RIT (textos e anexos) — mostre ao docente antes de salvar.

Inputs: semestre (required).

registrar_ataB
Idempotent

Registra uma ata/convocação encontrada no e-mail (pela integração de e-mail do host). data em dd/mm/aaaa ou aaaa-mm-dd. Envie o PDF anexo em base64 se tiver acesso a ele.

Inputs: data (required), assunto (required), semestre (required), remetente (required), +4 more.

registrar_atas_gmailB
Idempotent

Registra as candidatas escolhidas pelo docente (números de buscar_atas_gmail), baixando o PDF anexo.

Inputs: numeros (required), semestre (required).

resolver_pendenciaA
Idempotent

Registra a decisão DO DOCENTE sobre uma ou mais pendências (números vindos de preparar_rit/resumo_semestre). decisao: manter | remover_item | justificar (exige justificativa ditada pelo docente) | ignorar. Pendências 'lattes_sem_comprovante': se o docente tiver o comprovante, oriente-o a colocá-lo na pasta de entrada (ver pasta_entrada) e marque 'manter'; se não entra no RIT, 'ignorar'.

Inputs: decisao (required), numeros (required), semestre (required), justificativa.

resumo_semestreC
Read-only

Resumo do acervo do semestre: itens por tópico, pendências numeradas, anexos e textos.

Inputs: semestre (required).

salvar_no_suapA
DestructiveIdempotent

Grava textos e anexos no formulário do RIT como RASCUNHO ("Salvar"). Nunca entrega. Só chame com confirmado=true depois que o docente aprovar a prévia explicitamente.

Inputs: semestre (required), confirmado.

salvar_textoC
Idempotent

Grava o Relato (HTML simples: p, ul, li, strong) de um tópico ou de 'alteracoes'.

Inputs: html (required), topico (required), semestre (required).

verificar_atualizacaoA
Read-only

Diz se há versão nova do Expeditto (consulta a última release; cache de um dia).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 26 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (e.g. detalhar_pendencia vs resolver_pendencia, verificar_atualizacao vs atualizar_expeditto), and descriptions actively differentiate near-pairs. A few pairs risk confusion—salvar_texto vs salvar_no_suap, gerar_alteracoes vs gerar_rascunhos, coletar_semestre vs completar_lattes, registrar_ata vs registrar_atas_gmail—but the descriptions disambiguate them adequately.

    Naming Consistency4/5

    The set overwhelmingly uses Portuguese snake_case verb_noun names (gerar_alteracoes, salvar_no_suap, listar_semestres, coletar_semestre, montar_anexos). Minor deviations are noun-only names (guia, diagnostico, login, pasta_entrada, resumo_semestre, contexto_topico), which are still readable and consistent in style.

    Tool Count4/5

    26 tools is on the heavy side, but the domain (full RIT workflow spanning SUAP collection, Lattes completion, pendency resolution, text drafting, attachments, and Gmail backup) is genuinely broad and each tool appears to earn its place. Slightly over-scoped but defensible.

    Completeness4/5

    The surface covers the lifecycle well: preparation (preparar_rit), collection (coletar_semestre, completar_lattes), pendency decisions (resolver_pendencia), text (salvar_texto, gerar_rascunhos), attachments (montar_anexos), and submission (salvar_no_suap as draft). Minor gaps around deletion/editing of individual collected items, but agents can work around them.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers