Un agente IA non dovrebbe leggere una tabella. Dovrebbe chiamare uno strumento che restituisce la tabella e poi eseguire operazioni aritmetiche sulle righe. Con GroupDocs.Parser.Mcp in esecuzione localmente in Docker, un client IA come Claude Desktop o Cursor può estrarre tabelle da file PDF, Word ed Excel e riceverle come JSON:

Estrai le righe di dettaglio da invoice.pdf come JSON e calcola il totale della colonna importo.

La versione passo‑passo con configurazione e risoluzione dei problemi è nella documentazione: Come estrarre tabelle dai documenti in dati strutturati.

Cosa va storto quando un modello legge direttamente la tabella?

Il flusso di lavoro comune consiste nell’incollare un PDF in una chat e chiedere la tabella. Il modello vede un flusso di testo appiattito, inferisce dove fossero le colonne e riscrive le righe. Ogni cella diventa quindi una previsione. Una colonna mancante, una riga unita o un decimale spostato non generano un errore; producono una tabella ben formattata e sicura, ma leggermente errata. Per un elenco di frutta non importa. Per i totali delle fatture è di fondamentale importanza.

Il fallimento è difficile da individuare perché l’output sembra corretto. Nulla nella risposta della chat indica quali celle sono state lette dal file e quali sono state ricostruite.

Qual è l’alternativa a far indovinare il modello?

Sposta la lettura fuori dal modello. Lo strumento extract_tables rileva le tabelle con il motore del documento e le restituisce come dati:

  • Markdown per impostazione predefinita, come sezioni ### Table N (page N, R×C) che vengono renderizzate direttamente nella chat, in VS Code e su GitHub.
  • JSON con format: "json", come un array di oggetti { table, page, rows, columns, data }, dove data è una griglia di stringhe.

Il modello non trascrive mai una cella. Riceve data e lavora con essa, così il suo compito si riduce a ciò che fa in modo affidabile: sommare, confrontare, filtrare e spiegare. Lo strumento supporta PDF, DOCX, XLSX, PPTX e HTML, quindi lo stesso prompt copre una fattura fornitore, un report Word e un foglio di calcolo.

Come ottenere la tabella in formato JSON?

Specifica il formato nel prompt.

Estrai le righe di dettaglio come JSON e calcola il totale della colonna importo.

Example session (abridged)
You:    Extract the line items from invoice-014.pdf as JSON and total the amount column.
Agent:  [calls extract_tables with format "json"]
        {"table": 1, "page": 1, "rows": 4, "columns": 3,
         "data": [["Item", "Qty", "Amount"],
                  ["Paper A4", "10", "48.00"],
                  ["Toner", "2", "170.00"],
                  ["Delivery", "1", "22.00"]]}
        Total of the Amount column: 240.00 across 3 line items.

Poiché l’agente conserva le righe, i passaggi successivi sono domande ordinarie: quale riga è la più grande, il totale corrisponde al valore stampato nel testo, scrivere le righe in un CSV nella cartella di output. Quando l’aritmetica è importante, chiedi all’agente di elencare le righe che ha sommato così da poterle verificare.

Quando dovresti richiedere Markdown invece di JSON?

Usa Markdown quando il risultato lo leggerà una persona, e JSON quando lo utilizzerà il codice. Markdown è l’impostazione predefinita ed è il modo più veloce per visualizzare una tabella e valutare se è stata trovata correttamente. Passa a JSON per i totali, i controlli incrociati e qualsiasi cosa che alimenti un foglio di calcolo o un database. Se sai dove si trova la tabella, restringi la chiamata:

Estrai la tabella a pagina 4.

Il parametro page limita il rilevamento a una sola pagina, rendendo l’operazione più veloce e, con licenza a consumo, più economica.

Quali casi richiedono ancora un controllo umano?

I limiti onesti sono più rilevanti con le tabelle rispetto al testo semplice.

  • Le scansioni non hanno tabelle da trovare. Senza uno strato di testo non esiste una struttura di tabella, e l’estrazione restituisce un risultato vuoto. Non c’è OCR in questo server.
  • I layout complessi variano. Celle unite, tabelle annidate e tabelle che continuano su più pagine non sempre sopravvivono in modo pulito come una griglia semplice. Controlla un documento prima di eseguire duecento.
  • La modalità di valutazione è limitata. Senza licenza, l’estrazione è limitata; i limiti esatti sono nella pagina di licenza della libreria. Chiedi all’agente di chiamare get_license_status prima di un’esecuzione reale.

Installalo con un solo comando

Il server è distribuito solo come immagine Docker, quindi non esiste il comando dnx. Registralo in Claude Code così, sostituendo il percorso con la tua cartella dei documenti:

claude mcp add groupdocs-parser -- docker run --rm -i \
  -v /path/to/documents:/data ghcr.io/groupdocs-parser/parser-net-mcp:latest

Cursor, Claude Desktop, VS Code con GitHub Copilot, Windsurf, Cline e Codex usano lo stesso contenitore con un file di configurazione specifico per il client; ciascuno è elencato in Registrazione nei client IA.

FAQ

Claude legge correttamente le tabelle PDF?
Dipende dal file e da come il client lo appiattisce, quindi verificane la precisione invece di dare per scontato. Con extract_tables le righe provengono dal rilevamento delle tabelle del motore del documento, restituite come una griglia di stringhe, e Claude lavora su quelle.

Come estraggo una tabella da un PDF in Excel con l’IA?
Richiedi la tabella in formato JSON, poi chiedi all’agente di scrivere le righe in un CSV nella cartella di output, che Excel apre. La conversione da righe a CSV è il passaggio dell’agente; i valori delle celle provengono dallo strumento.

Può estrarre tabelle da file Word ed Excel localmente?
Sì. extract_tables gestisce DOCX e XLSX così come PDF, e il contenitore legge i file dalla cartella che monti.

Approfondisci