Dados
Citoyen para agentes de IA e desenvolvedores
Os números do Citoyen também podem ser lidos por assistentes de IA e por programas, não só por pessoas na tela. Um servidor público, somente de leitura, entrega as mesmas séries dos cartões, cada uma com seu produtor oficial, período e unidade, para que uma resposta possa dizer de onde vem um número.
O servidor MCP
O Model Context Protocol (MCP) é o padrão que assistentes como Claude ou ChatGPT usam para chamar ferramentas externas. O servidor do Citoyen é gratuito, não exige chave nem conta e apenas lê: não guarda nada das perguntas feitas, só conta as chamadas para manter o serviço disponível.
Endereço do servidor
https://citoyenapp.com/mcpComo conectar
No Claude
Em claude.ai ou no aplicativo para desktop: Configurações, Conectores, Adicionar conector personalizado, e cole o endereço do servidor.
Em outros assistentes
ChatGPT no modo desenvolvedor e os outros assistentes que aceitam servidores MCP remotos: adicione um conector HTTP com o endereço do servidor.
Num editor de código
Cursor, VS Code, Claude Code e ferramentas semelhantes: adicione o servidor à configuração MCP deles, como abaixo.
Configuração para os clientes que leem um arquivo MCP:
{
"mcpServers": {
"citoyen": {
"type": "http",
"url": "https://citoyenapp.com/mcp"
}
}
}As ferramentas
- search
- Encontra indicadores com o código, os países citados na pergunta e as publicações relacionadas.
- get_series
- A série de um indicador para um país, como o cartão a mostra: valores por período, unidade, produtor e link para a fonte. Últimos 10 anos por padrão.
- compare_countries
- Um indicador para 2 a 8 países, de uma única fonte harmonizada para que os valores sejam comparáveis.
- get_ranking
- Todos os países cobertos ordenados num indicador, no último período em comum, do valor mais alto ao mais baixo.
- get_publication
- Os pontos-chave de uma nota de síntese, de uma análise ou de uma ficha de reforma, com o link para o texto completo.
- get_release_calendar
- As próximas divulgações das séries: datas oficiais do produtor ou janelas estimadas.
Limites e regras
- 60 chamadas por minuto por endereço. Acima disso, o servidor pede para tentar de novo em instantes.
- As séries cobrem 10 anos por padrão (até 80 a pedido, no máximo 600 pontos por resposta); uma comparação abrange de 2 a 8 países.
- As séries de produtores privados, e as séries militares que o SIPRI publica por meio do Banco Mundial, dão apenas o último valor e o link para o cartão: os termos delas não permitem repassar a série completa.
- As publicações dão os pontos-chave e o link, nunca o texto completo.
- Valores marcados como projetados são previsões, nunca números observados.
- Cada resposta indica o produtor: cite-o, com o link para a página do Citoyen indicada na resposta.
- As chamadas são contadas por dia sob uma chave anónima derivada do endereço IP, que muda todos os dias; o endereço nunca é guardado e as contagens são mantidas 30 dias.
Outros acessos
- Cada página de indicador oferece a série em CSV: acrescente /data.csv ao endereço (exceto séries de produtores privados).
- Um mapa do site em texto simples para os rastreadores de IA: /llms.txt
- Qualquer cartão pode ser incorporado em outro site com o botão « Incorporar ».
Como citar
Cite o produtor oficial indicado com cada número, e o Citoyen como o lugar onde ele foi lido, com o link para a página.
As seleções, verificações e textos do Citoyen são protegidos, e a extração sistemática da base não é permitida. Os detalhes: Aviso legal
