# Da sorgente (richiede Go 1.21+)
git clone https://github.com/your-repo/statisticheisa-cli
cd statisticheisa-cli
go build -o statisticheisa-cli .

# Oppure scarica il binario precompilato dalle releases

# Mostra aiuto
statisticheisa-cli --help

# Cerca codice ISA per parola chiave
statisticheisa-cli cerca tassisti
statisticheisa-cli cerca "trasporto passeggeri" --anno 2024 --format table

# Elenco anni disponibili
statisticheisa-cli elenco-anni

# Tutti i dati ISA per un anno
statisticheisa-cli dati 2024

# Dati nazionali per un codice ISA
statisticheisa-cli nazionali 2024 DG72U
statisticheisa-cli nazionali 2024 DG72U --field totale.redditoMedio --format plain
statisticheisa-cli nazionali --anno 2024 --codisa DG72U --field totalePersoneFisiche.redditoMedio --format json

# Dati regionali
statisticheisa-cli regionali 2024 DG72U

# Lista codici ISA (con filtro opzionale)
statisticheisa-cli lista 2024 --cerca trasporto --format table

# Macroaree per un codice
statisticheisa-cli macroaree 2024 DG72U

# Dati multi-anno
statisticheisa-cli nazionali-multi 2024 DG72U Servizi U
statisticheisa-cli regionali-multi 2024 DG72U Servizi

# Grafici
statisticheisa-cli grafico-barre 2024 1 DG72U Servizi redditoMedio
statisticheisa-cli grafico-regioni 2024 1 DG72U Servizi

# Info endpoint e alias
statisticheisa-cli info

# Questi sono equivalenti:
statisticheisa-cli nazionali 2024 tassisti
statisticheisa-cli nazionali 2024 DG72U

# Altri alias: ristoranti, bar, pizzerie, idraulici, elettricisti,
# parrucchieri, commercianti, agenti-immobiliari, medici, dentisti,
# avvocati, commercialisti, architetti, ingegneri, ...

# Avvia server
statisticheisa-cli mcp

# Configurazione OpenCode (opencode.json)
{
  "mcp": {
    "servers": {
      "statisticheisa-local": {
        "type": "local",
        "command": ["go", "run", ".", "mcp"],
        "environment": {}
      }
    }
  }
}

# Avvia server su porta 8080
statisticheisa-cli mcp-http

# Oppure specifica indirizzo
statisticheisa-cli mcp-http :9090

# Configurazione OpenCode (opencode.json)
{
  "mcp": {
    "servers": {
      "statisticheisa-http": {
        "type": "remote",
        "url": "http://localhost:8080/mcp"
      }
    }
  }
}

// Inizializzazione
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}

// Lista strumenti
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

// Cerca "tassisti"
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"cerca","arguments":{"query":"tassisti","anno":2024}}}

// Dati nazionali per DG72U (tassisti)
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"nazionali","arguments":{"anno":2024,"codIsa":"DG72U","field":"totale.redditoMedio"}}}

statisticheisa-cli/
├── main.go                    # Entry point CLI
├── internal/
│   ├── aliases/aliases.go     # Risoluzione alias colloquiali
│   ├── client/client.go       # Client HTTP per API Agenzia Entrate
│   ├── client/testdata/       # Golden files per test
│   ├── format/numbers.go      # Parsing numeri italiani
│   ├── mcp/
│   │   ├── server.go          # Server MCP stdio
│   │   └── http_server.go     # Server MCP HTTP (Gin)
│   ├── output/output.go       # Formattazione output (JSON, table, CSV, plain)
│   └── search/search.go       # Ricerca fuzzy codici ISA
├── explore/                   # Script di esplorazione API (non per produzione)
├── go.mod / go.sum
└── opencode.json              # Configurazione MCP per OpenCode

# Test
go test ./...

# Build
go build -o statisticheisa-cli .

# Lint
golangci-lint run

# Esegui server HTTP in background per test
./statisticheisa-cli mcp-http &
curl -X POST http://localhost:8080/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'