---
title: "n8n"
description: "Construisez des workflows Twitter n8n pour la recherche de tweets, le lookup utilisateur, les tweets tendance, les agents IA et les handoffs sûrs avec curseurs via TwexAPI."
---

Construisez un workflow Twitter n8n avec TwexAPI. Recherchez des tweets, consultez des utilisateurs, lisez les tweets tendance et exécutez des agents IA. Cette intégration utilise le nœud communautaire TwexAPI, HTTP Request, Webhook et MCP Client Tool.

TwexAPI utilise une clé API et l'URL de base REST `https://api.twexapi.io`.

## Choisir une intégration Twitter n8n

<CardGroup cols={2}>
  <Card title="Nœud communautaire TwexAPI" icon="plug">
    Installez `@twexapi-dev/n8n-nodes-x-api-scraper` pour la recherche de tweets, la recherche utilisateur, le lookup de profil, les tweets tendance et les vérifications de solde.
  </Card>

  <Card title="HTTP Request + MCP" icon="workflow">
    Utilisez HTTP Request pour toute route REST documentée. Utilisez MCP Client Tool lorsqu'un agent IA doit découvrir les endpoints en premier.
  </Card>
</CardGroup>

## Prérequis

* [Clé API TwexAPI](https://twexapi.io/dashboard)
* n8n Cloud ou n8n auto-hébergé
* Identifiants Slack et Google Sheets optionnels pour les recettes ci-dessous

## Installer le nœud communautaire

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

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

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

### Opérations supportées

| Tâche | Opération n8n | Route TwexAPI |
| --- | --- | --- |
| Rechercher des tweets | Tweet: search | `POST /twitter/advanced_search/page` |
| Rechercher des utilisateurs | User: search | `GET /twitter/search-user/{keyword}/{target_count}` |
| Consulter un profil | User: get | `GET /twitter/{screen_name}/about` |
| Lire les tweets tendance | Trend: get | `GET /twitter/global-trending/tweets` |
| Voir le solde | Account: get balance | `GET /balance` |

Utilisez l'[API REST](/api-reference/overview) pour la pagination d'abonnés, les listes, les communautés et la publication approuvée. TwexAPI n'expose pas des moniteurs de compte natifs ou des webhooks d'événements — utilisez des appels REST planifiés ou des webhooks de plateforme no-code pour les jobs récurrents.

## Identifiant clé API

Créez un identifiant n8n réutilisable pour TwexAPI :

<CardGroup cols={3}>
  <Card title="Authentification" icon="key-round">
    Sélectionnez Header Auth pour l'identifiant API TwexAPI ou l'identifiant HTTP Request.
  </Card>

  <Card title="Nom du header" icon="braces">
    Définissez le nom du header à `Authorization`.
  </Card>

  <Card title="Valeur du header" icon="shield-check">
    Collez `Bearer YOUR_API_KEY` comme valeur d'identifiant.
  </Card>
</CardGroup>

Utilisez cet identifiant dans chaque nœud HTTP Request qui appelle `https://api.twexapi.io`.

Pour les nœuds AI Agent compatibles MCP, configurez MCP Client Tool avec `https://api.twexapi.io/mcp` et le header `x-api-key: YOUR_API_KEY`.

## Handoff de résultats

Utilisez un nœud Edit Fields après chaque HTTP Request ou nœud TwexAPI lorsque le nœud suivant n'a besoin que de champs de handoff stables. Gardez les réponses brutes hors des messages Slack, des lignes Sheets et des files de retry.

<CardGroup cols={2}>
  <Card title="Page de recherche de tweets" icon="search">
    Stockez la requête ; mappez chaque tweet `id`, `text`, username d'auteur et `created_at` vers `tweet_id`, `text`, `author_username` et `created_at` ; gardez `has_next_page` et `next_cursor` pour les boucles de page.
  </Card>

  <Card title="Lignes de profil utilisateur" icon="users">
    Stockez le `id` source comme `user_id`, plus `username`, `name`, les compteurs d'abonnés et l'entrée de lookup ou de recherche.
  </Card>

  <Card title="Lignes de tendances" icon="trending-up">
    Stockez chaque nom de tendance, sujet, tag de contenu et pays. Gardez la région demandée avec l'exécution du workflow.
  </Card>

  <Card title="Écriture de tweet ou réponse" icon="send">
    Les actions d'écriture nécessitent un cookie ou `auth_token` enregistré. Prévisualisez avec le [CLI](/sdks/cli) `--dry-run` avant de publier depuis n8n.
  </Card>
</CardGroup>

## Recette 1 : recherche X par agent IA avec MCP

Utilisez cette recette pour intégrer des agents IA avec TwexAPI. L'agent peut rechercher des tweets en direct, résumer les tendances, inspecter des profils et comparer l'activité des abonnés.

1. **Ajouter un nœud AI Agent**

    Créez un workflow AI Agent avec votre modèle de chat préféré.

2. **Ajouter un outil client MCP**

    Définissez Server Transport à `HTTP Streamable`. Définissez MCP Endpoint URL à `https://api.twexapi.io/mcp`. Définissez Authentication à Header Auth avec le nom `x-api-key` et votre clé API TwexAPI.

3. **Prompt l'agent**

    Indiquez à l'agent d'appeler `explore` en premier, puis `twexapi_request`, et de retourner uniquement du JSON.

Prompt système agent suggéré :

```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.
```

Exemple de prompt utilisateur :

```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.
```

Le serveur MCP expose `explore` pour la découverte d'endpoints et `twexapi_request` pour les appels authentifiés.

## Recette 2 : recherche de tweets vers Slack

Utilisez le nœud communautaire TwexAPI ou HTTP Request pour rechercher des tweets, puis alertez un canal Slack.

### Structure du workflow

<CardGroup cols={2}>
  <Card title="Trigger planifié ou manuel" icon="calendar-clock">
    Exécutez selon un planning ou manuellement pendant les tests.
  </Card>

  <Card title="Rechercher des tweets" icon="search">
    Utilisez le nœud TwexAPI ou HTTP Request pour appeler `POST /twitter/advanced_search/page`.
  </Card>

  <Card title="Diviser les lignes" icon="split">
    Split Out sur les tweets retournés.
  </Card>

  <Card title="Poster l'alerte" icon="message-square">
    Envoyez du texte formaté à Slack.
  </Card>
</CardGroup>

### Exemple 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": ""
  }
}
```

### Message Slack

Utilisez un nœud Set avant 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}}
```

