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/mcp

Como conectar

  1. No Claude

    Em claude.ai ou no aplicativo para desktop: Configurações, Conectores, Adicionar conector personalizado, e cole o endereço do servidor.

  2. 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.

  3. 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