Aturan.org – Indonesian Legal Research
Búsqueda semántica a gran escala y recuperación a nivel de artículo para regulaciones indonesias, que proporciona a los agentes de IA acceso estructurado a leyes relevantes y texto legal autoritativo.
Servidor MCP alojado
npx add-mcp 'https://mcp.aturan.org/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Aturan.org
El primer buscador semántico público de Indonesia para leyes y regulaciones
Sitio web · Servidor MCP · API REST · Descubrir
Aturan.org ayuda a personas y sistemas de IA a recuperar regulaciones de Indonesia y las disposiciones contenidas en ellas. Está preparado para IA mediante un servidor remoto de Protocolo de Contexto de Modelo (MCP) y está disponible a través de una API REST y una aplicación web para investigación jurídica.
Aturan.org es un sistema de recuperación, no un servicio automatizado de opinión legal. Lea siempre el texto completo y el contexto de una disposición antes de confiar en ella.
Por qué Aturan.org
La investigación jurídica a menudo comienza con el nombre de un documento, pero las preguntas legales suelen comenzar con un asunto: un derecho, obligación, prohibición, procedimiento, sanción, autoridad o condición. La búsqueda por palabras clave por sí sola puede dificultar encontrar la disposición relevante cuando la regulación aún no se conoce.
Aturan.org permite la recuperación semántica a nivel de Pasal, de modo que una pregunta legal puede usarse para descubrir disposiciones relevantes y las regulaciones que las contienen. Un agente de IA puede entonces leer el texto completo de las disposiciones seleccionadas antes de producir un análisis con referencias fundamentadas.
Qué puede hacer
| Capacidad | Qué hace |
|---|---|
| Búsqueda semántica de Pasal | Encuentra disposiciones relevantes para un concepto legal, derecho, obligación, procedimiento o sanción. |
| Descubrimiento de regulaciones | Mapea regulaciones relacionadas con un asunto, entre tipos y jerarquías de regulaciones. |
| Búsqueda por título e identidad | Encuentra una regulación cuando se conoce su título, tipo, número o año. |
| Lectura completa de disposiciones | Recupera el texto completo de un Pasal seleccionado antes de que sea citado o analizado. |
| Integración con IA | Conecta clientes y agentes de IA compatibles mediante MCP remoto sobre Streamable HTTP. |
| API REST y aplicación web | Hace que el mismo flujo de investigación jurídica sea utilizable para aplicaciones y personas. |
| Exportación de investigaciones | Exporta resultados de búsqueda a DOCX para compartir y seguir trabajando. |
| Colecciones guardadas | Permite a los usuarios marcar Pasal relevantes en colecciones personales. |
Buscar desde la página de inicio
La página de inicio de Aturan.org está siempre lista para la investigación jurídica. Los usuarios pueden iniciar una búsqueda de inmediato en uno de dos modos:
| Modo | Mejor para | Qué encuentra |
|---|---|---|
| Cari Peraturan Terkait | Asuntos amplios, investigación de políticas y mapeo legal en etapas tempranas. | Regulaciones relacionadas con un asunto, con coincidencias semánticas de Pasal para inspeccionar a continuación. |
| Cari Pasal Terkait | Un derecho, obligación, prohibición, procedimiento, sanción o concepto legal específico. | Pasal candidatos que sean semánticamente relevantes para la consulta. |
Los resultados de búsqueda pueden exportarse como un documento DOCX y las disposiciones importantes pueden marcarse en una colección de Pasal, de modo que la investigación pueda continuar más allá de una sola sesión de búsqueda.
Conectar un cliente de IA
Aturan.org proporciona un servidor MCP remoto mediante Streamable HTTP. Puede usarse con clientes compatibles con MCP como Cherry Studio, Agora y otros agentes o marcos compatibles.
Conexión de prueba pública
Punto final MCP:
https://mcp.aturan.org/mcp
Use este encabezado:
Authorization: Bearer aturanorg-mcp-ujicoba-1234567890abcdef
El token público es solo para evaluación. Puede rotarse, limitarse en velocidad o deshabilitarse en cualquier momento. No lo use como credencial de producción ni lo incruste en una aplicación pública. Es diferente de una clave de API REST de Aturan.org.
Configuración de Cherry Studio
Agregue la siguiente configuración de servidor y luego actualice o reconecte el cliente MCP para que cargue las herramientas disponibles.
{
"mcpServers": {
"aturanorg": {
"url": "https://mcp.aturan.org/mcp",
"headers": {
"Authorization": "Bearer aturanorg-mcp-ujicoba-1234567890abcdef"
},
"disabled": false,
"autoApprove": []
}
}
}
Herramientas MCP
| Herramienta | Úsela cuando | Devuelve |
|---|---|---|
cari_judul_peraturan | Se conoce el título, tipo, número o año de la regulación. | Registros de regulaciones coincidentes y regulation_id. |
cari_pasal_terkait | Necesita una norma o Pasal relevante, pero aún no conoce la regulación. | Disposiciones candidatas semánticamente relevantes. |
cari_peraturan_terkait | Necesita mapear regulaciones relacionadas con un asunto. | Regulaciones agrupadas con coincidencias semánticas de Pasal. |
baca_isi_pasal | Una disposición candidata debe leerse completa. | El texto completo de un Pasal seleccionado. |
De la recuperación a la investigación jurídica agéntica
Cada herramienta devuelve un tipo diferente de evidencia. Usada una vez, una herramienta ayuda a responder una necesidad de recuperación. Usadas juntas por un LLM agéntico, las cuatro herramientas forman un ciclo de investigación: el modelo puede mapear un asunto, encontrar normas candidatas, resolver una regulación exacta, leer la disposición completa y refinar la siguiente recuperación a partir de lo aprendido.
Esto facilita fundamentar el análisis porque el agente no se ve obligado a responder desde un solo resultado de búsqueda o su conocimiento interno. Puede recopilar primero el material primario relevante y luego separar lo que dice la regulación de su propia interpretación.
| Herramienta | Contribución distintiva en un flujo de trabajo agéntico |
|---|---|
cari_peraturan_terkait | El lente gran angular: descubre el panorama legal y agrupa regulaciones relacionadas a partir de coincidencias semánticas de Pasal. |
cari_pasal_terkait | El buscador de normas: saca a la superficie disposiciones semánticamente cercanas a un asunto legal específico. |
cari_judul_peraturan | El resolvedor de identidad: encuentra la regulación precisa cuando se conoce su nombre, tipo, número, año o fragmento de título. |
baca_isi_pasal | La verificación de fuente: obtiene el texto completo de una disposición seleccionada antes de que se cite o se use como base. |
Un agente debe usar solo las herramientas que aportan información. Los resultados son complementarios, no intercambiables: el descubrimiento de regulaciones responde qué documentos pueden importar; la búsqueda de Pasal responde qué normas pueden importar; la búsqueda por título responde qué documento exacto se quiere decir; y la lectura de texto completo responde qué dice realmente la disposición.
Flujo de trabajo 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
El análisis final sigue siendo un análisis, no una conclusión legal automatizada. Debe exponer el texto y las fuentes recuperadas por separado de cualquier interpretación, y señalar dónde se necesita verificación adicional.
Cuatro escenarios complementarios
1. Asunto amplio: construir primero el panorama legal
Pregunta: “¿Qué regulaciones se relacionan con sanciones administrativas en actividades mineras?”
- Comience con
cari_peraturan_terkait("sanksi administratif dalam kegiatan usaha pertambangan")para descubrir un conjunto amplio de regulaciones relacionadas y sussemantic_hits. - Inspeccione los grupos resultantes: tipo de regulación, año, estado y los números de Pasal candidatos en
semantic_hit_pasals. - Ejecute consultas de seguimiento más específicas cuando sea necesario, por ejemplo
kewajiban pemegang izin usaha pertambanganoprosedur pengenaan sanksi administratif pertambangan. - Use
baca_isi_pasalsolo para disposiciones candidatas seleccionadas antes de describir las sanciones o el procedimiento.
Por qué importan todos los resultados: el descubrimiento de regulaciones evita que la investigación comience con un solo documento supuesto; la búsqueda enfocada de Pasal acota la pregunta; la lectura de texto completo evita que una vista previa semántica se confunda con la regla misma.
2. Norma específica: encontrar el Pasal relevante y luego ampliar la verificación
Pregunta: “¿Cuáles son los derechos de un heredero que recibe beneficios de muerte de BPJS Ketenagakerjaan?”
- Comience con
cari_pasal_terkait("hak ahli waris penerima manfaat jaminan kematian BPJS Ketenagakerjaan")para encontrar normas candidatas directamente. - Lea los candidatos más sólidos con
baca_isi_pasal, usando solo susregulation_idy números de Pasal devueltos. - Use
cari_peraturan_terkaitcon la misma consulta o una refinada para verificar si el asunto también se aborda en otras regulaciones relacionadas. - Si el agente necesita verificar una regulación mencionada en los resultados por su identidad formal, use
cari_judul_peraturanantes de leer más disposiciones.
Por qué difieren los resultados: la búsqueda de Pasal está optimizada para sacar a la superficie una norma concreta. El descubrimiento de regulaciones puede revelar documentos relacionados que una búsqueda a nivel de norma no hace evidentes. El agente puede usar ambas sin tratar ninguna como conclusión.
3. Documento conocido: resolver la identidad y luego leer la regla exacta
Pregunta: “¿Qué dice PP 45 Tahun 2009 sobre un requisito particular?”
- Ejecute
cari_judul_peraturan("PP 45 Tahun 2009")para resolver la regulación y obtener suregulation_idreal. - Si ya se conoce un número de Pasal, llame a
baca_isi_pasal(regulation_id, pasal)para leer el texto completo. - Si no se conoce el número de Pasal relevante, use
cari_pasal_terkaitcon el requisito sustantivo como consulta y luego lea el Pasal candidato devuelto para esa regulación. - Cuando la pregunta pueda tener implicaciones fuera de ese documento, use
cari_peraturan_terkaitpara descubrir regulaciones relacionadas antes de formar un análisis.
Por qué difieren los resultados: la búsqueda por título establece qué documento se está discutiendo; la búsqueda de Pasal ayuda a encontrar dónde dentro del material legal se discute el requisito; la herramienta de lectura verifica la redacción real.
4. Asunto complejo: dividir una pregunta en varias rutas de recuperación
Pregunta: “¿Cómo se regula PLTS atap y cuáles son las obligaciones de un proveedor de electricidad?”
Un agente debe evitar una sola consulta semántica sobredimensionada. En su lugar, puede trabajar a través de rutas enfocadas:
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")
El agente compara las regulaciones y disposiciones candidatas resultantes, usa cari_judul_peraturan para resolver cualquier documento que necesite identificar con exactitud y llama a baca_isi_pasal para cada disposición que respaldará su explicación.
Resultado: en lugar de una respuesta superficial, el agente puede producir un rastro de investigación estructurado: el panorama regulatorio relevante, cada norma específica del asunto, la redacción completa que respalda cada punto y una interpretación claramente marcada.
Ejemplos de indicaciones
Después de conectar el servidor MCP, haga preguntas a un 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.
Flujo de trabajo de recuperación
DISCOVER → IDENTIFY → READ → ANALYZE
- Descubrir — use la búsqueda por título, la búsqueda de Pasal o el descubrimiento de regulaciones para recuperar candidatos.
- Identificar — evalúe el título, tipo, año, estado, metadatos y coincidencias semánticas.
- Leer — recupere el texto completo del Pasal relevante usando
baca_isi_pasal. - Analizar — distinga el texto de la norma, las relaciones entre regulaciones, la interpretación y su conclusión.
Elija la herramienta según lo que se conozca:
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
Usar bien la recuperación semántica
Redacte las consultas como la sustancia legal que necesita, en lugar de como una instrucción conversacional.
| Prefiera | En lugar 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 un asunto complejo, divídalo en varias recuperaciones enfocadas. Por ejemplo, la investigación sobre PLTS atap puede necesitar consultas separadas sobre licencias, obligaciones del proveedor de electricidad, exportación e importación de electricidad y capacidad de instalación.
Principios para agentes de IA
- Recupere antes de razonar. Use la recuperación cuando un análisis dependa de una regulación o Pasal.
- Lea antes de citar. Una coincidencia semántica es un candidato, no un sustituto del texto completo de una disposición.
- No fabrique referencias. Presente solo identidades de regulaciones, números de Pasal y texto devueltos por Aturan.org como resultados de recuperación.
- Use
regulation_idsolo de los resultados de las herramientas. No lo invente ni lo adivine. - Itere cuando sea necesario. Inspeccione los resultados, refine la consulta, recupere de nuevo y luego lea las disposiciones seleccionadas.
Limitaciones
La búsqueda semántica clasifica los candidatos por relevancia. Por sí sola no establece que una disposición se aplique a cada patrón de hechos, sea la base legal controladora, siga vigente sin enmiendas o respalde una interpretación particular.
Antes de sacar una conclusión legal, evalúe el texto completo y el contexto del Pasal, el estado y las enmiendas de la regulación, la relación y jerarquía de las regulaciones relevantes y los hechos en cuestión.
Arquitectura pública
El siguiente diagrama describe la arquitectura pública de recuperación de Aturan.org. Se centra intencionalmente en las interfaces de producto y el flujo de recuperación, no en la infraestructura privada ni en los detalles de implementación.
┌───────────────────────────────────┐
│ 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 │ │ │
└─────────────────────────────────┘ └────────────────────────────────────┘
Diseño de recuperación
Aturan.org está diseñado como un sistema de investigación legal en el que cada modo de recuperación tiene una función distinta. En lugar de pedir a un único endpoint de búsqueda que responda a todas las preguntas, el sistema separa la identidad del documento, el descubrimiento de normas, el descubrimiento del panorama regulatorio y la verificación de fuentes.
| Capa de recuperación | Método | Propósito |
|---|---|---|
| Identidad de la regulación | Búsqueda literal/de texto completo por título | Resuelve un título, tipo, número, año o frase de título conocidos. |
| Descubrimiento de normas | Recuperación semántica de Vecino Más Cercano Exacto a nivel de Pasal | Encuentra disposiciones candidatas relevantes para un concepto legal. |
| Descubrimiento del panorama | Recuperación semántica agregada a nivel de Pasal | Mapea regulaciones relacionadas con un tema, con coincidencias candidatas de Pasal. |
| Verificación de fuentes | Recuperación completa de Pasal | Lee el texto íntegro de una disposición antes de citarla o analizarla. |
Diseñado para investigación fundamentada y de múltiples pasos
- Vecino Más Cercano Exacto, no ANN/HNSW. La recuperación semántica utiliza un enfoque de vecino más cercano exacto en lugar de aproximar los candidatos recuperados más cercanos mediante un índice ANN.
- Búsqueda exacta fragmentada por GPU. El espacio de candidatos se busca en fragmentos de GPU y los candidatos resultantes se fusionan globalmente. Esto hace que la recuperación exacta sea práctica a escala de corpus, evitando la compensación de recall de los índices ANN/HNSW aproximados, donde los vecinos cercanos relevantes pueden pasarse por alto.
- Recuperación priorizando Pasal. Un tema legal se compara con normas candidatas a nivel de disposición y luego se conecta con las regulaciones que las contienen.
- Separación entre descubrimiento y verificación. Una coincidencia semántica ayuda a seleccionar qué inspeccionar;
baca_isi_pasalrecupera la disposición completa que respalda cualquier explicación posterior. - Diseño agéntico. Un LLM puede ejecutar varias recuperaciones enfocadas, comparar sus resultados, leer disposiciones seleccionadas y refinar su siguiente consulta antes de redactar el análisis.
- Referencias de recuperación estables. La puerta de enlace devuelve valores
regulation_idpara su uso en lecturas posteriores de disposiciones. Los agentes deben obtenerlos de los resultados, no construirlos. - Consultas acotadas y enfocadas. Las herramientas MCP aceptan una consulta sustantiva y resultados
top_klimitados, lo que hace práctico iterar desde un mapeo amplio del panorama hasta un Pasal específico.
Principios de despliegue y operación
- Diseñado para instituciones. Aturan.org está desarrollado pensando en el despliegue local, de modo que instituciones y empresas puedan adoptar la arquitectura de recuperación dentro de su propia infraestructura, gobernanza y requisitos de límites de datos.
- Llamadas a herramientas prácticas. Los flujos de trabajo de llamadas a herramientas se prueban deliberadamente con modelos de la clase 4B. Esto establece una línea base de eficiencia exigente: si un modelo más pequeño puede ejecutar un flujo de recuperación útil, los modelos más grandes tienen margen adicional para planificación y análisis.
- Cobertura al momento de redactar este documento. El corpus contiene 288.826 regulaciones y 5.339.903 Pasal estructurados. La cobertura y los recuentos evolucionarán a medida que el corpus se amplíe y mantenga.
Interfaces
| Superficie | Dirección | Rol |
|---|---|---|
| Aplicación web | aturan.org | Descubrimiento e investigación legal orientada a humanos. |
| Servidor MCP | aturan.org/mcp | Conexión MCP remota para clientes y agentes de IA. |
| API REST | aturan.org/api | Integración de aplicaciones. |
| Discover | aturan.org/discover | Punto de entrada para explorar Aturan.org. |
Acceso al servicio
Aturan.org ofrece niveles de acceso gratuitos y de pago. El acceso a la aplicación web alojada, al servidor MCP y a la API REST se rige por los términos de servicio aplicables, credenciales, cuotas y límites del plan.
El logotipo y el nombre Aturan.org son activos de marca propietarios. Una futura licencia de repositorio se aplicará únicamente al código fuente y la documentación que se publiquen realmente en este repositorio; no regirá el backend privado ni reemplazará los términos de servicio.