## Recette 3 : résultats de recherche vers Google Sheets

Utilisez ceci lorsqu'une équipe a besoin des résultats de recherche de tweets dans un tableur.

### Structure du workflow

<CardGroup cols={2}>
  <Card title="Trigger planifié" icon="calendar-clock">
    Exécutez des exports quotidiens ou horaires ; exécutez manuellement pendant les tests.
  </Card>

  <Card title="Rechercher des tweets" icon="search">
    Utilisez le nœud TwexAPI ou HTTP Request pour rechercher des tweets et stocker `next_cursor`.
  </Card>

  <Card title="Diviser les lignes" icon="split">
    Split Out sur les tweets retournés.
  </Card>

  <Card title="Ajouter des lignes" icon="file-spreadsheet">
    Utilisez Google Sheets Append Row avec les champs de résultat mappés ci-dessous.
  </Card>
</CardGroup>

Mappez ces champs dans Google Sheets :

<CardGroup cols={2}>
  <Card title="ID de tweet" icon="hash">
    Mappez vers `id` ou `tweet_id`.
  </Card>

  <Card title="Auteur" icon="at-sign">
    Mappez vers le username d'auteur ou le nom d'écran.
  </Card>

  <Card title="Texte" icon="type">
    Mappez vers `text` ou `full_text`.
  </Card>

  <Card title="Créé à" icon="calendar">
    Mappez vers `created_at` ou `createdAt`.
  </Card>

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

Pour les jobs plus volumineux, bouclez tant que `has_next_page` ou `has_more` est vrai et passez `next_cursor` dans le corps de recherche.

## Actions REST utiles

<CardGroup cols={2}>
  <Card title="Rechercher des tweets" icon="search">
    Exécutez des recherches de requête X avec `POST /twitter/advanced_search/page`.
  </Card>

  <Card title="Obtenir le profil utilisateur" icon="user-round">
    Récupérez un profil X avec `GET /twitter/{screen_name}/about`.
  </Card>

  <Card title="Obtenir les abonnés" icon="users">
    Lisez les listes d'abonnés avec `POST /v3/twitter/users/followers`.
  </Card>

  <Card title="Obtenir les tendances" icon="trending-up">
    Lisez les tweets tendance globaux avec `GET /twitter/global-trending/tweets`.
  </Card>

  <Card title="Créer un tweet" icon="send">
    Publiez des posts texte ou média avec `POST /twitter/tweets/create`.
  </Card>

  <Card title="Envoyer un DM" icon="message-circle">
    Envoyez des DMs avec `POST /v3/twitter/send-dm`.
  </Card>
</CardGroup>

## Checklist de test

* Utilisez l'action Test Step n8n sur chaque HTTP Request ou nœud TwexAPI.
* Confirmez que chaque requête REST inclut `Authorization: Bearer YOUR_API_KEY`.
* Confirmez que chaque requête MCP Client Tool inclut `x-api-key`.
* Pour les jobs paginés, stockez `next_cursor` après chaque page.
* Sur `429`, attendez avant de réessayer et préservez le curseur.

## Questions sur l'automatisation Twitter n8n

### Comment connecter n8n à Twitter via TwexAPI ?

Installez le nœud communautaire TwexAPI ou créez Header Auth avec `Authorization: Bearer YOUR_API_KEY`. Sélectionnez-le sur chaque requête TwexAPI.

### Comment fonctionne la recherche Twitter n8n ?

Appelez `POST /twitter/advanced_search/page` via le nœud communautaire ou HTTP Request. Stockez la requête et le curseur pour chaque page.

### n8n peut publier sur Twitter ?

Oui, via `POST /twitter/tweets/create`. Les actions d'écriture nécessitent un cookie ou `auth_token`. Prévisualisez les payloads avec le [CLI](/sdks/cli) en premier.

### Puis-je construire un agent Twitter n8n ?

Oui. Un agent Twitter n8n peut rechercher des tweets, profils et tendances via MCP à `https://api.twexapi.io/mcp`.

### n8n auto-hébergé peut utiliser TwexAPI ?

Oui. Autorisez le HTTPS sortant vers `https://api.twexapi.io`.

## Prochaines étapes

* Consultez [Agent MCP Handoff](/mcp/agent-handoff) pour les modèles de handoff JSON strict.
* Consultez le [CLI](/sdks/cli) pour les prévisualisations dry-run des actions d'écriture.
* Utilisez [Outils MCP](/mcp/tools) lors de la construction de workflows AI Agent.