Zapier

TwexAPI를 통해 트윗 검색, 사용자 조회, 인기 트윗, 플랫폼 웹훅, 커서 안전 핸드오프를 위한 Zapier Twitter 자동화를 구축합니다.

TwexAPI로 Zapier Twitter 자동화를 구축합니다. 트윗을 검색하고, 사용자를 조회하며, 인기 트윗을 읽고, 행을 Slack, Sheets, Airtable, HubSpot 또는 이메일로 라우팅합니다. TwexAPI는 하나의 API 키와 REST 기본 URL https://api.twexapi.io를 사용합니다.

Zapier 통합 패턴 선택

커뮤니티 노드 + MCP 에이전트

탐색에는 MCP 지원 에이전트를 사용하고, 엄격한 JSON을 Zapier Catch Hook에 POST합니다.

HTTP Request 작업

Webhooks by Zapier 또는 프라이빗 통합에서 TwexAPI REST를 직접 호출합니다.

n8n 스타일 커뮤니티 노드

팀이 이미 n8n을 사용 중이면 전용 n8n community node를 선호합니다.

네이티브 Zapier X 앱은 중단되었습니다. TwexAPI는 Catch Hooks, HTTP Request, 프라이빗 Zapier 앱을 통해 계속 사용할 수 있습니다.

전제조건

TwexAPI API 키
Webhooks by Zapier가 있는 Zapier 계정
선택적 Slack, Google Sheets, Airtable, HubSpot 또는 Gmail 대상
https://api.twexapi.io/mcp에 연결된 선택적 MCP 지원 에이전트

API 키 인증

TwexAPI REST 호출용 재사용 가능한 자격 증명을 생성합니다.

인증

HTTP Request에서 Header Auth 또는 커스텀 헤더를 선택합니다.

헤더 이름

헤더 이름을 Authorization으로 설정합니다.

헤더 값

Bearer YOUR_API_KEY를 자격 증명 값으로 붙여넣습니다.

Zapier 외부 MCP 지원 AI Agent 단계에는 x-api-key: YOUR_API_KEY 헤더로 https://api.twexapi.io/mcp를 구성합니다.

통합 구조

Catch Hook 생성

Webhooks by Zapier를 사용하고 에이전트 핸드오프 또는 외부 POST용 Catch Hook을 선택합니다.

TwexAPI 행 수집

MCP, HTTP Request 또는 외부 워커로 엄격한 JSON을 생성합니다.

안정적인 필드 매핑

tweet_id를 중복 제거 키로 사용합니다. 텍스트, 작성자, URL, 커서 필드를 매핑합니다.

대상으로 라우팅

행을 Slack, Sheets, Airtable, HubSpot 또는 이메일로 보냅니다.

시작 작업

다음 일반적인 읽기 작업에는 HTTP Request 또는 프라이빗 Zapier 앱을 사용합니다.

트윗 검색

searchTerms, sortBy, nextCursor와 함께 POST /twitter/advanced_search/page.

사용자 프로필 조회

GET /twitter/{screen_name}/about

사용자 검색

GET /twitter/search-user/{keyword}/{target_count}

트렌드 조회

국가, 주제, 콘텐츠 필터와 함께 GET /twitter/global-trending/tweets.

팔로워 조회

사용자명과 커서 페이지네이션과 함께 POST /v3/twitter/users/followers.

트윗 생성

사람 승인 및 쿠키 설정 후 POST /twitter/tweets/create.

HTTP Request 예제: 트윗 검색

{
  "method": "POST",
  "url": "https://api.twexapi.io/twitter/advanced_search/page",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  "body": {
    "searchTerms": ["AI agents lang:en"],
    "sortBy": "Latest",
    "nextCursor": ""
  }
}

결과 핸드오프

다음 Zap 단계에 안정적인 핸드오프 필드만 필요할 때 Formatter 또는 Code 단계를 사용합니다.

