⚖️ fiscalia - Doctrina de la Fiscalía General del Estado

Actor de Apify que automatiza la búsqueda de Circulares, Instrucciones y Consultas de la Fiscalía General del Estado, publicadas en el buscador de doctrina de BOE.es. Permite filtrar por tipo de documento, título, texto completo, año, número y materia jurídica.

Para cada documento encontrado, el actor extrae su referencia, tipo, número/año y fecha. Además, en una segunda ejecución puedes pedirle que descargue el texto completo de documentos concretos (campo documentIds) junto con su comentario de vigencia, materias y referencias normativas anteriores.

✨ Características

• 🔎 Búsqueda por hasta 4 términos de texto completo por ejecución, con operadores booleanos (Y, O, NO, PROXn).
• 🧰 Filtros: tipo de documento (Circular/Instrucción/Consulta), título, año, número y materia jurídica (25 áreas).
• ↕️ Ordenación por año (más recientes o más antiguos primero).
• 📄 Extracción bajo demanda del texto completo, la vigencia y las materias de documentos concretos.
• 🔗 Enlaces estables al documento (documentUrl) y a su PDF oficial (pdfUrl).
• ⚡ Vía HTTP directa y ligera: BOE.es no exige sesión ni bloquea IP de datacenter (a diferencia del buscador de sentencias del CENDOJ), por lo que no hace falta proxy residencial ni impersonación de navegador. Playwright actúa solo como backup ante fallos puntuales.

📥 Entrada (Input)

La entrada se define mediante un objeto JSON. Debes indicar al menos uno de estos campos: algún criterio de búsqueda (searchTerms, titulo, tipos, materias, anno o numero) o documentIds (para extraer el texto de documentos concretos).

Campo	Tipo	Descripción
searchTerms	array<string>	Términos a buscar en el texto completo de los documentos (máx. 4). Admite operadores booleanos. Si se deja vacío, se listan los documentos que cumplan el resto de filtros sin restricción de texto.
titulo	string	Busca solo en el título de la disposición (más preciso que searchTerms).
tipos	array<string>	Tipo de documento: C (Circular), I (Instrucción), Q (Consulta). Por defecto, los tres.
materias	array<string>	IDs de materia jurídica (ver tabla de referencia). Por defecto, todas.
anno	string	Año de la disposición (ej. "2020").
numero	string	Número de la disposición (ej. "5"). Combínalo con anno para localizar una disposición concreta.
documentIds	array<string>	Referencias (campo reference de resultados anteriores, ej. "FIS-C-2011-00005") de las que extraer el texto completo (máx. 50). Úsalo en una segunda ejecución tras una búsqueda.
maxResults	integer	Máximo de documentos por combinación de búsqueda (1–2000). Por defecto, 50.
paragraphs	integer	Si es mayor que 0, al extraer un documento (documentIds) devuelve solo ese número de párrafos relevantes en vez del texto íntegro. Requiere paragraphTerms. Por defecto, 0 (texto completo).
paragraphTerms	string	Términos con los que localizar los párrafos en el modo párrafos.
sortOrder	string	desc (más recientes primero, por defecto) o asc (más antiguos primero).
proxyConfiguration	object	Configuración de proxy. No es necesaria para este sitio; desactivada por defecto.

⚠️ Nota interna sobre tipos y materias. El formulario de BOE.es solo admite un valor de tipo y un valor de materia por consulta (son <select> simples, no multiselección). Si se indica más de uno en cualquiera de los dos campos, el actor repite la búsqueda una vez por cada combinación de searchTerms × tipos × materias (máximo 12 combinaciones por ejecución). Para no multiplicar innecesariamente las búsquedas, indica como mucho 1-2 valores en cada uno salvo que realmente necesites comparar varios.

🧮 Operadores de búsqueda

El campo searchTerms (y titulo) admite los mismos operadores booleanos que el resto de buscadores de BOE.es:

Operador (escribe)	Equivalente BOE.es	Significado	Ejemplo
AND	Y	Ambos términos deben aparecer.	extranjería AND expulsión
OR	O	Basta con que aparezca uno de los términos.	menor OR menores
NOT	NO	Excluye las disposiciones con ese término.	violencia NOT laboral
NEARn	PROXn	Los términos están a menos de n palabras de distancia.	expulsión NEAR10 extranjero

Notas:

