> ## Documentation Index
> Fetch the complete documentation index at: https://nomos.pro/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> A API Nomos tem base em https://api.nomos.pro e autentica pelo header `x-api-key`.
> Todos os endpoints de busca são POST. Parâmetros de consulta (page, limit, sort, q, modes) vão na query string; palavras-chave e filtros vão no corpo JSON.
> `limit` é limitado a 20 resultados por página. Para conjuntos maiores, itere sobre `page`.
> Filtros de data exigem `from` e `to` juntos. Enviar apenas `to` retorna erro 400.
> Filtros por ID (authors, rapporteurs, organs, themes, situations, stakeholders) exigem IDs internos reais devolvidos por uma busca anterior. IDs inventados não geram erro: retornam zero resultados silenciosamente.
> Filtros de valor aberto (type, regimes, section, openDataResource) não são listas fechadas. Deixe-os vazios para buscar em todas as fontes.
> Para uso conversacional ou por agentes, prefira o servidor MCP hospedado da Nomos em vez de chamar a API diretamente.

# Monitorar temas legislativos

> Buscar um tema na plataforma Nomos, filtrar por tramitação e data, e transformar a busca em monitoramento contínuo com alerta por e-mail.

Uma busca responde o que existe hoje. Um monitoramento responde o que mudou desde ontem, sem que
ninguém precise lembrar de repetir a busca. Esta lição vai da primeira até o segundo.

Ao final você terá um painel que recebe, por e-mail, cada nova movimentação de um tema que você
escolheu, em qualquer das 433 fontes que a Nomos acompanha.

<iframe src="https://www.loom.com/embed/0dd8f545cf694e32a643af10c66ef602" title="Como monitorar temas legislativos na plataforma Nomos" frameBorder="0" allowFullScreen style={{ width: '100%', aspectRatio: '16 / 9', borderRadius: '0.5rem' }} />

O passo a passo abaixo cobre o mesmo conteúdo do vídeo, em texto.

<Steps>
  <Step title="Entre na plataforma">
    Acesse a plataforma e faça login com suas credenciais. Confirme que você aparece identificado no
    canto da tela antes de continuar, porque painéis e alertas ficam vinculados à sua conta.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-1.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=988ceff926d276d112d9a410c28287d8" alt="Tela de login da plataforma Nomos" width="1156" height="720" data-path="images/aprender/monitorar-temas/passo-1.webp" />
    </Frame>
  </Step>

  <Step title="Abra a busca">
    A barra de busca fica no topo da tela e está sempre visível, em qualquer seção da plataforma.
    Digite as palavras-chave do tema que você acompanha.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-2.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=35eedad4a813e98e5489c5256c767c21" alt="Barra de busca no topo da plataforma" width="1156" height="720" data-path="images/aprender/monitorar-temas/passo-2.webp" />
    </Frame>
  </Step>

  <Step title="Adicione os termos">
    Digite o primeiro termo e pressione **Enter** para fixá-lo. Repita para cada termo relacionado.
    Quando terminar de montar a lista, pressione **Enter** novamente para executar a busca.

    Para acompanhar o setor elétrico, por exemplo, comece por `energia` e acrescente `fotovoltaica`.
    Termos adicionais ampliam o resultado: a busca retorna o que contém qualquer um deles.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-3.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=cfbf07b7bd7dec68711f9cd16e1d975d" alt="Vários termos de busca fixados na barra" width="1600" height="990" data-path="images/aprender/monitorar-temas/passo-3.webp" />
    </Frame>
  </Step>

  <Step title="Leia o resultado">
    A plataforma busca em todos os domínios ao mesmo tempo: proposições, eventos, diários oficiais,
    discursos, notícias e redes sociais. O resultado vem agrupado por tipo de fonte.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-4.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=e02baaad409df637da5ae840e737c8eb" alt="Resultados da busca agrupados por fonte" width="1156" height="720" data-path="images/aprender/monitorar-temas/passo-4.webp" />
    </Frame>
  </Step>

  <Step title="Filtre por situação">
    Abra o filtro na coluna à esquerda e escolha **Status de tramitação**. Selecionar `tramitando`
    remove as proposições já arquivadas, que costumam dominar o resultado bruto de temas antigos.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-5.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=89106aad548613da2d369c85b8d302eb" alt="Filtro de status de tramitação" width="1600" height="995" data-path="images/aprender/monitorar-temas/passo-5.webp" />
    </Frame>
  </Step>

  <Step title="Filtre por data">
    Use **Período de criação** para limitar por data de apresentação, ou **Período de atualização**
    para limitar por movimentação recente.

    A diferença importa. Uma proposição de 2019 que se moveu ontem aparece no segundo filtro e não
    no primeiro, e normalmente é ela que interessa.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-6.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=9769659407b0ec99f24c0051ce836f17" alt="Filtro por período de criação ou atualização" width="1600" height="988" data-path="images/aprender/monitorar-temas/passo-6.webp" />
    </Frame>
  </Step>

  <Step title="Transforme a busca em monitoramento">
    Este é o passo que troca a busca manual pelo acompanhamento contínuo. Escolha o painel de
    monitoramento que vai receber o tema, defina a prioridade e registre o posicionamento da sua
    organização sobre o item.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-7.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=14d196848d2423fc4c40279b9c250aab" alt="Envio da busca para um painel de monitoramento" width="1600" height="986" data-path="images/aprender/monitorar-temas/passo-7.webp" />
    </Frame>
  </Step>

  <Step title="Configure o alerta">
    Escolha quais tramitações disparam aviso, ou deixe todas. Depois escolha a frequência: tempo
    real ou resumo diário. Salve.

    A partir daqui, cada nova movimentação no tema chega à sua caixa de e-mail sem nenhuma ação sua.

    <Frame>
      <img src="https://mintcdn.com/nomos-81de60e4/1-N5e5hWKf5G8CLx/images/aprender/monitorar-temas/passo-8.webp?fit=max&auto=format&n=1-N5e5hWKf5G8CLx&q=85&s=589e6bdca762e5ddeb8fe633de85d502" alt="Configuração de frequência dos alertas" width="1600" height="988" data-path="images/aprender/monitorar-temas/passo-8.webp" />
    </Frame>
  </Step>
</Steps>

## Boas práticas

<AccordionGroup>
  <Accordion title="Um painel por tema, não um painel por pessoa">
    Painéis organizados por tema sobrevivem à troca de quem cuida deles. Painéis organizados por
    pessoa viram órfãos na primeira mudança de time.
  </Accordion>

  <Accordion title="Revise os termos a cada trimestre">
    A linguagem legislativa muda. Um termo que capturava tudo em 2024 pode estar perdendo matéria
    nova que usa outra palavra. Rode a busca sem filtro de data de vez em quando e veja o que aparece.
  </Accordion>

  <Accordion title="Comece amplo e feche depois">
    É mais fácil reduzir ruído com filtros do que descobrir o que a busca deixou passar. Comece com
    termos genéricos, veja o volume e feche a partir daí.
  </Accordion>
</AccordionGroup>

## Próximo passo

<CardGroup cols={2}>
  <Card title="Conceitos de busca" icon="magnifying-glass" href="/docs/conceitos">
    A mesma gramática de busca, exposta pela API para quem quer automatizar.
  </Card>

  <Card title="Servidor MCP" icon="robot" href="/docs/servidor-mcp">
    Fazer esta mesma busca a partir do Claude ou do ChatGPT.
  </Card>
</CardGroup>
