# Trascrizioni per agenti IA e pipeline LLM

> Ottieni trascrizioni per agenti IA da link o file via MCP, Agent Skill (SKILL.md) o REST. Testo con timestamp da leggere a pagine, anche per video lunghi.

Canonical: https://transcript1.com/it/use-cases/trascrizioni-per-agenti-ia
Language: it
Last updated: 2026-10-19

Le trascrizioni per agenti IA danno al tuo modello testo con timestamp da cercare, citare o riassumere. Collega il tuo assistente tramite MCP, aggiungi l’Agent Skill oppure usa REST. Puoi partire da un file o da un link YouTube, X, TikTok, Instagram, Facebook o Bluesky. Funzionano anche clip e VOD conclusi di Twitch, video Dailymotion, Pin video di Pinterest, post video di LinkedIn e video di Snapchat Spotlight.

- Server MCP con 8 tool
- Agent Skill nel file SKILL.md
- Testo a pagine per la finestra di contesto

## Un agente che sa cosa leggere e quando aspettare

### Collega il tuo assistente via MCP

Claude, ChatGPT, Cursor, VS Code e Claude Code possono collegarsi a https://api.transcript1.com/mcp e chiamare direttamente i tool di transcript1.

### Dai all’agente le istruzioni giuste

SKILL.md spiega come collegarsi, quali tool usare e come evitare trascrizioni duplicate. Da llms.txt l’agente trova la documentazione API.

### Leggi senza riempire il contesto

MCP restituisce di default testo con un timestamp per riga. Le pagine finiscono tra un segmento e l’altro; next_from_seconds indica da dove proseguire.

### Riprendi una trascrizione già avviata

Con un link completo, transcribe riusa una trascrizione corrispondente delle ultime 24 ore. Non vale per i link brevi. Se hai già l’ID, leggi quel lavoro con get_transcription.

### Usa REST nella tua pipeline

Per elaborare più registrazioni usa la stessa API, con webhook, segmenti JSON e timestamp delle parole. Il tuo codice passa poi il testo al modello.

## Avvia una volta, poi segui l’ID