트윗 검색 페이지

쿼리를 저장합니다. 각 트윗 id를 tweet_id로 매핑하고 text, 작성자 사용자명, created_at을 포함합니다. has_next_page와 next_cursor를 유지합니다.

사용자 프로필 행

소스 id를 user_id로 저장하고 username, name, 팔로워 수, 조회 입력을 포함합니다.

트렌드 행

국가, 주제, 콘텐츠 태그, 워크플로 실행 메타데이터가 포함된 트윗 행을 저장합니다.

트윗 또는 답글 쓰기

Zapier에서 게시하기 전 CLI --dry-run으로 미리 봅니다. 쓰기 작업에는 쿠키 또는 auth_token이 필요합니다.

레시피 1: MCP 에이전트 연구 → Slack

권장 MCP 에이전트 프롬프트:

Find recent posts about AI agents in fintech, group them by theme, and list 5 accounts worth monitoring.
Return only JSON with route_used, tweets, has_more, and next_cursor.
Each tweet must include tweet_id, author_username, text, created_at, and public_url.
Do not call write endpoints.

Zap 단계:

Catch Hook이 JSON 페이로드를 수신합니다.
Loop 또는 line-item으로 tweets를 순회합니다.
빈 행을 필터링합니다.
작성자, 텍스트, URL이 포함된 Slack 메시지를 보냅니다.

레시피 2: 스케줄 트윗 검색 → Google Sheets

Zap을 매일 또는 매시간 스케줄합니다.
HTTP Request가 POST /twitter/advanced_search/page를 호출합니다.
반환된 트윗을 순회합니다.
tweet_id, 작성자, 텍스트, created_at, 구성된 URL을 Sheets에 추가합니다.
후속 Zap이 페이지네이션을 이어가야 하면 Storage by Zapier에 next_cursor를 저장합니다.

레시피 3: 인기 트윗 알림

{
  "method": "GET",
  "url": "https://api.twexapi.io/twitter/global-trending/tweets",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  },
  "query": {
    "country": "United States",
    "topic": "Sports",
    "content": "NFL",
    "count": 20
  }
}

참여도로 필터링한 뒤 요약 텍스트를 Slack 또는 이메일로 라우팅합니다.

오류 처리

상태	Zap 동작
`400`	중지하고 요청 매핑을 수정합니다.
`401`	Zap을 실패 처리하고 운영팀에 API 키 교체를 알립니다.
`403`	계정 액세스 또는 크레딧이 해결될 때까지 일시 중지합니다.
`429`	Zapier 내장 replay로 지연 후 재시도합니다.
`5xx`	주의하여 재시도하고 커서를 보존합니다.

프라이빗 통합 청사진

TwexAPI를 프라이빗 Zapier 통합으로 패키징할 때는 작고 신뢰할 수 있는 표면으로 시작합니다.

리소스	작업
Tweets	트윗 검색, 트윗 상세, 승인 후 트윗 생성
Users	사용자 조회, 사용자 검색
Trends	글로벌 인기 트윗 조회
Followers	팔로워 v3 페이지 조회

패키징된 작업에는 REST를, 에이전트 기반 탐색 워크플로에는 MCP를 사용합니다.

테스트 체크리스트

실제 TwexAPI 핸드오프 페이로드로 Catch Hook을 테스트합니다.
모든 REST 요청에 Authorization: Bearer YOUR_API_KEY가 포함되는지 확인합니다.
대상 앱에 쓰기 전 tweet_id를 중복 제거 키로 사용합니다.
후속 Zap용 Storage by Zapier에 next_cursor를 저장합니다.
사람이 최종 텍스트를 승인할 때까지 쓰기 작업은 초안으로 유지합니다.

다음 단계

팀이 TwexAPI 커뮤니티 노드를 선호하면 n8n
시각적 시나리오 라우팅에는 Make
Agent MCP Handoff
Advanced Twitter Search