# Transcripciones para agentes de IA y tus pipelines de LLM

> Obtén transcripciones para agentes de IA por MCP, Agent Skill o API REST desde enlaces o archivos; lee textos largos por páginas y con marcas de tiempo.

Canonical: https://transcript1.com/es/use-cases/transcripciones-para-agentes-de-ia
Language: es
Last updated: 2026-10-19

Obtén transcripciones para agentes de IA desde un enlace de video o una grabación. Conecta transcript1 por MCP, usa el Agent Skill o integra la API REST. Tu pipeline de LLM recibe texto con marcas de tiempo para buscar, citar o resumir. Puedes enviar enlaces de YouTube, X, TikTok, Instagram, Facebook y Bluesky; también clips y VOD de Twitch ya terminados, videos de Dailymotion, pines de video de Pinterest, publicaciones de video de LinkedIn y videos de Snapchat Spotlight.

- Servidor MCP con ocho herramientas
- Agent Skill con instrucciones en SKILL.md
- Textos largos por páginas para cuidar el contexto

## Que el agente termine de leer antes de responder

### Herramientas listas para tu agente

Conecta Claude, ChatGPT, Cursor, VS Code o Claude Code a https://api.transcript1.com/mcp. Cualquier cliente compatible con servidores MCP remotos puede llamar las herramientas.

### Instrucciones para usarlas bien

SKILL.md explica cómo conectarse, qué llamadas hacer y cómo evitar transcripciones duplicadas. llms.txt lleva al agente a la documentación de la API.

### Una página a la vez

MCP devuelve texto con una marca de tiempo por línea. Si no cabe en una página, corta entre segmentos e indica dónde seguir con next_from_seconds.

### Sigue el mismo ID

Con un enlace completo, transcribe puede reutilizar una transcripción de las últimas 24 horas si coinciden el video y las opciones. Los enlaces cortos no permiten esa coincidencia. Si ya tienes el ID, usa get_transcription.

### REST para tu pipeline

Para procesar audio con agentes de IA en segundo plano, integra la misma API con webhooks, segmentos JSON y marcas de tiempo por palabra.

## Pide el video una vez y guarda su ID

