> ## 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.

# Metriche aziendali

> Recupera valori specifici di metriche finanziarie per un'azienda tramite slug — usalo quando hai bisogno di metriche non coperte da syrto_get_company_analysis.

`syrto_get_company_metrics` recupera valori di metriche individuali per slug per un'azienda. Usalo quando hai bisogno di metriche specifiche non già coperte da [`syrto_get_company_analysis`](/it/mcp/tools/company-analysis) — ad esempio, singole voci di bilancio, set di metriche personalizzati o confronti precisi tra aziende.

<Tip>
  Per un'analisi finanziaria generale, usa [`syrto_get_company_analysis`](/it/mcp/tools/company-analysis) — restituisce tutte e quattro le categorie Syrto più i punteggi radar in un'unica chiamata, senza bisogno di cercare gli slug.

  Per trovare gli slug delle metriche, usa [`syrto_list_available_metrics`](/it/mcp/tools/list-available-metrics) o [`syrto_search_metric_definitions`](/it/mcp/tools/metric-definitions).
</Tip>

## Quando usare questo strumento

* Recuperare metriche specifiche non coperte dalle quattro categorie Syrto (es. voci grezze di bilancio, indici di nicchia)
* Confrontare aziende su un set di metriche personalizzato
* Ottenere valori di metriche per un anno specifico o su più anni

## Argomenti

<ParamField query="company_id" type="string" required>
  L'ID aziendale da [`syrto_find_company`](/it/mcp/tools/find-company).
</ParamField>

<ParamField query="metric_slugs" type="string[]">
  Lista di slug delle metriche da recuperare (es. `["total_assets", "net_financial_position"]`). Se omesso, restituisce tutte le metriche disponibili. Usa [`syrto_list_available_metrics`](/it/mcp/tools/list-available-metrics) per scoprire gli slug.
</ParamField>

<ParamField query="year" type="integer">
  Anno fiscale da recuperare (es. `2022`). Se omesso, restituisce solo l'anno più recente (controllato da `last_n_years`, che ha valore predefinito `1`). Ha la precedenza su `last_n_years`.
</ParamField>

<ParamField query="last_n_years" type="integer">
  Numero di anni più recenti da restituire. Predefinito `1` (solo l'anno più recente). Massimo `5`. Passa `null` per restituire tutti gli anni disponibili. Ignorato quando `year` è fornito.
</ParamField>

<ParamField query="include_market_data" type="boolean">
  Se `true`, ogni metrica include un campo `market_value` con il benchmark di settore per il confronto. Predefinito: `false`.
</ParamField>

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

<Warning>
  Non è possibile omettere sia `metric_slugs` che `year` — questo restituirebbe tutte le metriche su tutti gli anni, superando i limiti di risposta. Fornisci almeno uno dei due.
</Warning>

## Risposta

Un oggetto JSON con `company_name`, `available_years` e dati per anno. Ogni anno contiene:

<ResponseField name="available_years" type="integer[]">
  Tutti gli anni fiscali con dati disponibili per questa azienda.
</ResponseField>

<ResponseField name="year" type="integer">
  Anno fiscale.
</ResponseField>

<ResponseField name="size" type="string">
  Classificazione PMI UE per quell'anno.
</ResponseField>

<ResponseField name="employee_count" type="float | null">
  Organico per quell'anno.
</ResponseField>

<ResponseField name="metrics" type="object[]">
  Lista di oggetti metrica, ciascuno con:

  * `name` — nome della metrica leggibile
  * `slug` — identificativo interno (usa `name` per la visualizzazione)
  * `value` — valore numerico (o `null` se non disponibile)
  * `better_when` — oggetto `{"when_type": "HIGHER"}`, `{"when_type": "LOWER"}`, `{"when_type": "NEAR_TARGET"}`, o `null`
  * `market_value` — benchmark di settore (solo quando `include_market_data` è `true`)
</ResponseField>

<ResponseField name="radar.efficiency" type="float | null">
  Punteggio efficienza (0–100): quanto bene l'azienda converte le risorse in risultati.
</ResponseField>

<ResponseField name="radar.size" type="float | null">
  Punteggio dimensione (0–100): quanto è grande e stabile l'azienda rispetto al suo settore.
</ResponseField>

<ResponseField name="radar.trajectory_distance / trajectory_angle" type="float">
  Movimento anno su anno nello spazio radar.
</ResponseField>

<ResponseField name="note" type="string">
  Nota di contesto sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.
</ResponseField>

## Esempio

**Ottenere metriche specifiche di bilancio per Barilla:**

```json theme={null}
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
  "metric_slugs": ["total_assets", "net_financial_position"]
}
```

**Risultato:**

* Restituisce solo le metriche richieste per l'anno più recente per impostazione predefinita
* Usa `last_n_years` per i trend, o `year` per un periodo specifico
* Usa [`syrto_list_available_metrics`](/it/mcp/tools/list-available-metrics) per scoprire gli slug disponibili