---
title: "컴포지오 마이그레이션"
description: "X/Twitter 에이전트 워크플로를 Composio 스타일 도구에서 Twexapi MCP로 이동합니다."
---

상담원이 이미 패키지된 X/Twitter 도구를 호출하고 워크플로를 Twexapi MCP로 마이그레이션하려는 경우 이 가이드를 사용하세요.

## 전제조건

- Twexapi API 키
- 에이전트가 사용하는 기존 X/Twitter 작업 목록
- `https://api.twexapi.io/mcp`에 연결된 MCP 지원 런타임
- 이전 워크플로의 테스트 프롬프트 및 예상 출력

MCP 클라이언트의 경우 `x-api-key: YOUR_API_KEY`를 사용하고 REST 폴백의 경우 `Authorization: Bearer YOUR_API_KEY`를 사용하세요.

## 마이그레이션 지도

| 기존 동작 | Twexapi MCP 패턴 |
| --- | --- |
| 트윗 검색 | `explore(query="advanced search")`, then `twexapi_request` |
| 프로필 읽기 | `explore(category="users")` or `explore(category="accounts")` |
| 팔로어 얻기 | `explore(category="followers")` |
| 답글이나 인용문 읽기 | `explore(category="engagement")` |
| 게시 또는 답글 | 'read_only: false' 카탈로그 항목을 사용하고 확인이 필요합니다. |

## 상담원 안내

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

## 핸드오프 계약

다운스트림 단계에서 이를 사용하기 전에 마이그레이션된 모든 도구가 안정적인 핸드오프 개체를 반환하도록 합니다.

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

## 마이그레이션 예시

이전 작업:

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

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

## 검증 체크리스트

- 마이그레이션 전후의 행 수를 비교하세요.
- 모든 다운스트림 단계에서 URL 구문 분석 대신 `tweet_id`를 사용하는지 확인하세요.
- 커서가 상담원 대화 외부에 저장되어 있는지 확인하세요.
- 마이그레이션된 쓰기 작업에 대한 사람의 승인을 추가하세요.

## 도구 호출 재작성

이전 에이전트 지침을 적용할 때 이 기계적 재작성을 사용하세요.

| 오래된 지시 | 새로운 지시 |
| --- | --- |
| "트위터 검색 도구에 전화해" | "`explore(query=\"고급 검색\")`을 호출한 다음 `twexapi_request`를 호출하세요." |
| "이 프로필 가져오기" | "`explore(category=\"users\")`를 호출하고 `user_id`를 유지하세요." |
| "페이지 매김 계속" | "반환된 'next_cursor'를 사용하세요. 구문 분석하지 마세요." |
| "이 트윗을 올려주세요" | "`read_only: false` 전에 쓰기 계획을 준비하고 승인을 요청하세요." |

## 회귀 프롬프트

마이그레이션 전후에 다음을 실행하십시오.

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

## 생산 출시

1. 읽기 전용 작업에서 기존 워크플로와 새 워크플로를 나란히 실행하세요.
2. 행 개수, 필수 입력란, 대표 URL을 비교하세요.
3. 예약된 작업을 Twexapi MCP/REST 경로로 전환합니다.
4. 승인 프롬프트를 테스트한 후에만 쓰기 작업을 다시 활성화하십시오.