# Gazzetta Ufficiale RAG — Leggi, Decreti e Concorsi (Italia) (`promptica/gazzetta-ufficiale-rag`) Actor Estrae atti normativi e concorsi pubblici dalla Gazzetta Ufficiale italiana (gazzettaufficiale.it) come record Markdown strutturati, pronti per pipeline RAG. Filtra per serie, tipo atto, data, e parola chiave. Dati 100% pubblici, nessuna chiave API. - **URL**: https://apify.com/promptica/gazzetta-ufficiale-rag.md - **Developed by:** [Lorenzo Talamucci](https://apify.com/promptica) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Gazzetta Ufficiale RAG — Leggi, Decreti e Concorsi (Italia) Estrae **atti normativi e bandi di concorso** dalla [Gazzetta Ufficiale della Repubblica Italiana](https://www.gazzettaufficiale.it) producendo record **Markdown strutturati, pronti per pipeline RAG**. Copre tutte le serie principali: **Serie Generale** (leggi, decreti, ordinanze) e **4ª Serie Speciale** (concorsi pubblici). Dati **100% pubblici** — nessuna chiave API, nessun abbonamento. --- ### A chi serve - Team legali e compliance che indicizzano la normativa italiana in sistemi RAG/LLM. - HR e recruiting: monitoraggio dei concorsi pubblici attivi (Camera, Ministeri, PA locale). - Policy analyst e giornalisti: alert su nuovi decreti e leggi per area tematica. - Ricercatori che costruiscono corpus normativi italiani strutturati. --- ### Filtri (input) | Campo | Tipo | Default | Descrizione | |---|---|---|---| | `dataInizio` | `YYYY-MM-DD` | 7 giorni fa | Prima data di pubblicazione GU | | `dataFine` | `YYYY-MM-DD` | oggi | Ultima data di pubblicazione GU | | `serie` | array | `["sg","s4"]` | Serie da includere (`sg`=Generale, `s4`=Concorsi, `s5`=Contratti) | | `tipiAtto` | array | tutti | Es. `["LEGGE","DECRETO LEGISLATIVO"]` | | `keyword` | stringa | — | Filtra titoli contenenti questa parola | | `fetchFullText` | bool | `false` | Scarica testo integrale (più lento) | | `maxResults` | intero | `200` | Limite atti per run | --- ### Output (per atto) ```` codice, tipoAtto, emittente, dataAtto, numAtto, titolo, dataPubblicazione, serie, serieLabel, numGU, paginaGU, inVigore, scadenza, url, pdfUrl, markdownContent, textLength ``` Il campo `markdownContent` è il record RAG-ready: intestazione strutturata + (opzionale) testo integrale. --- ### Esempio di record reale (testato il 2026-07-07) #### Fonte testata ``` GET https://www.gazzettaufficiale.it/eli/gu/2026/07/04/153/sg HTTP 200 — Sommario GU Serie Generale n. 153 del 4-7-2026 ```` #### Record estratto (LEGGE — Serie Generale) ```json { "codice": "26G00139", "tipoAtto": "LEGGE", "emittente": null, "dataAtto": "2 luglio 2026", "numAtto": "119", "titolo": "Disposizioni in materia di sviluppo della carriera dirigenziale e della valutazione della performance del personale dirigenziale e non dirigenziale delle pubbliche amministrazioni.", "dataPubblicazione": "2026-07-04", "serie": "sg", "serieLabel": "Serie Generale", "numGU": 153, "paginaGU": 1, "inVigore": "19/07/2026", "scadenza": null, "url": "https://www.gazzettaufficiale.it/eli/id/2026/07/04/26G00139/sg", "pdfUrl": "https://www.gazzettaufficiale.it/eli/gu/2026/07/04/153/sg/pdf", "markdownContent": "# LEGGE n. 119 del 2 luglio 2026\n\n**Titolo:** Disposizioni in materia di sviluppo della carriera dirigenziale e della valutazione della performance del personale dirigenziale e non dirigenziale delle pubbliche amministrazioni.\n**Serie GU:** Serie Generale\n**Pubblicato:** 2026-07-04\n**Entrata in vigore:** 19/07/2026\n**Codice redazionale:** 26G00139\n**Fonte:** [Gazzetta Ufficiale](https://www.gazzettaufficiale.it/eli/id/2026/07/04/26G00139/sg)", "textLength": 512 } ```` #### Record estratto (CONCORSO — 4ª Serie Speciale) ``` GET https://www.gazzettaufficiale.it/eli/id/2026/06/30/26E03697/s4 HTTP 200 ``` ```json { "codice": "26E03697", "tipoAtto": "CONCORSO", "emittente": "CAMERA DEI DEPUTATI", "dataAtto": null, "numAtto": null, "titolo": "Pubblico concorso, per esami, a 10 posti di Collaboratore tecnico addetto ai servizi di condizionamento e termoidraulica della Camera dei deputati (D.P. 17 giugno 2026, n. 2103).", "dataPubblicazione": "2026-06-30", "serie": "s4", "serieLabel": "4ª Serie Speciale (Concorsi)", "numGU": 49, "scadenza": "14 agosto 2026", "url": "https://www.gazzettaufficiale.it/eli/id/2026/06/30/26E03697/s4", "pdfUrl": "https://www.gazzettaufficiale.it/eli/gu/2026/06/30/49/s4/pdf", "markdownContent": "# CONCORSO\n\n**Titolo:** Pubblico concorso, per esami, a 10 posti di Collaboratore tecnico addetto ai servizi di condizionamento e termoidraulica della Camera dei deputati.\n**Emittente:** CAMERA DEI DEPUTATI\n**Serie GU:** 4ª Serie Speciale (Concorsi)\n**Pubblicato:** 2026-06-30\n**Scadenza:** 14 agosto 2026\n**Codice redazionale:** 26E03697\n**Fonte:** [Gazzetta Ufficiale](https://www.gazzettaufficiale.it/eli/id/2026/06/30/26E03697/s4)", "textLength": 480 } ``` *** ### Come funziona ``` home GU (/home) └─► lista fascicoli recenti (data + numero GU + serie) └─► sommario fascicolo (/eli/gu/YYYY/MM/DD/NUM/SERIE) └─► per ogni atto: metadati dal sommario HTML └─► [opzionale] testo completo (/eli/id/YYYY/MM/DD/CODE/SERIE) ``` L'actor accede solo alle pagine pubbliche della GU, con richieste a basso volume e nel rispetto degli eventuali rate-limit dichiarati dal sito. Nessuna chiave API richiesta. *** ### URL e standard ELI La GU adotta il **European Legislation Identifier (ELI)**: - Fascicolo: `https://www.gazzettaufficiale.it/eli/gu/YYYY/MM/DD/NUM/SERIE` - Atto: `https://www.gazzettaufficiale.it/eli/id/YYYY/MM/DD/CODICE/SERIE` - PDF fascicolo: `https://www.gazzettaufficiale.it/eli/gu/YYYY/MM/DD/NUM/SERIE/pdf` Serie disponibili: `sg` (Generale), `s4` (Concorsi), `s5` (Contratti), `s1a`…`s3a`. *** ### Base giuridica e riuso dei dati Questo actor è progettato per operare entro un perimetro di riuso lecito. Prima di usarlo in produzione o di ridistribuire l'output, leggi questa sezione. **1. Testi degli atti — liberi da diritto d'autore.**\ I testi degli atti ufficiali dello Stato (leggi, decreti, bandi) non sono protetti dal diritto d'autore ai sensi dell'**art. 5 della L. 633/1941**. Il *contenuto testuale* dei singoli atti è quindi liberamente utilizzabile. **2. Banca dati GU — diritto *sui generis* del costitutore.**\ La libertà di cui sopra **non** si estende all'estrazione o al reimpiego di una **parte sostanziale** della *banca dati* della Gazzetta Ufficiale, tutelata dal **diritto sui generis** del costitutore (**art. 102-bis L. 633/1941**, in attuazione della **dir. 96/9/CE**). IPZS commercializza inoltre l'accesso alla banca dati e le pagine di `gazzettaufficiale.it` sono soggette a **Condizioni generali di utilizzo**.\ Per questo l'actor: - effettua **prelievi mirati e a basso volume** di singoli atti/fascicoli su richiesta dell'utente (limite `maxResults`, filtri per serie/data/tipo/keyword), **non** un mirror o un download massivo della banca dati; - rispetta `robots.txt` e i rate-limit dichiarati dal sito target, in linea con la policy dell'Apify Store (nessuna violazione di ToS/robots del sito di destinazione). **3. Canali ufficiali di riuso (consigliati per redistribuzione/bulk).**\ Chi deve **redistribuire** corpora normativi o effettuare estrazioni di grande scala dovrebbe attingere ai canali di riuso ufficiali, pensati per questo scopo: - **Normattiva** — `https://www.normattiva.it` (testo vigente e multivigente della normativa); - **ELI / open data** e portale **dati.gov.it** — `https://www.dati.gov.it`; - **Riuso dell'informazione del settore pubblico (PSI)** — **D.lgs. 36/2006** e succ., che disciplina il riuso, anche commerciale, dei dati pubblici alle condizioni e con le licenze di riuso pubblicate dall'ente titolare (IPZS). **4. Responsabilità dell'utente e verifica preliminare.**\ Prima di un uso commerciale o di scala, l'utente è tenuto a **verificare la versione corrente** di `https://www.gazzettaufficiale.it/robots.txt` e delle *Condizioni generali di utilizzo* IPZS, e ad accertare la licenza di riuso applicabile: se i ToS vigenti vietano l'estrazione/redistribuzione automatica, i dati vanno reperiti tramite i canali ufficiali del punto 3. L'attribuzione della fonte (**IPZS — Gazzetta Ufficiale**) va sempre mantenuta. > Nota: le verifiche puntuali di `robots.txt` e delle Condizioni generali IPZS non > possono essere eseguite in questo ambiente e restano a carico dell'utente al momento > del run; l'actor le rispetta a runtime ma non ne garantisce lo stato al di fuori della > singola esecuzione. *** ### Note operative - Il sommario GU viene pubblicato lo stesso giorno della GU (di solito mattino presto). - La GU pubblica 5 giorni/settimana; la 4ª Serie Speciale (Concorsi) tipicamente il mercoledì. - Nessuna autenticazione, nessuna chiave API — solo accesso pubblico. - Fonte: [gazzettaufficiale.it](https://www.gazzettaufficiale.it) — IPZS, Istituto Poligrafico e Zecca dello Stato. Riuso soggetto alla sezione "Base giuridica e riuso dei dati". # Actor input Schema ## `dataInizio` (type: `string`): Prima data di pubblicazione GU da includere. Vuoto = ultimi 7 giorni. ## `dataFine` (type: `string`): Ultima data di pubblicazione GU da includere. Vuoto = oggi. ## `serie` (type: `array`): Serie della Gazzetta Ufficiale da includere. sg = Serie Generale (leggi/decreti), s4 = Concorsi, s5 = Contratti Pubblici. Vuoto = tutte. ## `tipiAtto` (type: `array`): Includi solo atti con queste categorie (match parziale case-insensitive sul campo tipoAtto). Es: LEGGE, DECRETO, CONCORSO, ORDINANZA, DELIBERA. Vuoto = tutti. ## `keyword` (type: `string`): Filtra atti il cui titolo contiene questa stringa (case-insensitive). Vuoto = nessun filtro. ## `fetchFullText` (type: `boolean`): Se attivo, scarica e include il testo integrale di ogni atto (più lento, consuma più crediti). Disattivo = solo metadati dal sommario. ## `maxResults` (type: `integer`): Quanti atti estrarre al massimo (per run). ## Actor input object example ```json { "dataInizio": "2026-06-01", "dataFine": "2026-06-30", "serie": [ "sg", "s4" ], "tipiAtto": [ "LEGGE", "DECRETO LEGISLATIVO" ], "keyword": "lavoro", "fetchFullText": false, "maxResults": 200 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "serie": [ "sg", "s4" ] }; // Run the Actor and wait for it to finish const run = await client.actor("promptica/gazzetta-ufficiale-rag").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "serie": [ "sg", "s4", ] } # Run the Actor and wait for it to finish run = client.actor("promptica/gazzetta-ufficiale-rag").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "serie": [ "sg", "s4" ] }' | apify call promptica/gazzetta-ufficiale-rag --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=promptica/gazzetta-ufficiale-rag", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gazzetta Ufficiale RAG — Leggi, Decreti e Concorsi (Italia)", "description": "Estrae atti normativi e concorsi pubblici dalla Gazzetta Ufficiale italiana (gazzettaufficiale.it) come record Markdown strutturati, pronti per pipeline RAG. Filtra per serie, tipo atto, data, e parola chiave. Dati 100% pubblici, nessuna chiave API.", "version": "0.1", "x-build-id": "y91d73nBfcoHSIzob" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/promptica~gazzetta-ufficiale-rag/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-promptica-gazzetta-ufficiale-rag", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/promptica~gazzetta-ufficiale-rag/runs": { "post": { "operationId": "runs-sync-promptica-gazzetta-ufficiale-rag", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/promptica~gazzetta-ufficiale-rag/run-sync": { "post": { "operationId": "run-sync-promptica-gazzetta-ufficiale-rag", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "dataInizio": { "title": "Data inizio (YYYY-MM-DD)", "type": "string", "description": "Prima data di pubblicazione GU da includere. Vuoto = ultimi 7 giorni." }, "dataFine": { "title": "Data fine (YYYY-MM-DD)", "type": "string", "description": "Ultima data di pubblicazione GU da includere. Vuoto = oggi." }, "serie": { "title": "Serie GU", "type": "array", "description": "Serie della Gazzetta Ufficiale da includere. sg = Serie Generale (leggi/decreti), s4 = Concorsi, s5 = Contratti Pubblici. Vuoto = tutte.", "items": { "type": "string" } }, "tipiAtto": { "title": "Tipi atto (filtro)", "type": "array", "description": "Includi solo atti con queste categorie (match parziale case-insensitive sul campo tipoAtto). Es: LEGGE, DECRETO, CONCORSO, ORDINANZA, DELIBERA. Vuoto = tutti.", "items": { "type": "string" } }, "keyword": { "title": "Parola chiave (titolo/testo)", "type": "string", "description": "Filtra atti il cui titolo contiene questa stringa (case-insensitive). Vuoto = nessun filtro." }, "fetchFullText": { "title": "Scarica testo completo", "type": "boolean", "description": "Se attivo, scarica e include il testo integrale di ogni atto (più lento, consuma più crediti). Disattivo = solo metadati dal sommario.", "default": false }, "maxResults": { "title": "Numero massimo di risultati", "type": "integer", "description": "Quanti atti estrarre al massimo (per run).", "default": 200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```