naoterumaker/japan-gyousei-data

Skill de Dados Abertos Governamentais (Japão)

Acessa dados abertos do governo japonês via servidor MCP (mcp.n-3.ai).

Fontes de Dados

#	Nome	Uso	Ferramenta
1	Preço de Transações Imobiliárias	Dados reais de transações do MLIT	reinfolib-real-estate-price, reinfolib-city-list
2	Kan-ko-ju (Licitações)	Pesquisa de contratações do governo e municípios	kkj-search
3	e-Stat	Portal de estatísticas governamentais	e-stat-get-stats-list, e-stat-get-meta-info, e-stat-get-data-catalog

Método de Chamada

Use exec com curl. web_fetch não é compatível com SSE, portanto não pode ser usado.

Use o script scripts/mcp-call.sh:

bash <diretório_da_skill>/scripts/mcp-call.sh <fonte_de_dados> <nome_da_ferramenta> '<argumentos_json>'

Exemplos

# Imóveis: preços de transações em Osaka
bash scripts/mcp-call.sh reinfo reinfolib-real-estate-price '{"year":"2025","quarter":"3","area":"27","city":"27102"}'

# Imóveis: obter lista de municípios
bash scripts/mcp-call.sh reinfo reinfolib-city-list '{"area":"27"}'

# Licitações: buscar por AI (categoria 3 = serviços)
bash scripts/mcp-call.sh kkj kkj-search '{"query":"AI 人工知能","category":"3"}'

# e-Stat: pesquisar lista de estatísticas
bash scripts/mcp-call.sh estat e-stat-get-stats-list '{"searchWord":"人口"}'

Detalhes das Ferramentas

Consulte references/tools.md para detalhes dos parâmetros de cada ferramenta.

Observações

• Filtro de região nas licitações: kkj-search não suporta parâmetro de prefeitura. Inclua o nome da localidade na string de consulta para filtrar.
• Detalhes das licitações: o MCP retorna apenas a lista de resultados. Consulte o portal original para especificações, valores e prazos.
• Código de prefeitura para imóveis: use código de 2 dígitos (Tóquio=13, Osaka=27, etc.). O código do município pode ser obtido via reinfolib-city-list.
• e-Stat: primeiro use get-stats-list para identificar o ID da estatística, depois get-meta-info para metadados e get-data-catalog para obter os dados.
• Limite de taxa: como são APIs públicas, utilize com frequência razoável.