Pular para o conteúdo

Projeto independente e não oficial. Não é canal de campanha, partido ou candidatura. Entenda

Dados da Virada

Desenvolvedores e IA

Como integrar

Tudo é público, somente leitura e sem cadastro. Escolha um dos dois caminhos: cada um tem três passos e o comando pronto para copiar.

Qual é o seu caso?

Caminho A: ligar um assistente de IA

O que é MCP, em uma frase: é um jeito padrão de ligar um assistente de IA a uma fonte de dados, para ele consultar a base na hora em vez de responder de memória.

1 Copie o endereço

É só disso que você precisa. HTTP, sem autenticação.

ORIGEM/mcp/

2 Cole no seu assistente

No Claude (site ou aplicativo de computador)

  1. Abra os conectores Vá em Configurações → Conectores.
  2. Adicione a base Escolha “Adicionar conector personalizado”, dê um nome (por exemplo, Dados da Virada) e cole o endereço do passo 1.
  3. Confira Em uma conversa nova, veja se o conector está ligado.

Os nomes dos menus podem mudar com o tempo, e a opção de conector personalizado pode depender do seu plano.

No Claude Code (terminal)

  1. Adicione o servidor Rode uma vez:
    claude mcp add --transport http dados-da-virada ORIGEM/mcp/
  2. Confira Rode claude mcp list. O nome dados-da-virada deve aparecer como conectado.
  3. Abra uma sessão O assistente pede licença antes de usar a ferramenta pela primeira vez.

Em outros clientes

Em clientes que aceitam configuração por JSON:

{"mcpServers": {"dados-da-virada": {"type": "http", "url": "ORIGEM/mcp/"}}}

3 Pergunte

Depois de conectar, pergunte como perguntaria a uma pessoa:

Dica: peça sempre o número do item e o link do original. Assim você confere antes de repassar.

Próximo passoVai mostrar o resultado para outras pessoas? Leia o aviso ↓

Caminho B: usar o arquivo JSON

Um único arquivo com todos os itens: /data/acervo.json.

1 Baixe e guarde uma cópia

Para construir uma aplicação, baixe o arquivo e guarde uma cópia; não consulte a cada acesso do seu usuário.

curl -s ORIGEM/data/acervo.json
curl -s ORIGEM/data/acervo.json -o acervo.json

2 Filtre o que interessa

Os três exemplos listam os itens do perfil idosos.

JavaScript

Funciona no Node 18 ou mais novo (arquivo .mjs) e no console do navegador, com esta página aberta.

const resposta = await fetch("ORIGEM/data/acervo.json");
const base = await resposta.json();

const paraIdosos = base.itens.filter((item) => item.perfis.includes("idosos"));
for (const item of paraIdosos) console.log(item.id, item.titulo, item.url);

Python

Só com a biblioteca padrão.

import json, urllib.request

with urllib.request.urlopen("ORIGEM/data/acervo.json") as resposta:
    base = json.load(resposta)

para_idosos = [item for item in base["itens"] if "idosos" in item["perfis"]]
for item in para_idosos:
    print(item["id"], item["titulo"], item["url"])

Terminal, com jq

jq -r '.itens[] | select(.perfis | index("idosos")) | .titulo' acervo.json

O servidor não envia cabeçalhos CORS. Uma página de outro site não consegue ler o arquivo direto pelo navegador: baixe o JSON e sirva a sua cópia.

3 Antes de publicar, mostre o aviso

Se a sua aplicação mostrar conteúdo desta base, mostre também o aviso: as afirmações registram o que o material diz. Só trate como verificada a afirmação que tiver o campo verificacao; as demais não foram verificadas. Itens de natureza sintetico-ia e satira-humor nunca devem ser apresentados como fato.

Próximo passoConfira os limites de uso ↓

Limites de uso

Referência

Ferramentas do servidor MCP

