컴포지오 마이그레이션

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’ 카탈로그 항목을 사용하고 확인이 필요합니다.

상담원 안내

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.

핸드오프 계약

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

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

마이그레이션 예시

이전 작업:

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

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.

검증 체크리스트

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

도구 호출 재작성

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

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

회귀 프롬프트

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

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.

생산 출시

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