# RNA Aiuti di Stato – Ricerca Aziende e De Minimis (`beyondforge/rna-aiuti-di-stato`) Actor

Cerca e analizza gli aiuti di Stato del Registro Nazionale Aiuti di Stato (RNA) per singole aziende o liste fino a 250 imprese. Supporta Partita IVA, Codice fiscale, filtri avanzati, verifica De Minimis e dettagli XML. Actor non ufficiale, indipendente e non affiliato al portale RNA.

- **URL**: https://apify.com/beyondforge/rna-aiuti-di-stato.md
- **Developed by:** [Dario Mattioli](https://apify.com/beyondforge) (community)
- **Categories:** Automation, Developer tools
- **Stats:** 1 total users, 0 monthly users, 65.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 ricerca azienda rnas

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

RNA Aiuti di Stato è un Actor per cercare, filtrare e analizzare i dati pubblici del Registro Nazionale Aiuti di Stato (RNA) in modo automatizzato e scalabile.

È pensato per chi deve effettuare una verifica aiuti di Stato, una verifica De Minimis o una visura aiuti di Stato su una singola impresa oppure su molte aziende insieme, senza ripetere manualmente la stessa ricerca sul portale pubblico RNA.

Avviso: questo è un Actor indipendente e non ufficiale. Non è affiliato, sponsorizzato o approvato dal Registro Nazionale Aiuti di Stato (RNA) o dagli enti che gestiscono il relativo portale pubblico.

L'Actor utilizza i dati pubblici disponibili nella sezione Trasparenza Aiuti di Stato del Registro Nazionale Aiuti di Stato e li restituisce in un Dataset strutturato, pronto per analisi, export e automazioni.

Perché usare questo Actor invece della ricerca manuale sul sito RNA?

Il portale ufficiale RNA è adatto a una ricerca manuale. Questo Actor aggiunge valore quando devi lavorare su più aziende, ripetere controlli o integrare i risultati in un flusso automatico.

Puoi:

cercare fino a 250 aziende in una sola Run;

mescolare liberamente nomi azienda, Partite IVA e Codici fiscali;

applicare filtri a tutte le aziende della Run;

ottenere risultati normalizzati nello stesso Dataset;

mantenere il collegamento tra ogni risultato e la ricerca che lo ha generato;

effettuare controlli su aiuti De Minimis e procedure di Notifica;

arricchire facoltativamente i risultati con i dettagli XML ufficiali RNA;

usare i risultati tramite Apify Console, Dataset, API, integrazioni e automazioni.

Questo rende l'Actor particolarmente utile per controlli massivi, due diligence, compliance, monitoraggio di finanziamenti pubblici e analisi di imprese beneficiarie di contributi.

Come cercare gli aiuti di Stato RNA

Ricerca singola

Per una singola azienda puoi cercare usando:

Nome azienda

Codice fiscale

Partita IVA

COR

CAR

Quando disponibile, Partita IVA o Codice fiscale rappresentano il metodo più preciso.

Esempio:

90049440325

oppure:

BITRABI INNOVATION GROUP

Ricerca massiva di aziende

La funzione principale dell'Actor è la ricerca in blocco.

Puoi inserire fino a 250 ricerche, una per riga, anche mescolando nomi e identificativi:

BITRABI INNOVATION GROUP
90049440325
ROSSI INDUSTRIA SRL
01234567890

L'Actor riconosce automaticamente se una riga contiene:

un nome azienda;

una Partita IVA / Codice fiscale numerico.

Per casi ambigui puoi specificare esplicitamente il tipo:

name:ROSSI INDUSTRIA SRL
tax:01234567890

Ogni risultato mantiene il valore originale della ricerca, così è semplice capire a quale azienda appartiene anche in una Run con molte imprese.

Verifica De Minimis e Tipo procedimento

L'Actor supporta la verifica del Tipo procedimento.

I valori attualmente verificati sono:

De Minimis

Notifica

La verifica De Minimis viene eseguita controllando anche i dettagli XML pubblici RNA, invece di affidarsi soltanto al risultato sintetico della ricerca.

Questo permette di usare l'Actor anche come supporto per una visura De Minimis o per controllare se gli aiuti trovati appartengono alla procedura desiderata.

Il filtro Tipo procedimento richiede richieste aggiuntive ai dettagli RNA e può quindi aumentare tempo e traffico della Run.

Filtri avanzati

Puoi combinare più filtri nella stessa ricerca:

Regione

Data concessione da

Data concessione a

Importo minimo dell'aiuto

Importo massimo dell'aiuto

Soggetto concedente

Tipo procedimento

COR

CAR

I filtri vengono applicati anche alle ricerche massive.

Esempio: puoi cercare 100 aziende in una sola Run e tenere soltanto gli aiuti concessi in una determinata regione, in un intervallo di date o entro una certa fascia di importo.

Soggetto concedente

Puoi filtrare per autorità concedente usando un campo testuale.

Esempi:

Comune di Trieste
Agenzia delle Entrate
Regione Emilia-Romagna

Il campo è libero perché i soggetti concedenti possono essere moltissimi: Comuni, Regioni, Ministeri, Agenzie, Camere di commercio e altri enti.

Dettagli completi XML

La modalità Dettagli completi apre il dettaglio pubblico RNA dell'aiuto e utilizza il relativo XML ufficiale per arricchire il Dataset.

A seconda dei dati disponibili, possono essere aggiunti campi come:

autorità concedente;

tipo beneficiario;

base giuridica nazionale;

descrizione del progetto;

CUP;

atto di concessione;

misura attuativa;

autorità attuativa;

tipo procedimento;

regolamenti;

obiettivi;

settori di attività;

strumenti di aiuto;

componenti dell'aiuto;

importi di dettaglio.

Questa modalità è facoltativa perché richiede più richieste rispetto alla ricerca rapida.

Quali dati restituisce l'Actor?

Ogni record può includere campi come:

{
"status": "success",
"searchType": "taxId",
"searchValue": "90049440325",
"beneficiaryName": "CENTRO CULTURALE VERITAS",
"taxId": "90049440325",
"region": "Friuli-Venezia Giulia",
"car": "17496",
"cor": "6113992",
"euAidCode": "SA.62495",
"measureType": "Regime di aiuti",
"grantDate": "2021-10-05",
"aidAmountEur": 310.8,
"sourceUrl": "https://www.rna.gov.it/trasparenza/aiuti/6687205",
"source": "Registro Nazionale Aiuti di Stato (RNA)"
}

I dati vengono salvati nel Dataset Apify e possono essere utilizzati per export, API, integrazioni, fogli di calcolo, database o workflow automatici.

Tracciabilità della ricerca

Nelle ricerche massive, ogni risultato conserva informazioni utili come:

searchPosition

searchType

searchValue

queryTotalAvailable

queryResultsSaved

truncated

detailsStatus

errorMessage

In questo modo puoi ricostruire facilmente quale input ha prodotto ogni record.

Limite risultati per azienda

maxResultsPerQuery viene applicato separatamente a ogni azienda.

Esempio:

Aziende cercate: 50
maxResultsPerQuery: 20

L'Actor può salvare fino a 20 risultati per ciascuna delle 50 aziende.

Se RNA dispone di più risultati rispetto al limite scelto, il Dataset indica che la ricerca è stata troncata.

Casi d'uso

Verifica aiuti di Stato

Controlla quali aiuti pubblici risultano associati a una o più imprese.

Verifica De Minimis

Filtra gli aiuti in base alla procedura De Minimis utilizzando anche la verifica dei dettagli RNA.

Visura aiuti di Stato

Ottieni un Dataset strutturato con i risultati relativi a un beneficiario, senza dover copiare manualmente le informazioni dal portale.

Controllo massivo di aziende

Analizza liste di clienti, fornitori, partecipate, prospect o controparti in una sola Run.

Due diligence e compliance

Integra i dati RNA in controlli interni, report, sistemi di monitoraggio o processi di due diligence.

Analisi finanziamenti pubblici aziende

Raccogli in modo strutturato informazioni su contributi, sovvenzioni, incentivi e altri aiuti pubblici registrati in RNA.

Automazione

Usa l'Actor tramite API o integrazioni per effettuare controlli ricorrenti e alimentare database, dashboard o workflow esterni.

Ricerca rapida o dettagli completi?

Ricerca rapida

Consigliata quando ti servono:

identificazione del beneficiario;

importo;

data;

regione;

misura;

COR / CAR;

URL RNA.

È la modalità più veloce.

Ricerca arricchita

Consigliata quando ti servono anche i campi disponibili nel dettaglio XML ufficiale.

Richiede più richieste e quindi può essere più lenta.

Limiti e note

L'Actor utilizza dati pubblici del Registro Nazionale Aiuti di Stato.

La disponibilità dei dati dipende dal servizio pubblico RNA.

Una ricerca per nome può restituire corrispondenze più ampie rispetto a una ricerca per Partita IVA o Codice fiscale.

I campi dei dettagli completi dipendono dalle informazioni presenti nell'XML del singolo aiuto.

L'Actor non crea, modifica o invia pratiche: legge esclusivamente dati pubblici di trasparenza.

Eventuali cambiamenti tecnici del portale RNA possono richiedere aggiornamenti dell'Actor.

English summary

RNA Aiuti di Stato – Bulk Company Search, De Minimis & XML automates searches in Italy's public National State Aid Registry.

It supports:

single-company searches;

bulk searches of up to 250 companies;

mixed company names, VAT numbers and tax IDs;

advanced filters;

De Minimis and notification procedure checks;

optional XML detail enrichment;

structured Dataset output for API, exports and automation.

It is designed for due diligence, compliance, subsidy monitoring, company screening and large-scale public State aid research.

This is an unofficial independent Actor and is not affiliated with, sponsored by, or endorsed by the Registro Nazionale Aiuti di Stato or its operators.

Fonte dei dati

Dati pubblici di trasparenza provenienti dal:

Registro Nazionale Aiuti di Stato (RNA)
https://www.rna.gov.it/trasparenza/aiuti

# Actor input Schema

## `companyName` (type: `string`):

Denominazione del beneficiario. Non è necessario conoscere la Partita IVA.

## `taxId` (type: `string`):

Codice fiscale o Partita IVA del beneficiario. È il metodo più preciso quando il dato è disponibile.

## `bulkSearches` (type: `string`):

Inserisci una ricerca per riga. Per casi ambigui puoi usare facoltativamente name: oppure tax: prima del valore.

## `region` (type: `string`):

Filtra per regione del beneficiario. Seleziona una regione oppure lascia vuoto.

## `grantDateFrom` (type: `string`):

Data iniziale dell'intervallo di concessione.

## `grantDateTo` (type: `string`):

Data finale dell'intervallo di concessione.

## `minAidAmountEur` (type: `number`):

Importo minimo dell'aiuto in euro.

## `maxAidAmountEur` (type: `number`):

Importo massimo dell'aiuto in euro.

## `grantingAuthority` (type: `string`):

Denominazione dell'autorità che concede l'aiuto. Rimane un campo libero perché gli enti possibili sono moltissimi (Ministeri, Regioni, Comuni, Camere di commercio, Agenzie, ecc.).

## `procedureType` (type: `string`):

Puoi scegliere un valore verificato oppure digitare un valore personalizzato. Attualmente sono verificati Notifica e De Minimis.

## `cor` (type: `string`):

Codice univoco RNA dell'aiuto individuale.

## `car` (type: `string`):

Codice identificativo RNA della misura di aiuto.

## `includeFullDetails` (type: `boolean`):

Attiva per ottenere anche autorità concedente, base giuridica, tipo beneficiario, procedimenti, strumenti, componenti e altri campi disponibili nell'XML RNA.

## `maxFullDetailsPerRun` (type: `integer`):

Limite di sicurezza complessivo per i download XML. Viene usato anche quando il filtro Tipo procedimento richiede una verifica XML.

## `maxResultsPerQuery` (type: `integer`):

Numero massimo di aiuti da salvare per ogni ricerca. Se ne esistono altri, il risultato indicherà che la ricerca è stata troncata.

## Actor input object example

```json
{
  "companyName": "BITRABI INNOVATION GROUP",
  "taxId": "90049440325",
  "bulkSearches": "BITRABI INNOVATION GROUP\n90049440325",
  "grantingAuthority": "Comune di Trieste",
  "includeFullDetails": false,
  "maxFullDetailsPerRun": 250,
  "maxResultsPerQuery": 100
}
```

# Actor output Schema

## `results` (type: `string`):

Search results stored in the default Apify Dataset.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("beyondforge/rna-aiuti-di-stato").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("beyondforge/rna-aiuti-di-stato").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call beyondforge/rna-aiuti-di-stato --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,beyondforge/rna-aiuti-di-stato"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/l7ClRP00jSFhFc1G5/builds/DHagPyYDGucHUHvuR/openapi.json