Saltearse al contenido
Nappai Documentation

X Reader

El X Reader es un componente de Nappai que te permite consultar la API de X (Twitter) para obtener información sobre tweets, usuarios y sus interacciones. Con él puedes buscar tweets recientes, obtener la línea de tiempo de un usuario, ver quién le dio like o retuiteó, y más, todo desde tu dashboard sin escribir código.

¿Cómo funciona?

El componente envía peticiones HTTP a la API de X usando las credenciales que configures en Nappai. Cuando seleccionas una operación, el componente construye la URL y los parámetros adecuados, envía la solicitud y devuelve los datos en formato JSON. Si lo configuras como Tool, el resultado también se convierte en un objeto que un agente de IA puede usar directamente.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

  • Get Tweet: Obtiene la información de un tweet específico mediante su ID.
  • Get Recent Tweets: Busca tweets recientes que coincidan con un término de búsqueda.
  • Get User Timeline: Recupera la línea de tiempo (tweets) de un usuario.
  • Get Tweets By User: Obtiene tweets publicados por un usuario específico.
  • Get Liking Users: Lista los usuarios que le dieron like a un tweet.
  • Get users who retweet: Muestra los usuarios que retuitearon un tweet.
  • Get Quote Tweets: Devuelve los tweets que citan (quote) a un tweet.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

  • Fixed (Fijo): Escribes el valor directamente en el campo.
  • Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
  • Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

  • Operation: Selecciona la operación que quieres ejecutar.

    • Visible en: Get Tweet, Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Mapping Mode: Habilita el modo de mapeo para procesar varios registros en lote.

    • Visible en: Get Tweet, Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Max Results: Número máximo de resultados que quieres recibir.

    • Visible en: Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Mode: Elige entre una configuración simplificada con opciones predeterminadas o un control completo con ajustes avanzados.

    • Visible en: Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Query: Término de búsqueda o filtro para encontrar tweets recientes.

    • Visible en: Get Recent Tweets

  • Tweet ID: El ID único del tweet que quieres recuperar.

    • Visible en: Get Tweet, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Username: El nombre de usuario de la cuenta cuyo contenido quieres obtener.

    • Visible en: Get User Timeline, Get Tweets By User

  • Credential: Selecciona la credencial X API previamente configurada en Nappai.

    • Visible en: Get Tweet, Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Tool Name: Nombre del tool que se mostrará al agente cuando el componente se use como herramienta.

    • Visible en: Get Tweet, Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Tool Description: Descripción detallada de lo que hace esta herramienta para que el agente la entienda.

    • Visible en: Get Tweet, Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

  • Tools arguments metadata: Define los metadatos de los argumentos que el tool recibirá.

    • Visible en: Get Tweet, Get Recent Tweets, Get User Timeline, Get Tweets By User, Get Liking Users, Get users who retweet, Get Quote Tweets

Nota sobre credenciales

  1. Configura primero la credencial X API en la sección de credenciales de Nappai.
  2. Luego selecciona esa credencial en el campo Credential del componente.
    Los datos de la credencial (API Key, Secret, Bearer Token, etc.) no se muestran aquí por razones de seguridad.

Salidas

  • Data: Devuelve los datos obtenidos de la API de X en formato JSON.
  • Tool: Si el componente se usa como herramienta, esta salida contiene un objeto que el agente puede invocar directamente.

Ejemplo de Uso

Supongamos que quieres buscar los 10 tweets más recientes que contengan la palabra “nappai”:

  1. Arrastra el componente X Reader al flujo.
  2. En Operation selecciona Get Recent Tweets.
  3. En Query escribe nappai.
  4. En Max Results escribe 10.
  5. Selecciona la credencial X API en Credential.
  6. (Opcional) Define un Tool Name como “BuscarTweetsNappai” y una breve descripción.
  7. Conecta la salida Data a un componente de visualización o a otro proceso que necesite esos tweets.

El componente enviará la solicitud a la API de X y devolverá los tweets encontrados, listos para ser mostrados o procesados.

Plantillas

(No hay plantillas que utilicen este componente.)

Componentes Relacionados

  • X Writer – Envía tweets o actualiza contenido en X.
  • Twitter Scheduler – Programa publicaciones en X.
  • Data Enrichment – Añade metadatos a los tweets antes de procesarlos.

Consejos y Mejores Prácticas

  • Usa Mapping Mode cuando necesites procesar listas de IDs o nombres de usuario en lote.
  • Limita Max Results a un número razonable (por ejemplo, 20) para evitar tiempos de espera largos.
  • Si solo necesitas un tweet específico, selecciona Get Tweet y proporciona el Tweet ID.
  • Configura un Tool Name y Tool Description claros para que los agentes de IA comprendan rápidamente cuándo usarlo.
  • Revisa la documentación de la API de X para conocer límites de tasa y evitar bloqueos.

Consideraciones de Seguridad

  • Mantén tus credenciales de X API en la sección de credenciales de Nappai y nunca las expongas en el flujo.
  • Si compartes el flujo con otros usuarios, asegúrate de que tengan acceso a la credencial configurada.
  • Evita exponer datos sensibles (por ejemplo, IDs de tweets privados) en los logs o en la salida visible del flujo.