> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Confronta aziende

> Confronta metriche finanziarie specifiche affiancate tra più aziende.

`syrto_compare_companies` recupera le stesse metriche per più aziende in un'unica chiamata, restituendo i risultati affiancati. È significativamente più veloce rispetto a chiamare [`syrto_get_company_metrics`](/it/mcp/tools/company-metrics) una volta per azienda.

<Tip>
  Gli slug delle metriche devono provenire da [`syrto_list_available_metrics`](/it/mcp/tools/list-available-metrics) o [`syrto_search_metric_definitions`](/it/mcp/tools/metric-definitions). Slug non validi non restituiscono dati senza segnalare errori.
</Tip>

## Quando usare questo strumento

* Confrontare specifici KPI finanziari tra 2 o più aziende affiancate
* Verificare quale azienda ha le migliori prestazioni su una data metrica (es. ROE, EBITDA)
* Ottenere trend di metriche anno su anno per più aziende contemporaneamente

Strumenti correlati: Per metriche di una singola azienda, usa [Metriche aziendali](/it/mcp/tools/company-metrics). Per statistiche a livello di settore, usa [Aggrega aziende](/it/mcp/tools/aggregate-companies). Per trovare gli ID aziendali, usa [Cerca azienda](/it/mcp/tools/find-company) o [Cerca aziende per codice fiscale](/it/mcp/tools/lookup-companies-by-tax-id) per la risoluzione in batch.

## Argomenti

<ParamField query="company_ids" type="string[]" required>
  Lista di ID aziendali da [`syrto_find_company`](/it/mcp/tools/find-company) o [`syrto_lookup_companies_by_tax_id`](/it/mcp/tools/lookup-companies-by-tax-id). Minimo 2, massimo 20.
</ParamField>

<ParamField query="metric_slugs" type="string[]" required>
  Slug delle metriche da confrontare (min 1, max 10). Esempi: `["ebitda", "roe", "net_financial_position"]`. Usa [`syrto_search_metric_definitions`](/it/mcp/tools/metric-definitions) o [`syrto_list_available_metrics`](/it/mcp/tools/list-available-metrics) per trovare slug validi.
</ParamField>

<ParamField query="year" type="integer" required>
  Anno fiscale per il confronto (es. `2023`).
</ParamField>

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

## Risposta

Un oggetto JSON con risultati per azienda e una lista di eventuali ID aziendali non riconosciuti.

<ResponseField name="companies" type="object[]">
  Un elemento per ogni azienda richiesta (nello stesso ordine di `company_ids`), ciascuno con `company_id`, `legal_name` e un array `years`.
</ResponseField>

<ResponseField name="companies[].years" type="object[]">
  Un elemento per anno fiscale. Ciascuno contiene:

  * `year` — anno fiscale
  * `size` — classificazione PMI UE
  * `employee_count` — organico (`null` se non disponibile)
  * `metrics` — lista di oggetti metrica
</ResponseField>

<ResponseField name="companies[].years[].metrics" type="object[]">
  Un elemento per ogni slug di metrica richiesto, ciascuno con:

  * `name` — nome della metrica leggibile
  * `slug` — identificativo interno
  * `value` — valore numerico (o `null` se non disponibile)
  * `better_when` — oggetto con `when_type`: `"HIGHER"`, `"LOWER"`, `"NEAR_TARGET"`, o `null`
</ResponseField>

<ResponseField name="missing_company_ids" type="string[]">
  ID aziendali della richiesta che non sono stati trovati.
</ResponseField>

<ResponseField name="warning" type="string | null">
  Presente quando gli slug delle metriche non sono stati riconosciuti (nessun dato restituito per nessuna azienda).
</ResponseField>

## Esempio

**Confrontare EBITDA e ROE per due aziende:**

```json theme={null}
{
  "company_ids": ["Zm86SVRfMDE2NTQwMTAzNDVfVTox", "Zm86SVRfMDAxNTk1NjAzNjZfVTox"],
  "metric_slugs": ["ebitda", "roe"],
  "year": 2023
}
```

**Risultato:**

* Restituisce ogni azienda con le metriche richieste per l'anno specificato
* Controlla `missing_company_ids` per verificare che tutte le aziende richieste siano state trovate