transcribe espera la transcripción y devuelve la primera página. Si todavía no termina, entrega un id: guárdalo y consulta get_transcription en lugar de volver a enviar el video. Revisa los argumentos en la [referencia de herramientas MCP](https://transcript1.com/es/docs/mcp#tools).

Separa las llamadas que crean una transcripción de las que consultan una existente. Crear trabajo puede consumir minutos; consultar el ID sirve para revisar el avance o leer el texto. Guarda ese ID en el estado persistente de la tarea, no solo en la conversación del modelo: el agente podría reiniciarse.

Si procesas varios videos, conserva la URL junto a cada ID. Un enlace completo permite buscar una transcripción reciente con las mismas opciones; uno corto no se puede comparar al enviarlo. Leer un ID conocido es la forma más directa de evitar un segundo trabajo. En el ejemplo, sustituye el marcador por la URL de una publicación pública de Bluesky con video.

### Llamadas a las herramientas MCP

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

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

## Dale al agente las instrucciones de transcript1

Si tu agente admite Agent Skills, puede encontrar transcript1 en el índice y leer SKILL.md. Ahí tiene la secuencia de llamadas y cómo responder ante errores.

MCP aporta las herramientas; el Agent Skill explica cómo usarlas. Un pipeline propio por REST puede seguir el mismo proceso sin un cliente MCP. llms.txt solo indica dónde está la documentación: no es un endpoint para obtener transcripciones.

Elige según dónde corra el agente. En un asistente interactivo, MCP facilita leer por páginas. En un servicio en segundo plano, usa REST y webhooks de finalización con firma. Ambos consumen los mismos minutos y comparten los límites de la cuenta, así que controla la concurrencia contando todos tus clientes.

### Índice y archivo del Agent Skill

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

## Arma un pipeline de LLM con transcripción verificable

Pide el texto con marcas de tiempo y pásalo a tu modelo. La [referencia de exportación](https://transcript1.com/es/docs/api-reference#get-a-transcription) explica la llamada del ejemplo. Con MCP, recorre las páginas para no saturar el contexto; con REST, recoge las transcripciones mediante [webhooks](https://transcript1.com/es/features/webhook-transcripcion).

Guarda la URL o el ID de la fuente junto al texto y sus tiempos. Si vas a crear un índice de búsqueda, conserva el inicio y el final de cada fragmento. Corta entre segmentos completos o al cambiar de tema, no a mitad de una palabra ni de una intervención.

El resumen y la extracción los hace tu asistente, no transcript1. Pídele que distinga citas de paráfrasis y que señale lo que la fuente no dice. Una transcripción de video para un LLM puede incluir la explicación de una demo de Instagram, pero no las instrucciones que solo se ven en pantalla.

### cURL

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

## Comprueba cuánto leyó antes de dar el análisis por completo

Mientras quede texto, MCP devuelve next_from_seconds. Pasa ese valor como from_seconds en la siguiente consulta y registra las páginas leídas. La primera puede presentar el tema sin llegar al argumento principal ni a la conclusión.

Para resumir todo el video, reúne notas de cada página y conserva sus marcas de tiempo. Busca también correcciones o matices posteriores. Si comparas varias grabaciones, indica cuáles se leyeron y cuáles fallaron; una fuente que no se pudo consultar no cuenta como acuerdo ni como prueba de que algo no se dijo.

- [Transcribir videos de Bluesky](https://transcript1.com/es/features/transcribir-video-de-bluesky)
- [Qué incluye la transcripción de Instagram](https://transcript1.com/es/features/transcribir-reel-de-instagram)

## No confundas un error con una grabación sin contenido

Un error login_required o no_audio pide otra fuente; una transcripción en curso pide otra consulta de estado. Explica esa diferencia al usuario o al flujo que llamó al agente. No sustituyas una fuente fallida por texto vacío: el modelo podría interpretarlo como silencio.

Para archivos locales, el entorno del agente debe poder subir los bytes por HTTP PUT. MCP reserva y completa la subida, pero el archivo viaja fuera de MCP. Si el asistente no puede hacerlo, pide al usuario que suba el archivo desde el panel y después continúa con el ID de esa transcripción.

- [Paginación, opciones y subida de archivos por MCP](https://transcript1.com/es/docs/mcp)

## Preguntas frecuentes

### ¿Qué agentes puedo conectar?

Cualquier cliente que admita servidores MCP remotos, como Claude, ChatGPT, Cursor, VS Code y Claude Code. Si tu agente lee archivos SKILL.md, también puede usar el Agent Skill de transcript1.

### ¿Cómo inicia sesión el agente?

En Claude y ChatGPT, inicia sesión con OAuth. Para otros agentes, crea una clave de API que empiece con t1_ y envíala como token Bearer.

### ¿Qué pasa si el texto no cabe en el contexto?

El agente lo lee por páginas, que terminan entre segmentos. Cada página con texto pendiente devuelve next_from_seconds; el agente usa ese valor como from_seconds para seguir leyendo.

### ¿Me vuelven a cobrar si el agente reintenta?

Con un enlace completo, transcribe reutiliza una transcripción de las últimas 24 horas si coinciden el video y las opciones. No puede hacerlo con enlaces cortos. Si ya tienes el ID, get_transcription consulta el mismo trabajo sin un nuevo cobro.

### ¿Claude puede hacer el resumen con este texto?

Sí. transcript1 entrega la transcripción por MCP y Claude escribe el resumen después de leerla. También puedes enviar el texto a tu propio pipeline de LLM. El resumen no lo genera transcript1.

## También te puede servir

- [Transcripción por MCP](https://transcript1.com/es/features/mcp-transcripcion)
- [Conecta tu asistente por MCP (documentación)](https://transcript1.com/es/docs/mcp)
- [Webhooks](https://transcript1.com/es/features/webhook-transcripcion)
- [TikTok a texto](https://transcript1.com/es/features/transcribir-tiktok)