Il tool transcribe aspetta la trascrizione e restituisce la prima pagina. Se il lavoro è ancora in corso, conserva l’id ricevuto e usa get_transcription: non inviare di nuovo il video. I parametri di entrambe le chiamate sono nella [documentazione dei tool MCP](https://transcript1.com/it/docs/mcp#tools).

Nelle istruzioni dell’agente separa l’avvio di una trascrizione dalla sua lettura. Avviare un lavoro può consumare minuti; consultarlo tramite ID serve a controllare lo stato o a recuperare il testo. Salva l’ID nello stato persistente del task, non solo nella conversazione del modello: deve restare disponibile anche dopo un riavvio.

Se gestisci una coda, conserva il link accanto a ogni ID. Un link completo permette di ritrovare una trascrizione recente dello stesso video con le stesse opzioni; un link breve di condivisione non si può abbinare al momento dell’invio. Quando conosci già l’ID, leggerlo è la scelta più semplice. L’esempio usa un segnaposto per il link a un post video pubblico di Bluesky.

### Chiamate ai tool MCP

```
transcribe(url="[public bsky.app video-post URL]")

get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", from_seconds=900)
```

## Aggiungi le istruzioni all’agente

Un agente che supporta le skill può trovare transcript1 nell’indice e leggere come usarlo nel file SKILL.md.

L’Agent Skill descrive la sequenza delle chiamate e la gestione degli errori. MCP mette a disposizione i tool; il file spiega all’agente come usarli. Puoi seguire lo stesso ciclo in una pipeline REST, senza un client MCP. llms.txt porta alla documentazione: non è un endpoint per raccogliere trascrizioni.

Scegli in base a dove gira il codice. A un assistente interattivo convengono le pagine di testo di MCP; a un servizio in background, le chiamate REST e i webhook firmati di fine elaborazione. Tutti i client condividono i limiti e i minuti dello stesso account. Tienine conto quando decidi quanti lavori avviare insieme.

### Indice delle skill e file SKILL.md

```
https://transcript1.com/.well-known/agent-skills/index.json
https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md
```

## Passa la trascrizione alla tua pipeline LLM

Per dare al tuo LLM il testo di un video, [recupera la trascrizione con timestamp](https://transcript1.com/it/docs/api-reference#get-a-transcription) e passala al modello. Con MCP leggi le pagine successive senza riempire la finestra di contesto; con REST puoi raccogliere più trascrizioni tramite [webhook](https://transcript1.com/it/features/webhook-trascrizione).

Non separare il testo dalla fonte. Conserva l’ID, il link e i tempi di inizio e fine insieme a ogni passaggio. Se crei blocchi per la ricerca, taglia tra segmenti completi o al cambio di argomento, non a metà parola o intervento. Sarà più facile verificare una citazione anche dopo il riassunto.

Il riassunto e l’estrazione delle informazioni spettano all’assistente, non a transcript1. Chiedigli di distinguere citazioni e parafrasi e di segnalare ciò che manca nella fonte. Una demo su Instagram può mostrare un passaggio senza descriverlo a voce: dalla sola trascrizione il modello non può sapere cosa c’è sullo schermo.

### cURL

```
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text&timestamps=true" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
```

## Ha letto tutto il video o solo l’inizio?

Finché la risposta MCP contiene next_from_seconds, c’è altro testo da leggere. Passa quel valore come from_seconds nella chiamata successiva e registra le pagine lette. La prima può contenere una buona introduzione senza arrivare all’argomento centrale o alla conclusione.

Prima della sintesi finale raccogli i passaggi utili da tutte le pagine e mantieni i timestamp negli appunti intermedi. Più avanti il relatore potrebbe correggersi o aggiungere una condizione. Se confronti più registrazioni, indica quali hai letto e quali non erano disponibili: una fonte non letta non conferma né smentisce le altre.

- [Usare le trascrizioni dei video Bluesky](https://transcript1.com/it/features/trascrivere-video-bluesky)
- [Cosa si ricava dall’audio di un video Instagram](https://transcript1.com/it/features/trascrivere-reel-instagram)

## Distingui un errore da un lavoro ancora in corso

Per elaborare audio con agenti IA, fai arrivare al chiamante lo stato reale. Un errore login_required o no_audio richiede un altro input; una trascrizione ancora in corso richiede un nuovo controllo dello stato. Non sostituire un errore con testo vuoto: il modello potrebbe scambiarlo per una registrazione senza parlato.

Per un file locale serve un ambiente capace di caricarne i byte. I tool MCP preparano e completano l’upload, ma i dati viaggiano con chiamate HTTP PUT fuori da MCP. Se l’assistente non può farle, indica all’utente il caricamento nella dashboard. Poi l’agente può leggere la trascrizione usando l’ID ottenuto.

- [Tool MCP, pagine di testo e caricamento dei file](https://transcript1.com/it/docs/mcp)

## Domande frequenti

### Quali assistenti posso collegare?

Qualsiasi client MCP che supporti server remoti, tra cui Claude, ChatGPT, Cursor, VS Code e Claude Code. Gli agenti che leggono file SKILL.md possono usare anche l’Agent Skill.

### Come accede l’agente al mio account?

Con Claude e ChatGPT accedi tramite OAuth. Per gli altri agenti crea una chiave API con prefisso t1_ e inviala come token Bearer.

### E se il testo non entra nel contesto del modello?

L’agente lo legge a pagine. Ogni pagina termina al confine di un segmento e restituisce next_from_seconds quando c’è altro testo. Passando quel valore come from_seconds, l’agente continua da lì.

### Se ripeto la chiamata, pago di nuovo?

Con un link completo, transcribe riusa una trascrizione dello stesso video con le stesse opzioni entro 24 ore. Questo riuso non funziona con i link brevi. Se hai già l’ID, usa get_transcription: leggi il lavoro esistente senza nuovi addebiti.

### Posso chiedere a Claude di riassumere il video?

Sì. transcript1 fornisce la trascrizione tramite MCP, poi Claude scrive il riassunto a partire dal testo letto. Puoi anche passare la trascrizione a una tua pipeline LLM. transcript1 non genera il riassunto.

## Approfondisci

- [Trascrizioni via MCP](https://transcript1.com/it/features/server-mcp-trascrizione)
- [Collegare il server MCP (documentazione)](https://transcript1.com/it/docs/mcp)
- [Webhook](https://transcript1.com/it/features/webhook-trascrizione)
- [Trascrizioni TikTok](https://transcript1.com/it/features/trascrizione-tiktok)