Migración desde Composio

Migra flujos de trabajo de agentes X/Twitter desde herramientas estilo Composio a Twexapi MCP.

Usa esta guía cuando un agente ya llama herramientas empaquetadas de X/Twitter y quieres migrar el flujo de trabajo a Twexapi MCP.

Requisitos previos

Una API key de Twexapi
Una lista de acciones X/Twitter existentes usadas por tu agente
Un runtime compatible con MCP conectado a https://api.twexapi.io/mcp
Un prompt de prueba y la salida esperada del flujo de trabajo anterior

Usa x-api-key: YOUR_API_KEY para clientes MCP y Authorization: Bearer YOUR_API_KEY para respaldos REST.

Mapa de migración

Comportamiento existente	Patrón Twexapi MCP
Buscar tweets	`explore(query="advanced search")`, luego `twexapi_request`
Leer un perfil	`explore(category="users")` o `explore(category="accounts")`
Obtener seguidores	`explore(category="followers")`
Leer respuestas o citas	`explore(category="engagement")`
Publicar o responder	Usa una entrada de catálogo `read_only: false` y requiere confirmación

Instrucción para el agente

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.

Contrato de entrega

Haz que cada herramienta migrada devuelva un objeto de entrega estable antes de que los pasos downstream lo consuman.

{
  "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"
    }
  ]
}

Ejemplo de migración

Tarea anterior:

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

Tarea con 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.

Lista de verificación de validación

Compara los conteos de filas antes y después de la migración.
Verifica que todos los pasos downstream usen tweet_id en lugar de análisis de URL.
Confirma que los cursores se guarden fuera de la conversación del agente.
Agrega aprobación humana para cualquier acción de escritura migrada.

Reescritura de llamadas a herramientas

Usa esta reescritura mecánica al adaptar instrucciones antiguas del agente.

Instrucción anterior	Nueva instrucción
“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`.”

Prompt de regresión

Ejecuta esto antes y después de la migración:

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.

Despliegue en producción

Ejecuta flujos de trabajo antiguos y nuevos en paralelo en tareas de solo lectura.
Compara conteos de filas, campos requeridos y URLs representativas.
Cambia trabajos programados a la ruta Twexapi MCP/REST.
Rehabilita acciones de escritura solo después de probar los prompts de aprobación.