Para devs e agentes

Integrações programáticas

O DestaquesGovBr oferece três formas de acesso programático ao acervo do governo federal: uma API GraphQL tipada, um servidor MCP nativo para LLMs e um chat conversacional com agente especializado. Todas as três camadas compartilham a mesma base de dados — 500k+ notícias indexadas, enriquecidas e classificadas.

API GraphQL

em desenvolvimento

Uma interface única tipada para consultar e configurar tudo no DGB.

O que resolve

Hoje o portal consome dezenas de rotas REST fragmentadas. A API GraphQL substitui tudo por um schema único, com auto-documentação, playground interativo e codegen TypeScript para o frontend. Workers e DAGs externos passam a ter uma superfície de consulta padronizada.

Modelo de autenticação

Duas camadas: JWT para usuários autenticados do portal (via Gov.Br OIDC) e OIDC de service account para workers, DAGs e integrações internas. Queries públicas de catálogo permanecem sem auth.

Superfície planejada

Queries

  • articles, search, searchSuggestions
  • themes, agencies, popularTags
  • analyticsKpis, topThemes, articlesTimeline
  • clippings, marketplaceListings, clippingEstimate

Mutations

  • CRUD de clippings: createClipping, updateClipping, deleteClipping
  • Marketplace: publishToMarketplace, likeMarketplaceListing, followMarketplaceListing
  • Notifications: syncPushSubscription
Ver repositório

Servidor MCP

em desenvolvimento

Model Context Protocol para integração nativa com Claude Desktop, ChatGPT e agentes customizados.

O que é MCP

Model Context Protocol é um padrão aberto para conectar assistentes de IA a fontes de dados e ferramentas. Um servidor MCP expõe tools (ações), prompts (templates guiados) e resources (leitura direta), e o cliente LLM descobre tudo automaticamente. Sem glue code, sem APIs customizadas — o agente fala direto com o DGB.

Tools disponíveis

  • search_news — busca textual + semântica com filtros
  • get_facets — agregações por agência, ano, tema, categoria
  • similar_news — artigos similares a um dado artigo
  • analyze_temporal — análise temporal (yearly/monthly/weekly)

Prompts guiados

O servidor também oferece prompts prontos para análises comuns, acessíveis diretamente no menu do Claude Desktop:

analyze_themecompare_agenciestemporal_evolutiondiscover_context

Chat conversacional

em breve

Agente de IA especializado em análise da comunicação governamental, fundamentado no acervo do DGB.

Como vai funcionar

Uma interface conversacional dentro do próprio portal, com um agente pré-configurado que já conhece o acervo, a árvore temática, as agências e os padrões de publicação. Por baixo, o agente usa o servidor MCP para consultar dados e renderizar visualizações — o usuário só precisa fazer perguntas em linguagem natural.

Casos de uso

  • "Compare o volume de publicações do MMA e do ICMBio nos últimos 3 meses"
  • "Quais temas mais cresceram na comunicação do MEC desde janeiro?"
  • "Me mostre as notícias mais relevantes sobre reforma agrária desta semana"
  • "Há alguma convergência narrativa entre saúde e economia no último mês?"

Quer construir algo em cima do DGB?

Se você está desenvolvendo um sistema dentro de um órgão, montando um agente para análise da comunicação governamental ou explorando como conectar o DGB ao seu workflow, fale com a gente. Ajudamos a mapear o melhor caminho.

Integração — DestaquesGovBr