---
title: "n8n"
description: "Crea flujos de Twitter en n8n para búsqueda de tweets, consulta de usuarios, tendencias, agentes de IA y entregas seguras con cursor a través de TwexAPI."
---

Crea un flujo de Twitter en n8n con TwexAPI. Busca tweets, consulta usuarios, lee tweets en tendencia y ejecuta agentes de IA. Esta integración usa el nodo comunitario de TwexAPI, HTTP Request, Webhook y MCP Client Tool.

TwexAPI usa una sola API key y la URL base REST `https://api.twexapi.io`.

## Elige una integración de Twitter en n8n

<CardGroup cols={2}>
  <Card title="Nodo comunitario TwexAPI" icon="plug">
    Instala `@twexapi-dev/n8n-nodes-x-api-scraper` para búsqueda de tweets, búsqueda de usuarios, consulta de perfiles, tweets en tendencia y comprobaciones de balance.
  </Card>

  <Card title="HTTP Request + MCP" icon="workflow">
    Usa HTTP Request para cualquier ruta REST documentada. Usa MCP Client Tool cuando un agente de IA deba descubrir endpoints primero.
  </Card>
</CardGroup>

## Requisitos previos

* [API key de TwexAPI](https://twexapi.io/dashboard)
* n8n Cloud o n8n self-hosted
* Credenciales opcionales de Slack y Google Sheets para las recetas siguientes

## Instalar el nodo comunitario

Instala `@twexapi-dev/n8n-nodes-x-api-scraper` desde **Settings → Community Nodes**.

```bash
npm install @twexapi-dev/n8n-nodes-x-api-scraper
```

Fuente: [twexapi-dev/n8n-nodes-x-api-scraper](https://github.com/twexapi-dev/n8n-nodes-x-api-scraper)

### Operaciones compatibles

| Tarea | Operación n8n | Ruta TwexAPI |
| --- | --- | --- |
| Buscar tweets | Tweet: search | `POST /twitter/advanced_search/page` |
| Buscar usuarios | User: search | `GET /twitter/search-user/{keyword}/{target_count}` |
| Consultar un perfil | User: get | `GET /twitter/{screen_name}/about` |
| Leer tweets en tendencia | Trend: get | `GET /twitter/global-trending/tweets` |
| Ver balance | Account: get balance | `GET /balance` |

Usa la [REST API](/api-reference/overview) para paginación de seguidores, listas, comunidades y publicación aprobada. TwexAPI no expone monitores de cuenta nativos ni webhooks de eventos: usa llamadas REST programadas o webhooks de plataformas sin código para trabajos recurrentes.

## Credencial de API key

Crea una credencial reutilizable de n8n para TwexAPI:

<CardGroup cols={3}>
  <Card title="Autenticación" icon="key-round">
    Selecciona Header Auth para la credencial de TwexAPI o la credencial de HTTP Request.
  </Card>

  <Card title="Nombre del encabezado" icon="braces">
    Configura el nombre del encabezado como `Authorization`.
  </Card>

  <Card title="Valor del encabezado" icon="shield-check">
    Pega `Bearer YOUR_API_KEY` como valor de la credencial.
  </Card>
</CardGroup>

Usa esa credencial en cada nodo HTTP Request que llame a `https://api.twexapi.io`.

Para nodos AI Agent compatibles con MCP, configura MCP Client Tool con `https://api.twexapi.io/mcp` y el encabezado `x-api-key: YOUR_API_KEY`.

## Entrega de resultados

Usa un nodo Edit Fields después de cada HTTP Request o nodo TwexAPI cuando el siguiente nodo solo necesite campos estables de entrega. Mantén las respuestas sin procesar fuera de mensajes de Slack, filas de Sheets y colas de reintento.

<CardGroup cols={2}>
  <Card title="Página de búsqueda de tweets" icon="search">
    Guarda la consulta de la solicitud; mapea el `id`, `text`, nombre de usuario del autor y `created_at` de cada tweet a `tweet_id`, `text`, `author_username` y `created_at`; conserva `has_next_page` y `next_cursor` para bucles de página.
  </Card>

  <Card title="Filas de perfil de usuario" icon="users">
    Guarda el `id` de origen como `user_id`, más `username`, `name`, conteos de seguidores y la entrada de búsqueda o consulta.
  </Card>

  <Card title="Filas de tendencias" icon="trending-up">
    Guarda cada nombre de tendencia, tema, etiqueta de contenido y país. Conserva la región solicitada con la ejecución del flujo.
  </Card>

  <Card title="Escritura de tweet o respuesta" icon="send">
    Las acciones de escritura requieren una cookie guardada o `auth_token`. Previsualiza con el [CLI](/sdks/cli) `--dry-run` antes de publicar desde n8n.
  </Card>
</CardGroup>

## Receta 1: investigación de X con agente de IA y MCP

Usa esta receta para integrar agentes de IA con TwexAPI. El agente puede buscar tweets en vivo, resumir tendencias, inspeccionar perfiles y comparar actividad de seguidores.

1. **Añade un nodo AI Agent**

    Crea un flujo AI Agent con tu modelo de chat preferido.

2. **Añade una herramienta cliente MCP**

    Configura Server Transport como `HTTP Streamable`. Configura MCP Endpoint URL como `https://api.twexapi.io/mcp`. Configura Authentication como Header Auth con nombre `x-api-key` y tu API key de TwexAPI.

3. **Indica al agente con un prompt**

    Dile al agente que llame a `explore` primero, luego a `twexapi_request`, y que devuelva solo JSON.

Prompt de sistema sugerido para el agente:

```text
Use TwexAPI for every X research request. Call explore before twexapi_request. Search tweets, inspect accounts, and cite the returned post URLs. Prefer small, targeted searches before broad exports.
```

Ejemplo de prompt de usuario:

```text
Find recent posts about AI agents in fintech, group them by theme, and list 5 accounts worth monitoring.
Return only JSON with route_used, tweets, has_more, and next_cursor.
```

El servidor MCP expone `explore` para descubrimiento de endpoints y `twexapi_request` para llamadas autenticadas.

## Receta 2: búsqueda de tweets a Slack

Usa el nodo comunitario TwexAPI o HTTP Request para buscar tweets, luego alerta un canal de Slack.

### Forma del flujo

<CardGroup cols={2}>
  <Card title="Disparador programado o manual" icon="calendar-clock">
    Ejecuta según un horario o manualmente mientras pruebas.
  </Card>

  <Card title="Buscar tweets" icon="search">
    Usa el nodo TwexAPI o HTTP Request para llamar a `POST /twitter/advanced_search/page`.
  </Card>

  <Card title="Dividir filas" icon="split">
    Split Out sobre los tweets devueltos.
  </Card>

  <Card title="Publicar alerta" icon="message-square">
    Envía texto formateado a Slack.
  </Card>
</CardGroup>

### Ejemplo de HTTP Request

```json
{
  "method": "POST",
  "url": "https://api.twexapi.io/twitter/advanced_search/page",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  "body": {
    "searchTerms": ["AI agents lang:en"],
    "sortBy": "Latest",
    "nextCursor": ""
  }
}
```

### Mensaje de Slack

Usa un nodo Set antes de Slack:

```text
@{{$json.author_username || $json.user?.screen_name}}
{{$json.text || $json.full_text}}
https://x.com/i/web/status/{{$json.tweet_id || $json.id}}
```

## Receta 3: resultados de búsqueda a Google Sheets

Usa esto cuando un equipo necesite resultados de búsqueda de tweets en una hoja de cálculo.

### Forma del flujo

<CardGroup cols={2}>
  <Card title="Disparador programado" icon="calendar-clock">
    Ejecuta exportaciones diarias o por hora; ejecuta manualmente mientras pruebas.
  </Card>

  <Card title="Buscar tweets" icon="search">
    Usa el nodo TwexAPI o HTTP Request para buscar tweets y guardar `next_cursor`.
  </Card>

  <Card title="Dividir filas" icon="split">
    Split Out sobre los tweets devueltos.
  </Card>

  <Card title="Añadir filas" icon="file-spreadsheet">
    Usa Google Sheets Append Row con los campos de resultado mapeados abajo.
  </Card>
</CardGroup>

Mapea estos campos en Google Sheets:

<CardGroup cols={2}>
  <Card title="ID de tweet" icon="hash">
    Mapea a `id` o `tweet_id`.
  </Card>

  <Card title="Autor" icon="at-sign">
    Mapea al nombre de usuario o screen name del autor.
  </Card>

  <Card title="Texto" icon="type">
    Mapea a `text` o `full_text`.
  </Card>

  <Card title="Fecha de creación" icon="calendar">
    Mapea a `created_at` o `createdAt`.
  </Card>

  <Card title="URL" icon="link">
    Construye desde `https://x.com/i/web/status/{id}`.
  </Card>
</CardGroup>

Para trabajos más grandes, itera mientras `has_next_page` o `has_more` sea `true` y pasa `next_cursor` de vuelta al cuerpo de búsqueda.

## Acciones REST útiles

<CardGroup cols={2}>
  <Card title="Buscar tweets" icon="search">
    Ejecuta búsquedas con consultas de X usando `POST /twitter/advanced_search/page`.
  </Card>

  <Card title="Obtener perfil de usuario" icon="user-round">
    Obtén un perfil de X con `GET /twitter/{screen_name}/about`.
  </Card>

  <Card title="Obtener seguidores" icon="users">
    Lee listas de seguidores con `POST /v3/twitter/users/followers`.
  </Card>

  <Card title="Obtener tendencias" icon="trending-up">
    Lee tweets en tendencia global con `GET /twitter/global-trending/tweets`.
  </Card>

  <Card title="Crear tweet" icon="send">
    Publica posts de texto o media con `POST /twitter/tweets/create`.
  </Card>

  <Card title="Enviar DM" icon="message-circle">
    Envía DMs con `POST /v3/twitter/send-dm`.
  </Card>
</CardGroup>

## Lista de verificación de pruebas

* Usa la acción Test Step de n8n en cada nodo HTTP Request o TwexAPI.
* Confirma que cada solicitud REST incluye `Authorization: Bearer YOUR_API_KEY`.
* Confirma que cada solicitud de MCP Client Tool incluye `x-api-key`.
* Para trabajos paginados, guarda `next_cursor` después de cada página.
* Con `429`, espera antes de reintentar y conserva el cursor.

## Preguntas sobre automatización de Twitter en n8n

### ¿Cómo conecto n8n a Twitter a través de TwexAPI?

Instala el nodo comunitario TwexAPI o crea Header Auth con `Authorization: Bearer YOUR_API_KEY`. Selecciónalo en cada solicitud TwexAPI.

### ¿Cómo funciona la búsqueda de Twitter en n8n?

Llama a `POST /twitter/advanced_search/page` a través del nodo comunitario o HTTP Request. Guarda la consulta y el cursor para cada página.

### ¿Puede n8n publicar en Twitter?

Sí, a través de `POST /twitter/tweets/create`. Las acciones de escritura requieren una cookie o `auth_token`. Previsualiza payloads con el [CLI](/sdks/cli) primero.

### ¿Puedo crear un agente de Twitter en n8n?

Sí. Un agente de Twitter en n8n puede buscar tweets, perfiles y tendencias a través de MCP en `https://api.twexapi.io/mcp`.

### ¿Puede n8n self-hosted usar TwexAPI?

Sí. Permite HTTPS saliente a `https://api.twexapi.io`.

## Próximos pasos

* Lee [Entrega MCP de agente](/mcp/agent-handoff) para patrones de entrega JSON estricta.
* Lee [CLI](/sdks/cli) para previsualizaciones dry-run de acciones de escritura.
* Usa [Herramientas MCP](/mcp/tools) al crear flujos AI Agent.