본문으로 건너뛰기
Twexapi
한국어
Esc
이동열기⌘J미리보기
이 페이지에서

노코드 워크플로 핸드오프

Twexapi MCP 에이전트 결과를 n8n, Zapier, Make, Pipedream으로 전달합니다.

대부분의 노코드 플랫폼은 MCP 세션 자체를 실행할 필요가 없습니다. 신뢰할 수 있는 패턴은 MCP 지원 에이전트가 데이터를 수집한 다음 구조화된 JSON을 워크플로에 전달하는 것입니다.

전제조건

  • Twexapi API 키
  • https://api.twexapi.io/mcp에 연결된 MCP 지원 에이전트 또는 프레임워크
  • n8n, Zapier, Make, Pipedream 또는 내부 워크플로 실행기의 웹훅 URL
  • Sheets, Airtable, Notion, Slack, CRM 또는 데이터베이스 같은 대상 시스템

권장 흐름

MCP 지원 에이전트로 수집

Claude Code, Cursor, Codex CLI, LangChain, Pydantic AI 또는 https://api.twexapi.io/mcp에 연결된 다른 MCP 클라이언트를 사용합니다.

엄격한 JSON 반환

ID, 커서, 경로 이름, 행이 포함된 안정적인 스키마를 에이전트에 요청합니다.

노코드 도구로 전송

JSON을 n8n, Zapier, Make, Pipedream 또는 내부 워크플로 실행기의 웹훅에 POST합니다.

필요 시 REST로 계속

예약 또는 대용량 작업은 Authorization: Bearer YOUR_API_KEY로 Twexapi REST를 직접 호출할 수 있습니다.

복사-붙여넣기 에이전트 프롬프트

Use Twexapi MCP to search recent X/Twitter posts about "AI agents".
Call explore first, then twexapi_request.
Return only valid JSON with:
{
  "route_used": "...",
  "query": "AI agents",
  "has_more": true,
  "next_cursor": "...",
  "tweets": [
    {
      "tweet_id": "...",
      "author_username": "...",
      "created_at": "...",
      "text": "...",
      "like_count": 0,
      "reply_count": 0,
      "retweet_count": 0
    }
  ]
}
Do not call write endpoints.

워크플로 매핑

JSON 필드 일반적인 대상
tweet_id 데이터베이스 기본 키, 중복 제거 키, CRM 메모 참조
author_username CRM 계정 필드, Slack 메시지 레이블
created_at 정렬 키 및 보고 타임스탬프
next_cursor 다음 예약 실행을 위한 워크플로 상태
route_used 감사 로그 및 디버깅 필드

결과 핸드오프

워크플로 페이로드를 작고 안정적으로 유지하세요. 별도로 보관하지 않는 한 Slack 메시지, CRM 메모, 스프레드시트 행에 전체 원시 응답을 전달하지 마세요.

행 유형 필수 필드
트윗 검색 tweet_id, text, author_username, created_at, public_url, route_used
프로필 조회 user_id, username, name, description, followers_count, verified
트렌드 행 name, rank, query, 요청된 country, 요청된 topic
페이지네이션 has_more, next_cursor, 원본 쿼리 또는 소스 ID
쓰기 계획 action, endpoint, preview, requires_human_confirmation

레시피: 에이전트 연구 → 웹훅

  1. AI 에이전트를 Twexapi MCP에 연결합니다.
  2. 위 프롬프트를 사용해 엄격한 JSON을 요청합니다.
  3. JSON을 워크플로 웹훅에 POST합니다.
  4. 워크플로 도구의 반복자 또는 루프 단계로 tweets를 순회합니다.
  5. tweet_id로 행을 upsert합니다.

레시피: 예약 연속 실행

일일 작업의 경우 첫 실행은 에이전트 지원으로 하고 이후 실행은 결정적으로 만듭니다.

  1. route_used, 요청 매개변수, next_cursor를 저장합니다.
  2. Authorization: Bearer YOUR_API_KEY로 Twexapi REST 예약 호출을 실행합니다.
  3. has_more가 false이거나 워크플로가 행 제한에 도달하면 중지합니다.
  4. 선택한 엔드포인트 또는 쿼리를 변경해야 할 때만 예외를 에이전트에 다시 보냅니다.

테스트 체크리스트

  • 웹훅이 Markdown이 아닌 유효한 JSON을 수신하는지 확인합니다.
  • tweet_id 또는 user_id가 중복 제거에 사용되는지 확인합니다.
  • next_cursor가 채팅 기록 외부에 영속 저장되는지 확인합니다.
  • 쓰기 작업이 사람이 승인할 때까지 계획으로만 표현되는지 확인합니다.
  • API 키, 쿠키, auth 토큰이 사용자에게 보이는 대상으로 전송되지 않는지 확인합니다.

이 페이지가 도움이 되었나요?