---
name: fak-consult
description: Skill per SuperLuca — consultazione dati FAK (Freight All Kinds) per confronto tariffe carrier. SOLA LETTURA.
author: Emma
---

# Skill: FAK Consult per SuperLuca 🧠⚡

## Accesso

SuperLuca ha accesso **solo in lettura** ai dati FAK. Può leggere il file `comparison_data.json` per rispondere a domande di Raffaele sulle tariffe.

## Struttura Dati

I dati FAK sono accessibili **solo via API HTTP** (SuperLuca non ha accesso diretto al file system).

**Endpoint API:** `http://localhost:8081/fak`
- Elenca tutti i carrier e le loro tariffe

**Ricerca:** `http://localhost:8081/fak/search?q=SHANGHAI`
- Cerca per POL/POD/rotta in tutti i carrier
- Esempio: cercare `SHANGHAI` trova tutte le rotte con SHANGHAI come POL
- Esempio: cercare `GENOVA` trova tutte le rotte con GENOVA come POD

**Per carrier:** `http://localhost:8081/fak/carrier/evergreen`
- Mostra solo le tariffe di un carrier specifico
- Carrier disponibili: `evergreen`, `cosco`, `msc`

### Struttura Dati (dall'API)

```json
{
  "rates": {
    "evergreen": { ... },
    "cosco": { ... },
    "msc": "forfettarie o dettaglio"
  },
  ...
}

Ogni carrier ha rotte con:
- `pol`: Port of Loading (es. SHANGHAI)
- `pod`: Port of Discharge (es. GENOVA)
- `container_type`: 20'DV, 40'HC, etc.
- `price_usd`: prezzo in USD
- `valid_from` / `valid_to`: validità

## Domande tipiche di Raffaele

- "Qual è il miglior prezzo da SHANGHAI a GENOVA in 40'HC?"
- "Confronta Evergreen e Cosco sulla rotta NINGBO → NAPOLI"
- "Quali rotte ha MSC?"
- "Mostra le top 5 rotte più economiche per 40'HC"
- "Per POL=X, POD=Y, qual è il carrier più conveniente?"

## Come Consultare (per SuperLuca)

Non avendo tool `file`, SuperLuca consulta i dati FAK via `web_extract`:

```
web_extract(urls=['http://localhost:8081/fak'])
# Per cercare: web_extract(urls=['http://localhost:8081/fak/search?q=SHANGHAI'])
# Per singolo carrier: web_extract(urls=['http://localhost:8081/fak/carrier/evergreen'])
```

L'API è sulla porta 8081 dello stesso server (localhost), non via internet.

## ⚠️ Limiti

- **SOLO LETTURA** — SuperLuca NON può modificare, cancellare o aggiungere dati FAK
- **NON ha accesso** a terminale, file system generale, cron, sessioni, memoria
- **NON può** creare tool, eseguire codice, o modificare configurazione
- **NON può** vedere i ticket di Emma o i costi di Kuki
- **Accesso via API** — usa `web_extract(urls=['http://localhost:8081/fak'])` per consultare dati

## File Path (solo per Emma, non per SuperLuca)

Il file dati FAK è in: `/home/oem/.hermes/fak-comparison/comparison_data.json`
Il server API è su `http://localhost:8081` gestito da `~/oem/.hermes/fak-api.py`