Migration depuis Composio

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

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.

{
  "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 :

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

Tâche Twexapi MCP :

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 :

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

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