• Los operadores deben escribirse en MAYÚSCULAS como palabra completa; los términos en minúsculas se tratan como texto literal.
• Puedes usar comillas para frases exactas: "unidad especializada".
• Exclusión de frases con NOT/NO: BOE.es solo excluye la palabra inmediatamente siguiente al operador. Para excluir una frase de varias palabras, enciérrala entre comillas: el actor la expande automáticamente a una exclusión por cada palabra significativa (p. ej. NOT "medidas cautelares" se envía como NO medidas NO cautelares).

🤖 Uso con Claude Code / MCP de Apify (lenguaje natural)

Este actor está pensado para integrarse en Claude Code a través del MCP de Apify: el usuario describe su necesidad en lenguaje natural y el asistente construye automáticamente searchTerms y el resto de filtros, sin que el usuario tenga que conocer los operadores ni los IDs internos.

⚠️ Límite de términos: máximo 4 por ejecución. Combínalos con operadores booleanos en vez de multiplicar entradas.

Directrices para que el asistente (LLM) genere la consulta:

• Tipo de documento (tipos): "circular/circulares" → C, "instrucción/instrucciones" → I, "consulta/consultas" → Q. Si el usuario pide "doctrina" en general sin especificar, no rellenes tipos (busca los tres).
• Materia (materias): mapea la petición del usuario al ID exacto de la tabla de materias. ⚠️ Los IDs son opacos y no siguen el orden alfabético: NO los adivines, cópialos de la tabla.
• Año / Número (anno / numero): "de 2020" → anno: "2020"; "la Circular 5/2011" → numero: "5", anno: "2011".
• Texto libre vs. título: si el usuario busca por un concepto o materia dentro del contenido, usa searchTerms; si busca por palabras del título de la disposición, usa titulo.
• Texto completo (documentIds): cuando el usuario pida "descárgame/analiza el texto de esta circular/instrucción/consulta" tras una búsqueda, relanza el actor con documentIds = las reference de los documentos elegidos.

Ejemplos de traducción de lenguaje natural a filtros:

El usuario pide...	Filtros generados
"Circulares sobre extranjería"	tipos: ["C"], materias: ["8"]
"Consultas de violencia de género"	tipos: ["Q"], materias: ["21"]
"Instrucciones de 2015 sobre menores"	tipos: ["I"], anno: "2015", searchTerms: ["menor OR menores"]
"La Circular 5/2011"	tipos: ["C"], numero: "5", anno: "2011"
"Doctrina sobre criminalidad informática, la más reciente primero"	materias: ["19"], sortOrder: "desc"

🏛️ Tabla de referencia (materias)

ID	Materia
1	Cooperación internacional
2	Derecho Administrativo y proceso contencioso-administrativo
3	Derecho Civil
4	Derecho Constitucional
5	Derecho Penal
6	Derecho Penitenciario
7	Derecho Procesal Penal
8	Extranjería
9	Ministerio Fiscal
10	Responsabilidad Penal de Menores
11	Social
12	Derecho de la Unión Europea
13	Protección jurídica del menor
14	Protección jurídica de las personas con discapacidad
15	Consumidores y usuarios
16	Derecho Procesal Civil
17	Siniestralidad laboral
18	Medio ambiente
19	Criminalidad informática
20	Delitos económicos
21	Violencia de Género
22	Seguridad vial
23	Fiscalía del Tribunal de Cuentas
24	Protección de datos de carácter personal
25	Delitos de Odio

⚠️ Verifica siempre el ID contra esta tabla antes de llamar al actor: no siguen el orden alfabético (p. ej. "Extranjería" es 8, no un número bajo por ser de las primeras letras).

📤 Salida (Output)

Modo búsqueda (searchTerms / titulo / tipos / materias / anno / numero)

{
    "searchTerm": null,
    "tipo": "Circular",
    "numero": "5",
    "anio": "2011",
    "reference": "FIS-C-2011-00005",
    "title": "Circular 5/2011, de 2 de noviembre, sobre criterios para la unidad de actuación especializada del Ministerio Fiscal en materia de extranjería e inmigración.",
    "dateISO": "2011-11-02",
    "materiaFiltro": "Extranjería",
    "documentUrl": "https://www.boe.es/buscar/doc.php?id=FIS-C-2011-00005",
    "pdfUrl": "https://www.boe.es/buscar/abrir_fiscalia.php?id=FIS-C-2011-00005.pdf"
}

