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.
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)
- Abra os conectores Vá em Configurações → Conectores.
- Adicione a base Escolha “Adicionar conector personalizado”, dê um nome (por exemplo, Dados da Virada) e cole o endereço do passo 1.
- 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)
- Adicione o servidor Rode uma vez:
claude mcp add --transport http dados-da-virada ORIGEM/mcp/ - Confira Rode
claude mcp list. O nomedados-da-viradadeve aparecer como conectado. - 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:
- “Que materiais tenho para conversar com um eleitor evangélico indeciso?”
- “Mostre os dados com fonte sobre salário mínimo.”
- “Confira na base de referência o reajuste real do salário mínimo de 2023 a 2026.”
- “Existe alguma iniciativa com mapa de zonas eleitorais? Liste com o link.”
- “Vou falar com minha avó sobre aposentadoria. Que itens do acervo servem e o que cada um afirma?”
- “Liste as ferramentas do acervo, com o link de cada uma.”
- “No item 129, quais afirmações têm fonte citada e quais já foram verificadas?”
- “Monte um roteiro curto de conversa para um motorista de aplicativo, usando só itens do acervo e dizendo o número de cada item.”
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
- MCP: 60 requisições por minuto por endereço IP. Site e JSON: 240 por minuto.
- Acima disso o serviço responde
429; espere um minuto. - O serviço roda em infraestrutura pequena e pode ficar fora do ar sob carga. Para uso intenso, baixe o JSON e hospede a sua cópia.
Referência
Ferramentas do servidor MCP
| Ferramenta | O que faz |
|---|---|
listar_facetas | Valores válidos de cada filtro, com contagem. |
buscar_materiais | Busca por palavras e filtros (perfil, tema, formato, natureza...). Até 50 resultados. |
obter_item | Item completo pelo id, com texto e afirmações extraídas. Quando uma afirmação já foi verificada, ela vem com o campo verificacao. |
listar_fontes | As fontes de dados da base: papel de cada uma, volume, data de coleta e ressalvas. |
buscar_referencias | Busca indicadores na base de referência. Parâmetros: consulta (palavras), fonte (opcional) e limite (até 20). Devolve os valores por período. |
obter_referencia | Indicador completo pelo id, com a fonte primária, o link e o localizador de cada valor. |
buscar_iniciativas | Busca no diretório de iniciativas de terceiros. Parâmetros: consulta e categoria (opcional). |
Campos de cada item do JSON
| Campo | Descrição |
|---|---|
fonte | De qual fonte o item veio. Hoje, sempre curadoria-vira-voto. Os ids estão em /data/fontes.json. |
id, titulo, descricao, data, tags | Como no acervo original. Ids repetidos na origem recebem sufixo (110b). |
tipo | video, imagem, link, perfil, pdf |
plataforma | instagram, tiktok, x, youtube, facebook, telegram, google-drive, site, acervo |
perfis, temas | Listas: a quem o item serve e do que trata. |
recurso, colecao, regiao | Preenchidos quando o item é ferramenta, guia, formação, ou pertence a uma coleção. |
natureza | dado-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, thumbnail | Endereço do material original e da miniatura. |
conteudo | Quando existe: texto (transcrição), afirmacoes (cada uma com a fonte_citada pelo material, ou null), fontes_na_imagem, legibilidade, observacoes. |
conteudo.afirmacoes[].verificacao | Opcional. 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_retido | Motivo, quando o conteúdo extraído de um item não é publicado. |
Outros arquivos de dados
| Arquivo | Tamanho | Conteúdo e campos |
|---|---|---|
/data/fontes.json | cerca de 2 KB | As 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.json | cerca de 21 KB | Diretó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.json | cerca de 2,5 MB | Base 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.json | cerca 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.json | cerca de 2 KB | Novidades 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 →