---
title: "Migration depuis Composio"
description: "Migrez les workflows d'agents X/Twitter des outils de style Composio vers Twexapi MCP."
---

Utilisez ce guide lorsqu'un agent appelle déjà des outils X/Twitter empaquetés et que vous souhaitez migrer le workflow vers Twexapi MCP.

## Prérequis

- Une clé API Twexapi
- Une liste des actions X/Twitter existantes utilisées par votre agent
- Un runtime compatible MCP connecté à `https://api.twexapi.io/mcp`
- Une invite de test et la sortie attendue de l'ancien workflow

Utilisez `x-api-key: YOUR_API_KEY` pour les clients MCP et `Authorization: Bearer YOUR_API_KEY` pour les replis REST.

## Table de migration

| Comportement existant | Modèle Twexapi MCP |
| --- | --- |
| Rechercher des tweets | `explore(query="advanced search")`, puis `twexapi_request` |
| Lire un profil | `explore(category="users")` ou `explore(category="accounts")` |
| Obtenir des abonnés | `explore(category="followers")` |
| Lire des réponses ou citations | `explore(category="engagement")` |
| Publier ou répondre | Utilisez une entrée de catalogue `read_only: false` et exigez une confirmation |

## Instruction pour l'agent

```txt
Replace packaged X/Twitter tools with Twexapi MCP.
First call explore to find the closest Twexapi endpoint.
Then call twexapi_request with the exact method and relative path returned by explore.
Preserve tweet_id, user_id, route_used, has_more, and next_cursor.
Ask for confirmation before read_only: false actions.
```

## Contrat de transfert

Faites en sorte que chaque outil migré renvoie un objet de transfert stable avant que les étapes en aval ne le consomment.

```json
{
  "route_used": "/twitter/advanced_search/page",
  "method": "POST",
  "source_tool": "legacy_twitter_search",
  "has_more": true,
  "next_cursor": "cursor_123",
  "rows": [
    {
      "tweet_id": "1803006263529541838",
      "author_username": "openai",
      "text": "Example tweet text",
      "created_at": "2026-07-02T10:00:00Z",
      "public_url": "https://x.com/i/web/status/1803006263529541838"
    }
  ]
}
```

## Exemple de migration

Ancienne tâche :

```txt
Search Twitter for AI agent launch announcements and summarize the top posts.
```

Tâche Twexapi MCP :

```txt
Use Twexapi MCP to search recent X posts about "AI agent launch".
Call explore first and choose the search endpoint.
Return JSON with route_used, tweets[{tweet_id,text,author_username,created_at,public_url}], has_more, next_cursor, and a short summary.
```

## Liste de validation

- Comparez le nombre de lignes avant et après la migration.
- Vérifiez que toutes les étapes en aval utilisent `tweet_id` au lieu de l'analyse d'URL.
- Confirmez que les curseurs sont stockés en dehors de la conversation de l'agent.
- Ajoutez une approbation humaine pour toute action d'écriture migrée.

## Réécriture des appels d'outils

Utilisez cette réécriture mécanique lors de l'adaptation des anciennes instructions d'agent.

| Ancienne instruction | Nouvelle instruction |
| --- | --- |
| "Call the Twitter search tool" | "Call `explore(query=\"advanced search\")`, then `twexapi_request`." |
| "Fetch this profile" | "Call `explore(category=\"users\")` and preserve `user_id`." |
| "Continue pagination" | "Use the returned `next_cursor`; do not parse it." |
| "Post this tweet" | "Prepare a write plan and ask for approval before `read_only: false`." |

## Invite de régression

Exécutez ceci avant et après la migration :

```txt
Find recent posts about "AI agents" from the last 24 hours.
Return exactly 10 rows with tweet_id, author_username, text, created_at, public_url, route_used, has_more, and next_cursor.
Do not call write endpoints.
```

## Déploiement en production

1. Exécutez les anciens et nouveaux workflows en parallèle sur les tâches en lecture seule.
2. Comparez le nombre de lignes, les champs requis et les URL représentatives.
3. Basculez les tâches planifiées vers la route Twexapi MCP/REST.
4. Réactivez les actions d'écriture uniquement après avoir testé les invites d'approbation.