datasaudi-mcp

Consulte estatísticas econômicas e sociais da Arábia Saudita (PIB, inflação, comércio, população, índice de preços imobiliários) do GASTAT / DataSaudi oficial, em inglês ou árabe. Sem chave, sem banco de dados.

GitHub
1
Experimente este MCPPatrocinado

Documentação

datasaudi-mcp

Pergunte ao Claude, Cursor ou qualquer cliente MCP sobre a economia saudita — em inglês simples ou árabe. Sem chave de API. Sem banco de dados.

PyPI MCP Registry License: MIT Python 3.12+ CI


Pergunte  ·  Cobertura  ·  Instalação  ·  العربية  ·  Ferramentas

PIB, inflação, comércio, população, o índice de preços de imóveis — 277 conjuntos de dados oficiais do GASTAT, ao vivo do DataSaudi, respondidos diretamente no seu cliente de IA. Você nunca precisa nomear um conjunto de dados; o modelo o encontra.

Aqui está no Claude Desktop — uma pergunta em inglês simples, e o modelo encontra o conjunto de dados, puxa o índice de preços de imóveis de Riade contra a tendência nacional e o gráfica:

datasaudi-mcp answering a question in Claude Desktop

Pergunte qualquer coisa

Conecte em cerca de 2 minutos (Instalação), e então é só perguntar:

💬  "Qual foi o índice de preços de imóveis em Riade por trimestre, e como ele se compara à tendência nacional?"

💬  "Quem são os principais parceiros comerciais da Arábia Saudita? Detalhe o comércio exterior por país e exportações vs. importações."

🇸🇦  "اعرض الرقم القياسي لأسعار العقارات في الرياض حسب الربع"   — pergunte em árabe, receba a resposta em árabe (الرياض, مكة المكرمة). Veja Suporte em árabe.

O modelo descobre o conjunto de dados certo, puxa os números e responde. Você não precisa conhecer nomes de conjuntos de dados ou sintaxe de consulta.

Mais exemplos de prompts
  • "Mostre-me a inflação e o IPC por província para o ano mais recente — quais regiões foram as mais altas?"
  • "Como o índice de preços de imóveis diferiu entre vilas e apartamentos ao longo do tempo?"
  • "Qual é a população por província, dividida por sexo e nacionalidade (saudita vs. não saudita)?"
  • "Mostre-me o PIB real por setor econômico, trimestre a trimestre, com crescimento anual."
  • "Compare os salários médios mensais: sauditas vs. não sauditas, e homens vs. mulheres."

Sobre o que você pode perguntar

277 conjuntos de dados selecionados do GASTAT / DataSaudi. Cada consulta acessa a API ao vivo, então os números são tão atuais quanto o GASTAT publica.

📈 Economia

PIB (setor / despesa / atividade), IPC e inflação (nacional + por província), o Índice de Preços ao Produtor, IED, comércio exterior (país / produto / fluxo), a balança comercial, confiança empresarial e do consumidor.

👥 Sociedade

População (província / sexo / nacionalidade / idade), domicílios e moradias, salários, emprego e taxas de participação, educação, saúde, deficiência.

🏗️ Imóveis

O índice de preços por província e tipo de propriedade (vila / apartamento / terreno), licenças de construção, o índice de custo de construção, posse e tipo de moradia.

🌍 Mais

Turismo e ocupação hoteleira, energia e água, Hajj e Umrah, séries financeiras do SAMA, indicadores reportados internacionalmente (Banco Mundial / ONU).

[!IMPORTANT] Onde ele para — de propósito. Uma ferramenta de dados confiável informa seus limites.

  • Serve o índice de preços de imóveis (ano-base 100) — não preços por negociação em riais (esses estão no MoJ / Srem).
  • Sem volumes de transações do MoJ, sem REGA, sem dados municipais / ZATCA / CMA, sem microdados. Esta é a camada de indicadores principais da série ~277, não o corpus nacional completo.
  • O detalhamento geográfico para no nível de província para a maioria das séries — sem divisão por cidade / distrito.

Se você pedir algo fora disso, o servidor diz claramente, em vez de adivinhar.

Instalação

Sem chave de API, nada para configurar — o DataSaudi não requer chave. Você precisará do uv instalado.

Claude Code — uma linha, sem edição de arquivos:

claude mcp add datasaudi -- uvx datasaudi-mcp
Claude Desktop

Settings → Developer → Edit Config, adicione o bloco abaixo e então saia completamente e reabra o Claude Desktop (saia totalmente pela bandeja — não apenas feche a janela):

{
  "mcpServers": {
    "datasaudi": {
      "command": "uvx",
      "args": ["datasaudi-mcp"]
    }
  }
}
Cursor

Settings → Tools & MCP → New MCP Server (ou edite ~/.cursor/mcp.json), mesmo bloco:

{
  "mcpServers": {
    "datasaudi": {
      "command": "uvx",
      "args": ["datasaudi-mcp"]
    }
  }
}

Depois, faça uma das perguntas acima.

Suporte em árabe

Dados sauditas em árabe, como um recurso de primeira classe — não um complemento.

  • Pergunte em árabe, receba a resposta em árabe. Os nomes dos membros retornam em escrita árabe: الرياض para Riade, مكة المكرمة para Meca, المنطقة الشرقية para a Região Oriental.
  • A busca no catálogo também funciona em árabe — um termo em árabe corresponde às anotações de tópico / fonte em árabe dos conjuntos de dados.
  • Números e estrutura são idênticos entre os idiomas — apenas as legendas legíveis mudam.

As ferramentas

Três ferramentas fazem o trabalho; o modelo as chama por você.

FerramentaO que ela faz
list_cubesPesquisa o catálogo de 277 conjuntos de dados por palavra-chave (inglês ou árabe).
describe_cubeMostra as dimensões e medidas de um conjunto de dados.
query_cubeExecuta uma consulta validada e retorna linhas organizadas — com a consulta ecoada de volta e paginação honesta.
Solução de problemas — "datasaudi" não aparece
  • Você saiu completamente e reabriu o aplicativo? (Fechar a janela não basta — saia pela bandeja.)
  • Sua configuração é JSON válido? Uma vírgula solta quebra o arquivo inteiro — cole-o em um validador de JSON.
  • O uv está instalado e no seu PATH? Execute uvx --version em um terminal.
  • Verifique o painel de MCP / ferramentas do cliente para uma mensagem de erro ao lado de datasaudi.
Fonte de dados e atualização

Os dados vêm ao vivo do api.datasaudi.sa (a API Tesseract do DataSaudi, operada pelo Ministério da Economia e Planejamento; dados produzidos pelo GASTAT). O servidor não mantém cópia local — cada consulta é buscada na hora, então os resultados estão sempre tão atuais quanto o próprio DataSaudi. Apenas o catálogo leve de conjuntos de dados é armazenado em cache na memória durante a sessão.

Os termos de uso de dados do DataSaudi são definidos pelo seu operador; este projeto é um cliente independente de código aberto e atribui GASTAT / MEP como fonte. Por favor, revise os termos do DataSaudi para o seu caso de uso.

Contribuindo

Contribuições são bem-vindas — veja CONTRIBUTING.md. Para desenvolver localmente:

git clone https://github.com/mohsinmshabbir/datasaudi-mcp
cd datasaudi-mcp
uv sync --all-extras
uv run pytest -m "not live"    # offline test suite
uv run pytest -m live          # optional: hits the real API

Licença

MIT — veja LICENSE.