Aturan.org – Indonesian Legal Research

Busca semântica em larga escala e recuperação em nível de artigo para regulamentações indonésias, fornecendo a agentes de IA acesso estruturado a leis relevantes e texto jurídico autoritativo.

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

npx add-mcp 'https://mcp.aturan.org/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Aturan.org

A Primeira Busca Semântica Pública da Indonésia para Leis e Regulamentos

Site · Servidor MCP · API REST · Descobrir

O Aturan.org ajuda pessoas e sistemas de IA a recuperar regulamentos indonésios e as disposições neles contidas. Ele é preparado para IA por meio de um servidor remoto Model Context Protocol (MCP) e está disponível por meio de uma API REST e de um aplicativo web para pesquisa jurídica.

O Aturan.org é um sistema de recuperação, não um serviço automatizado de opinião jurídica. Sempre leia o texto completo e o contexto de uma disposição antes de confiar nela.

Por que o Aturan.org

A pesquisa jurídica geralmente começa com o nome de um documento, mas as questões jurídicas geralmente começam com um problema: um direito, obrigação, proibição, procedimento, sanção, autoridade ou condição. A busca por palavras-chave por si só pode dificultar a localização da disposição relevante quando o regulamento ainda não é conhecido.

O Aturan.org permite a recuperação semântica no nível do Pasal, de modo que uma questão jurídica pode ser usada para descobrir disposições relevantes e os regulamentos que as contêm. Um agente de IA pode então ler o texto completo das disposições selecionadas antes de produzir uma análise com referências fundamentadas.

O que você pode fazer

Capacidade	O que faz
Busca semântica de Pasal	Encontra disposições relevantes para um conceito jurídico, direito, obrigação, procedimento ou sanção.
Descoberta de regulamentos	Mapeia regulamentos relacionados a um problema, entre tipos e hierarquias de regulamentos.
Busca por título e identidade	Encontra um regulamento quando seu título, tipo, número ou ano é conhecido.
Leitura completa de disposições	Recupera o texto completo de um Pasal selecionado antes de ser citado ou analisado.
Integração com IA	Conecta clientes e agentes de IA compatíveis por meio de MCP remoto sobre Streamable HTTP.
API REST e aplicativo web	Torna o mesmo fluxo de pesquisa jurídica utilizável para aplicativos e pessoas.
Exportação de pesquisa	Exporta resultados de pesquisa para DOCX para compartilhamento e trabalho adicional.
Coleções salvas	Permite que usuários marquem Pasal relevantes em coleções pessoais.

Pesquise a partir da página inicial

A página inicial do Aturan.org está sempre pronta para pesquisa jurídica. Os usuários podem iniciar uma busca imediatamente em um de dois modos:

Modo	Melhor para	O que encontra
Cari Peraturan Terkait	Problemas amplos, pesquisa de políticas e mapeamento jurídico em estágio inicial.	Regulamentos relacionados a um problema, com resultados semânticos de Pasal para inspecionar em seguida.
Cari Pasal Terkait	Um direito, obrigação, proibição, procedimento, sanção ou conceito jurídico específico.	Pasal candidatos que são semanticamente relevantes para a consulta.

Os resultados da pesquisa podem ser exportados como um documento DOCX e disposições importantes podem ser marcadas em uma coleção de Pasal, para que a pesquisa possa continuar além de uma única sessão de busca.

Conecte um cliente de IA

O Aturan.org fornece um servidor MCP remoto via Streamable HTTP. Ele pode ser usado com clientes compatíveis com MCP, como Cherry Studio, Agora e outros agentes ou estruturas compatíveis.

Conexão de teste pública

Endpoint MCP:

https://mcp.aturan.org/mcp

Use este cabeçalho:

Authorization: Bearer aturanorg-mcp-ujicoba-1234567890abcdef

O token público é apenas para avaliação. Ele pode ser rotacionado, limitado por taxa ou desativado a qualquer momento. Não o use como credencial de produção nem o incorpore em um aplicativo público. Ele é diferente de uma chave de API REST do Aturan.org.

Configuração do Cherry Studio

Adicione a seguinte configuração de servidor e, em seguida, atualize ou reconecte o cliente MCP para que ele carregue as ferramentas disponíveis.