FerramentaO que faz
listar_facetasValores válidos de cada filtro, com contagem.
buscar_materiaisBusca por palavras e filtros (perfil, tema, formato, natureza...). Até 50 resultados.
obter_itemItem completo pelo id, com texto e afirmações extraídas. Quando uma afirmação já foi verificada, ela vem com o campo verificacao.
listar_fontesAs fontes de dados da base: papel de cada uma, volume, data de coleta e ressalvas.
buscar_referenciasBusca indicadores na base de referência. Parâmetros: consulta (palavras), fonte (opcional) e limite (até 20). Devolve os valores por período.
obter_referenciaIndicador completo pelo id, com a fonte primária, o link e o localizador de cada valor.
buscar_iniciativasBusca no diretório de iniciativas de terceiros. Parâmetros: consulta e categoria (opcional).

Campos de cada item do JSON

CampoDescrição
fonteDe qual fonte o item veio. Hoje, sempre curadoria-vira-voto. Os ids estão em /data/fontes.json.
id, titulo, descricao, data, tagsComo no acervo original. Ids repetidos na origem recebem sufixo (110b).
tipovideo, imagem, link, perfil, pdf
plataformainstagram, tiktok, x, youtube, facebook, telegram, google-drive, site, acervo
perfis, temasListas: a quem o item serve e do que trata.
recurso, colecao, regiaoPreenchidos quando o item é ferramenta, guia, formação, ou pertence a uma coleção.
naturezadado-infografico, opiniao-argumento, depoimento, satira-humor, sintetico-ia, ferramenta, formacao, guia-de-atuacao, tecnica-de-conversa. Inferida por regra enquanto natureza_revisada for false.
url, thumbnailEndereço do material original e da miniatura.
conteudoQuando existe: texto (transcrição), afirmacoes (cada uma com a fonte_citada pelo material, ou null), fontes_na_imagem, legibilidade, observacoes.
conteudo.afirmacoes[].verificacaoOpcional. Sem o campo, a afirmação não foi verificada. Quando existe: status (confirmada, confirmada-com-ressalva, desatualizada, divergente, fonte-nao-encontrada, nao-verificavel), nota, verificado_em, revisao_humana e evidencias (lista de url, tipo, trecho, sustenta; tipo é primaria, imprensa, checagem, referencia-compilada ou outra). A verificação é feita por agente de IA; revisao_humana diz se uma pessoa revisou. Como verificamos.
conteudo_retidoMotivo, quando o conteúdo extraído de um item não é publicado.

Outros arquivos de dados

ArquivoTamanhoConteúdo e campos
/data/fontes.jsoncerca de 2 KBAs fontes da base. id, nome, url, papel (materiais, iniciativas ou referencia), registros, observacoes (só nas de referência), data_de_corte, coletado_em, autoria, licenca, ressalvas.
/data/iniciativas.jsoncerca de 21 KBDiretório de iniciativas de terceiros. nome, url, descricao (do diretório), categoria, fonte. Catalogado por nós, abrindo cada site: o_que_encontra, temas, perfis, formatos, uso (mandar, preparar ou ambos), palavras_chave, abrangencia, situacao, verificado_em e na_busca (false para site fora do ar, site oficial de campanha ou que acusa pessoa nomeada; esses ficam só no diretório).
/data/referencias.jsoncerca de 2,5 MBBase de referência. id, fonte, area, indicador, unidade, nota, comparabilidade e observacoes: lista de periodo, valor, calculado, formula e fontes_primarias (instituicao, titulo, url, localizador, tipo). Alguns campos podem vir null.
/data/referencias-indice.jsoncerca de 125 KBÍndice leve da base de referência, usado pela busca da página inicial. fontes (id → nome) e indicadores: id, indicador, area, fonte. Os valores ficam só no arquivo completo.
/data/novidades.jsoncerca de 2 KBNovidades e próximos passos do projeto.

A base de referência e o diretório foram compilados por terceiros. Mostre a ressalva de cada fonte (campo ressalvas) junto com o dado. Veja as fontes.

Código

O código que sincroniza o acervo e serve esta página ainda não é público. Se você quer construir algo sobre a base e precisa de mais do que o JSON e o MCP oferecem, escreva para o contato no rodapé.

Próximo passoEntenda o campo de verificação e os seus limites →