---
title: "Migración desde Composio"
description: "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

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

## Contrato de entrega

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

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

## Ejemplo de migración

Tarea anterior:

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

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

## 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:

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

## Despliegue en producción

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