{
  "mcpServers": {
    "aturanorg": {
      "url": "https://mcp.aturan.org/mcp",
      "headers": {
        "Authorization": "Bearer aturanorg-mcp-ujicoba-1234567890abcdef"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Ferramentas MCP

Ferramenta	Use quando	Retorna
`cari_judul_peraturan`	O título, tipo, número ou ano do regulamento é conhecido.	Registros de regulamentos correspondentes e `regulation_id`.
`cari_pasal_terkait`	Você precisa de uma norma ou Pasal relevante, mas ainda não conhece o regulamento.	Disposições candidatas semanticamente relevantes.
`cari_peraturan_terkait`	Você precisa mapear regulamentos relacionados a um problema.	Regulamentos agrupados com resultados semânticos de Pasal.
`baca_isi_pasal`	Uma disposição candidata deve ser lida por completo.	O texto completo de um Pasal selecionado.

Da recuperação à pesquisa jurídica agêntica

Cada ferramenta retorna um tipo diferente de evidência. Usada uma vez, uma ferramenta ajuda a responder a uma necessidade de recuperação. Usadas juntas por um LLM agêntico, as quatro ferramentas formam um ciclo de pesquisa: o modelo pode mapear um problema, encontrar normas candidatas, resolver um regulamento exato, ler a disposição completa e refinar a próxima recuperação com base no que aprendeu.

Isso torna a análise mais fácil de fundamentar, porque o agente não é forçado a responder a partir de um único resultado de busca ou de seu conhecimento interno. Ele pode coletar o material primário relevante primeiro e, em seguida, separar o que o regulamento diz de sua própria interpretação.

Ferramenta	Contribuição distinta em um fluxo de trabalho agêntico
`cari_peraturan_terkait`	A lente grande angular: descobre o panorama jurídico e agrupa regulamentos relacionados a partir de resultados semânticos de Pasal.
`cari_pasal_terkait`	O localizador de normas: traz à tona disposições semanticamente próximas de uma questão jurídica focada.
`cari_judul_peraturan`	O resolvedor de identidade: encontra o regulamento preciso quando seu nome, tipo, número, ano ou fragmento de título é conhecido.
`baca_isi_pasal`	A verificação de fonte: obtém o texto completo de uma disposição selecionada antes de ser citada ou utilizada.

Um agente deve usar apenas as ferramentas que acrescentam informação. Os resultados são complementares, não intercambiáveis: a descoberta de regulamentos responde quais documentos podem importar; a busca de Pasal responde quais normas podem importar; a busca por título responde qual documento exato é pretendido; e a leitura do texto completo responde o que a disposição realmente diz.

Fluxo de trabalho agêntico

question or legal issue
        ↓
plan one or more focused queries
        ↓
cari_peraturan_terkait ──→ map candidate regulations
        ↓                         │
cari_pasal_terkait ──────→ find candidate norms
        ↓                         │
cari_judul_peraturan ────→ resolve a known document and regulation_id
        ↓
baca_isi_pasal ──────────→ verify full wording of selected provisions
        ↓
compare, refine, retrieve again if needed, then analyse

A análise final ainda é uma análise, não uma conclusão jurídica automatizada. Ela deve declarar o texto e as fontes recuperados separadamente de qualquer interpretação e sinalizar onde é necessária verificação adicional.

Quatro cenários complementares

1. Problema amplo: construa o panorama jurídico primeiro

Pergunta: “Quais regulamentos se relacionam a sanções administrativas em atividades de negócios de mineração?”

Comece com cari_peraturan_terkait("sanksi administratif dalam kegiatan usaha pertambangan") para descobrir um conjunto amplo de regulamentos relacionados e seus semantic_hits.
Inspecione os grupos resultantes: tipo de regulamento, ano, status e os números de Pasal candidatos em semantic_hit_pasals.
Execute consultas de acompanhamento mais restritas quando necessário, por exemplo kewajiban pemegang izin usaha pertambangan ou prosedur pengenaan sanksi administratif pertambangan.
Use baca_isi_pasal apenas para disposições candidatas selecionadas antes de descrever as sanções ou o procedimento.

Por que todos os resultados importam: a descoberta de regulamentos evita que a pesquisa comece com um único documento presumido; a busca focada de Pasal restringe a questão; a leitura do texto completo evita que uma prévia semântica seja confundida com a própria regra.

2. Norma específica: encontre o Pasal relevante e depois amplie a verificação

Pergunta: “Quais são os direitos de um herdeiro que recebe benefícios por morte do BPJS Ketenagakerjaan?”

Comece com cari_pasal_terkait("hak ahli waris penerima manfaat jaminan kematian BPJS Ketenagakerjaan") para encontrar normas candidatas diretamente.
Leia os candidatos mais fortes com baca_isi_pasal, usando apenas seus regulation_id e números de Pasal retornados.
Use cari_peraturan_terkait com a mesma consulta ou uma consulta refinada para verificar se o problema também é abordado em outros regulamentos relacionados.
Se o agente precisar verificar um regulamento mencionado nos resultados por sua identidade formal, use cari_judul_peraturan antes de ler outras disposições.

Por que os resultados diferem: a busca de Pasal é otimizada para trazer à tona uma norma concreta. A descoberta de regulamentos pode revelar documentos relacionados que uma busca em nível de norma única não torna óbvios. O agente pode usar ambos sem tratar nenhum deles como conclusão.

3. Documento conhecido: resolva a identidade e depois leia a regra exata

Pergunta: “O que o PP 45 Tahun 2009 diz sobre um requisito específico?”

Execute cari_judul_peraturan("PP 45 Tahun 2009") para resolver o regulamento e obter seu regulation_id real.
Se um número de Pasal já for conhecido, chame baca_isi_pasal(regulation_id, pasal) para ler o texto completo.
Se o número de Pasal relevante não for conhecido, use cari_pasal_terkait com o requisito substantivo como consulta e, em seguida, leia o Pasal candidato retornado para esse regulamento.
Quando a questão puder ter implicações fora desse documento, use cari_peraturan_terkait para descobrir regulamentos relacionados antes de formar uma análise.

Por que os resultados diferem: a busca por título estabelece qual documento está sendo discutido; a busca de Pasal ajuda a encontrar onde dentro do material jurídico o requisito é discutido; a ferramenta de leitura verifica a redação real.

4. Problema complexo: divida uma questão em vários caminhos de recuperação

Pergunta: “Como o PLTS atap é regulamentado e quais são as obrigações de um fornecedor de eletricidade?”

Um agente deve evitar uma única consulta semântica superdimensionada. Em vez disso, ele pode trabalhar por caminhos focados:

cari_peraturan_terkait("pengaturan PLTS atap")
cari_pasal_terkait("perizinan PLTS atap")
cari_pasal_terkait("kewajiban pemegang izin usaha penyediaan tenaga listrik terkait PLTS atap")
cari_pasal_terkait("ekspor impor energi listrik PLTS atap")
cari_pasal_terkait("kapasitas pemasangan PLTS atap")

O agente compara os regulamentos resultantes e as disposições candidatas, usa cari_judul_peraturan para resolver qualquer documento que precise identificar exatamente e chama baca_isi_pasal para cada disposição que apoiará sua explicação.

Resultado: em vez de uma resposta superficial, o agente pode produzir um rastro de pesquisa estruturado: o panorama regulatório relevante, cada norma específica do problema, a redação completa que apoia cada ponto e uma interpretação claramente marcada.

Exemplos de prompts

Após conectar o servidor MCP, faça perguntas a um cliente de IA, como:

Temukan ketentuan tentang kewajiban pemberi kerja mendaftarkan pekerja
ke program jaminan sosial.

Regulasi apa saja yang berkaitan dengan sanksi administratif
dalam kegiatan usaha pertambangan?

Cari PP 45 Tahun 2009, lalu bacakan Pasal yang mengatur topik terkait.

Fluxo de trabalho de recuperação

DISCOVER → IDENTIFY → READ → ANALYZE

Descubra — use a busca por título, busca de Pasal ou descoberta de regulamentos para recuperar candidatos.
Identifique — avalie o título, tipo, ano, status, metadados e resultados semânticos.
Leia — recupere o texto completo do Pasal relevante usando baca_isi_pasal.
Analise — distinga o texto da norma, as relações entre regulamentos, a interpretação e sua conclusão.

Escolha a ferramenta com base no que é conhecido:

Known regulation identity
cari_judul_peraturan → regulation_id → baca_isi_pasal

Known legal issue or norm
cari_pasal_terkait → evaluate candidates → baca_isi_pasal → analyze

Need to map the legal landscape
cari_peraturan_terkait → evaluate groups → semantic_hit_pasals → baca_isi_pasal → analyze

Usando bem a recuperação semântica

Escreva consultas como a substância jurídica que você precisa, em vez de uma instrução conversacional.

Prefira	Em vez de
`hak ahli waris penerima manfaat program jaminan kematian BPJS Ketenagakerjaan`	`bagaimana jaminan kematian BPJS Ketenagakerjaan untuk ahli waris pekerja yang meninggal`
`jenis alat bukti yang sah dalam hukum acara pidana`	`apa saja alat bukti yang sah?`

Para um problema complexo, divida-o em várias recuperações focadas. Por exemplo, a pesquisa sobre PLTS atap pode exigir consultas separadas sobre licenciamento, obrigações do fornecedor de eletricidade, exportação e importação de eletricidade e capacidade de instalação.

Princípios para agentes de IA

Recupere antes de raciocinar. Use a recuperação quando uma análise depender de um regulamento ou Pasal.
Leia antes de citar. Um resultado semântico é um candidato, não um substituto para a redação completa de uma disposição.
Não invente referências. Apresente apenas identidades de regulamentos, números de Pasal e texto retornados pelo Aturan.org como resultados de recuperação.
Use regulation_id apenas a partir de resultados de ferramentas. Não invente nem adivinhe.
Itere quando necessário. Inspecione os resultados, refine a consulta, recupere novamente e depois leia as disposições selecionadas.

Limitações

A busca semântica classifica candidatos por relevância. Ela não estabelece, por si só, que uma disposição se aplica a todos os padrões factuais, é a base jurídica controladora, permanece em vigor sem emendas ou apoia uma interpretação específica.

Antes de tirar uma conclusão jurídica, avalie o texto completo e o contexto do Pasal, o status e as emendas do regulamento, a relação e a hierarquia dos regulamentos relevantes e os fatos em questão.

Arquitetura pública

O diagrama abaixo descreve a arquitetura pública de recuperação do Aturan.org. Ele foca intencionalmente nas interfaces do produto e no fluxo de recuperação — não na infraestrutura privada ou em detalhes de implementação.

                         ┌───────────────────────────────────┐
                         │  Indonesian regulation corpus     │
                         │  288,826 regulations              │
                         │  5,339,903 structured Pasal       │
                         └─────────────────┬─────────────────┘
                                           │
                                           ▼
                    ┌──────────────────────────────────────────────┐
                    │            Aturan.org Retrieval Core         │
                    │                                              │
                    │  · title / identity retrieval                │
                    │  · Exact Nearest Neighbor semantic search    │
                    │  · Pasal-level candidate retrieval           │
                    │  · regulation grouping and full Pasal read   │
                    └───────────────┬─────────────┬────────────────┘
                                    │             │
                ┌───────────────────┘             └──────────────────┐
                ▼                                                    ▼
┌─────────────────────────────────┐                 ┌────────────────────────────────────┐
│  MCP Server · Streamable HTTP   │                 │  Aturan.org web app and REST API   │
│                                 │                 │                                    │
│  · cari_judul_peraturan         │                 │  · issue and regulation discovery  │
│  · cari_pasal_terkait           │                 │  · legal research workflows        │
│  · cari_peraturan_terkait       │                 │  · application integration         │
│  · baca_isi_pasal               │                 │                                    │
└───────────────┬─────────────────┘                 └────────────────┬───────────────────┘
                │                                                    │
                ▼                                                    ▼
┌─────────────────────────────────┐                 ┌────────────────────────────────────┐
│  AI clients and agentic LLMs    │                 │  Researchers and applications      │
│                                 │                 │                                    │
│  retrieve → read → analyse      │                 │  search · inspect · integrate      │
│  with grounded source material  │                 │                                    │
└─────────────────────────────────┘                 └────────────────────────────────────┘

Design de recuperação

O Aturan.org é projetado como um sistema de pesquisa jurídica no qual cada modo de recuperação tem uma função diferente. Em vez de pedir a um único endpoint de busca que responda a todas as perguntas, o sistema separa identidade documental, descoberta de normas, descoberta do panorama regulatório e verificação de fontes.

Camada de recuperação	Método	Propósito
Identidade regulatória	Busca literal/por texto completo no título	Resolve um título, tipo, número, ano ou frase de título conhecidos.
Descoberta de normas	Recuperação semântica de vizinho mais próximo exato no nível de Pasal	Encontra disposições candidatas relevantes para um conceito jurídico.
Descoberta do panorama	Recuperação semântica agregada no nível de Pasal	Mapeia regulamentações relacionadas a um tema, com ocorrências candidatas de Pasal.
Verificação de fontes	Recuperação completa de Pasal	Lê o texto integral de uma disposição antes de citação ou análise.

Projetado para pesquisa fundamentada e em múltiplas etapas

Vizinho mais próximo exato, não ANN/HNSW. A recuperação semântica usa uma abordagem de vizinho mais próximo exato, em vez de aproximar os candidatos recuperados mais próximos por meio de um índice ANN.
Busca exata particionada por GPU. O espaço de candidatos é pesquisado em partições de GPU e os candidatos resultantes são mesclados globalmente. Isso torna a recuperação exata prática na escala do corpus, evitando a compensação de recall dos índices aproximados ANN/HNSW, nos quais vizinhos próximos relevantes podem ser perdidos.
Recuperação primeiro pelo Pasal. Um tema jurídico é correspondido a normas candidatas no nível da disposição e, em seguida, conectado de volta às regulamentações que as contêm.
Descoberta separada da verificação. Uma ocorrência semântica ajuda a selecionar o que inspecionar; baca_isi_pasal recupera a disposição completa que sustenta qualquer explicação posterior.
Agêntico por design. Um LLM pode executar várias recuperações focadas, comparar suas saídas, ler disposições selecionadas e refinar sua próxima consulta antes de redigir a análise.
Referências de recuperação estáveis. O gateway retorna valores regulation_id para uso em leituras subsequentes de disposições. Os agentes devem obtê-los dos resultados, em vez de construí-los.
Consultas limitadas e focadas. As ferramentas MCP aceitam uma consulta substantiva e resultados top_k limitados, tornando prático iterar do mapeamento amplo do panorama até um Pasal específico.

Princípios de implantação e operação

Pronto para instituições por design. O Aturan.org é desenvolvido pensando na implantação on-premise, para que instituições e empresas possam adotar a arquitetura de recuperação dentro de sua própria infraestrutura, governança e requisitos de fronteira de dados.
Chamada de ferramentas prática. Os fluxos de trabalho de chamada de ferramentas são deliberadamente testados com modelos da classe 4B. Isso estabelece uma linha de base exigente de eficiência: se um modelo menor consegue executar um fluxo de recuperação útil, modelos maiores têm margem adicional para planejamento e análise.
Cobertura na data de escrita. O corpus contém 288.826 regulamentações e 5.339.903 Pasal estruturados. A cobertura e os números evoluirão conforme o corpus for expandido e mantido.

Interfaces

Superfície	Endereço	Função
Aplicativo web	aturan.org	Descoberta e pesquisa jurídica voltada a humanos.
Servidor MCP	aturan.org/mcp	Conexão MCP remota para clientes e agentes de IA.
API REST	aturan.org/api	Integração de aplicações.
Discover	aturan.org/discover	Ponto de entrada para explorar o Aturan.org.

Acesso ao serviço

O Aturan.org oferece níveis de acesso gratuitos e pagos. O acesso ao aplicativo web hospedado, ao servidor MCP e à API REST é regido pelos termos de serviço aplicáveis, credenciais, cotas e limites do plano.

O logotipo e o nome Aturan.org são ativos de marca proprietários. Uma futura licença do repositório se aplicará apenas ao código-fonte e à documentação efetivamente publicados neste repositório; ela não regerá o backend privado nem substituirá os termos de serviço.