Campo	Descripción
searchTerm	Término de searchTerms que originó el resultado (null si la búsqueda no usó texto libre).
tipo	Circular, Instrucción o Consulta.
numero / anio	Número y año de la disposición (ej. Circular 5/2011).
reference	Referencia interna del documento (ej. FIS-C-2011-00005); úsala en documentIds para extraer su texto.
title	Título completo de la disposición.
dateISO	Fecha de la disposición en formato YYYY-MM-DD (derivada del título).
materiaFiltro	Materia por la que se filtró la búsqueda (null si no se filtró por materia).
documentUrl	Enlace a la ficha del documento en BOE.es.
pdfUrl	Enlace de descarga del PDF oficial.

Modo extracción (documentIds)

{
    "reference": "FIS-C-2011-00005",
    "tipo": "Circular",
    "numero": "5",
    "anio": "2011",
    "title": "Circular 5/2011, de 2 de noviembre, sobre criterios para la unidad de actuación especializada del Ministerio Fiscal en materia de extranjería e inmigración.",
    "dateISO": "2011-11-02",
    "vigencia": "En vigor, salvo las modificaciones reseñadas que, en particular, afectan al contenido de las conclusiones relativas al art. 89 del Código Penal...",
    "materias": ["Derecho Penal", "Extranjería"],
    "referenciasAnteriores": ["Arts. 8, 20.6, 31 bis... de la Ley Orgánica 10/1995, de 23 de noviembre, del Código Penal. BOE-A-1995-25444", "..."],
    "documentUrl": "https://www.boe.es/buscar/doc.php?id=FIS-C-2011-00005",
    "pdfUrl": "https://www.boe.es/buscar/abrir_fiscalia.php?id=FIS-C-2011-00005.pdf",
    "text": "ÍNDICE\n\nI. Introducción: Contrabando de personas...\n\n..."
}

Campo	Descripción
vigencia	Comentario de vigencia (si BOE.es lo indica): modificaciones posteriores relevantes. null si no hay comentario.
materias	Lista de materias jurídicas asociadas al documento (etiquetas legibles).
referenciasAnteriores	Normas y disposiciones anteriores citadas como referencia (lista de texto).
text	Texto completo del documento (o los párrafos relevantes, si paragraphs > 0).
paragraphs	(Solo si paragraphs > 0 y hay coincidencias) Lista de los pasajes extraídos.

💡 A diferencia del buscador de sentencias del CENDOJ, aquí el texto se extrae directamente del HTML de la ficha (doc.php), no de un PDF: es más rápido y no requiere descargar/parsear binarios.

📝 Notas

• El volumen total de doctrina de la Fiscalía General del Estado es de unos cientos de documentos (muy por debajo del límite técnico de 2000 resultados por consulta de BOE.es).
• No se aplica anonimización de nombres: a diferencia de las sentencias judiciales, las Circulares, Instrucciones y Consultas son documentos interpretativos de la Fiscalía General del Estado y no suelen identificar a partes de procedimientos concretos.

Ecosistema legaltech — actores relacionados

Este actor forma parte de una colección de actores para búsqueda jurídica española y europea. Si la consulta del usuario requiere otras fuentes, usa el actor correspondiente sin pedirle que busque en Apify Store:

Actor	Fuente	Tipo de documentos
legaltech/fiscalia ← este actor	Fiscalía General del Estado (BOE.es)	Circulares, Instrucciones y Consultas de doctrina
legaltech/cendoj	CENDOJ (Consejo General del Poder Judicial)	Sentencias y autos del sistema judicial español
legaltech/aepd	AEPD	Resoluciones y guías de protección de datos
legaltech/tribunal-constitucional	Tribunal Constitucional de España	Sentencias del TC, recursos de amparo, cuestiones de inconstitucionalidad
legaltech/tjue	Tribunal de Justicia de la UE (CURIA)	Sentencias, autos y conclusiones del TJUE

Guía de derivación

• Doctrina, criterios de actuación o consultas del Ministerio Fiscal → legaltech/fiscalia
• Jurisprudencia civil, penal, laboral, contencioso-administrativa española → legaltech/cendoj
• Protección de datos, RGPD, LOPDGDD, sanciones de la AEPD → legaltech/aepd
• Derechos fundamentales, inconstitucionalidad, recursos de amparo → legaltech/tribunal-constitucional
• Derecho europeo, directivas, reglamentos UE, cuestiones prejudiciales → legaltech/tjue