본문으로 건너뛰기
Twexapi
한국어
English简体中文日本語Español한국어FrançaisTürkçe
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

n8n

TwexAPI를 통해 트윗 검색, 사용자 조회, 트렌딩 트윗, AI 에이전트, 커서 안전 핸드오프를 위한 n8n Twitter 워크플로를 구축합니다.

TwexAPI로 n8n Twitter 워크플로를 구축합니다. 트윗을 검색하고, 사용자를 조회하며, 트렌딩 트윗을 읽고, AI 에이전트를 실행합니다. 이 통합은 TwexAPI 커뮤니티 노드, HTTP Request, Webhook, MCP Client Tool 노드를 사용합니다.

TwexAPI는 하나의 API 키와 REST 기본 URL https://api.twexapi.io를 사용합니다.

n8n Twitter 통합 선택

TwexAPI 커뮤니티 노드

트윗 검색, 사용자 검색, 프로필 조회, 트렌딩 트윗, 잔액 확인을 위해 @twexapi-dev/n8n-nodes-x-api-scraper를 설치하세요.

HTTP Request + MCP

문서화된 REST 경로에는 HTTP Request를 사용하세요. AI 에이전트가 먼저 엔드포인트를 발견해야 할 때 MCP Client Tool을 사용하세요.

전제조건

  • TwexAPI API 키
  • n8n Cloud 또는 자체 호스팅 n8n
  • 아래 레시피용 선택적 Slack 및 Google Sheets 자격 증명

커뮤니티 노드 설치

Settings → Community Nodes에서 @twexapi-dev/n8n-nodes-x-api-scraper를 설치하세요.

npm install @twexapi-dev/n8n-nodes-x-api-scraper

소스: twexapi-dev/n8n-nodes-x-api-scraper

지원 작업

작업 n8n 작업 TwexAPI 경로
트윗 검색 Tweet: search POST /twitter/advanced_search/page
사용자 검색 User: search GET /twitter/search-user/{keyword}/{target_count}
프로필 조회 User: get GET /twitter/{screen_name}/about
트렌딩 트윗 읽기 Trend: get GET /twitter/global-trending/tweets
잔액 보기 Account: get balance GET /balance

팔로워 페이지네이션, 목록, 커뮤니티, 승인된 게시에는 REST API를 사용하세요. TwexAPI는 네이티브 계정 모니터나 이벤트 웹훅을 제공하지 않습니다. 반복 작업에는 예약 REST 호출 또는 노코드 플랫폼 웹훅을 사용하세요.

API 키 자격 증명

TwexAPI용 재사용 가능한 n8n 자격 증명을 생성하세요.

인증

TwexAPI API 자격 증명 또는 HTTP Request 자격 증명에 Header Auth를 선택하세요.

헤더 이름

헤더 이름을 Authorization으로 설정하세요.

헤더 값

자격 증명 값으로 Bearer YOUR_API_KEY를 붙여넣으세요.

https://api.twexapi.io를 호출하는 모든 HTTP Request 노드에서 해당 자격 증명을 사용하세요.

MCP 지원 AI Agent 노드의 경우 MCP Client Tool을 https://api.twexapi.io/mcp와 헤더 x-api-key: YOUR_API_KEY로 구성하세요.

결과 핸드오프

다음 노드가 안정적인 핸드오프 필드만 필요할 때 각 HTTP Request 또는 TwexAPI 노드 뒤에 Edit Fields 노드를 사용하세요. Slack 메시지, Sheets 행, 재시도 큐에서 원시 응답을 제외하세요.

트윗 검색 페이지

요청 쿼리를 저장하세요. 각 트윗 id, text, 작성자 사용자명, created_at을 tweet_id, text, author_username, created_at에 매핑하세요. 페이지 루프를 위해 has_next_page와 next_cursor를 유지하세요.

사용자 프로필 행

소스 id를 user_id로 저장하고, username, name, 팔로워 수, 조회 또는 검색 입력을 함께 저장하세요.

트렌드 행

각 트렌드 이름, 주제, 콘텐츠 태그, 국가를 저장하세요. 요청한 지역을 워크플로 실행과 함께 유지하세요.

트윗 또는 답글 쓰기

쓰기 작업에는 저장된 쿠키 또는 auth_token이 필요합니다. n8n에서 게시하기 전에 CLI --dry-run으로 미리보기하세요.

레시피 1: MCP로 AI 에이전트 X 리서치

이 레시피로 AI 에이전트를 TwexAPI와 통합합니다. 에이전트가 실시간 트윗을 검색하고, 트렌드를 요약하며, 프로필을 검사하고, 팔로워 활동을 비교할 수 있습니다.

AI Agent 노드 추가

선호하는 채팅 모델로 AI Agent 워크플로를 생성하세요.

MCP 클라이언트 도구 추가

Server Transport를 HTTP Streamable로 설정하세요. MCP Endpoint URL을 https://api.twexapi.io/mcp로 설정하세요. Authentication을 이름 x-api-key와 TwexAPI API 키가 있는 Header Auth로 설정하세요.

에이전트에 프롬프트

에이전트에게 먼저 explore를 호출한 다음 twexapi_request를 호출하고 JSON만 반환하도록 지시하세요.

권장 에이전트 시스템 프롬프트:

Use TwexAPI for every X research request. Call explore before twexapi_request. Search tweets, inspect accounts, and cite the returned post URLs. Prefer small, targeted searches before broad exports.

사용자 프롬프트 예시:

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.

MCP 서버는 엔드포인트 발견을 위한 explore와 인증된 호출을 위한 twexapi_request를 노출합니다.

레시피 2: 트윗 검색에서 Slack으로

TwexAPI 커뮤니티 노드 또는 HTTP Request로 트윗을 검색한 다음 Slack 채널에 알림을 보냅니다.

워크플로 구조

예약 또는 수동 트리거

테스트 중에는 예약 또는 수동으로 실행하세요.

트윗 검색

TwexAPI 노드 또는 HTTP Request로 POST /twitter/advanced_search/page를 호출하세요.

행 분할

반환된 트윗에 대해 Split Out을 실행하세요.

알림 게시

형식화된 텍스트를 Slack으로 보내세요.

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": ""
  }
}

Slack 메시지

Slack 전에 Set 노드를 사용하세요.

@{{$json.author_username || $json.user?.screen_name}}
{{$json.text || $json.full_text}}
https://x.com/i/web/status/{{$json.tweet_id || $json.id}}

레시피 3: 검색 결과를 Google Sheets로

팀이 스프레드시트에 트윗 검색 결과가 필요할 때 사용하세요.

워크플로 구조

예약 트리거

매일 또는 매시간보내기를 실행하세요. 테스트 중에는 수동 실행하세요.

트윗 검색

TwexAPI 노드 또는 HTTP Request로 트윗을 검색하고 next_cursor를 저장하세요.

행 분할

반환된 트윗에 대해 Split Out을 실행하세요.

행 추가

아래 매핑된 결과 필드로 Google Sheets Append Row를 사용하세요.

Google Sheets에 다음 필드를 매핑하세요.

트윗 ID

id 또는 tweet_id에 매핑하세요.

작성자

작성자 사용자명 또는 스크린 이름에 매핑하세요.

텍스트

text 또는 full_text에 매핑하세요.

작성 시각

created_at 또는 createdAt에 매핑하세요.

URL

https://x.com/i/web/status/{id}에서 구성하세요.

대규모 작업의 경우 has_next_page 또는 has_more가 true인 동안 루프하고 next_cursor를 검색 본문에 다시 전달하세요.

유용한 REST 작업

트윗 검색

POST /twitter/advanced_search/page로 X 쿼리 검색을 실행하세요.

사용자 프로필 조회

GET /twitter/{screen_name}/about로 X 프로필을 가져오세요.

팔로워 조회

POST /v3/twitter/users/followers로 팔로워 목록을 읽으세요.

트렌드 조회

GET /twitter/global-trending/tweets로 글로벌 트렌딩 트윗을 읽으세요.

트윗 생성

POST /twitter/tweets/create로 텍스트 또는 미디어 게시물을 게시하세요.

DM 전송

POST /v3/twitter/send-dm으로 DM을 보내세요.

테스트 체크리스트

  • 각 HTTP Request 또는 TwexAPI 노드에서 n8n Test Step 작업을 사용하세요.
  • 모든 REST 요청에 Authorization: Bearer YOUR_API_KEY가 포함되는지 확인하세요.
  • 모든 MCP Client Tool 요청에 x-api-key가 포함되는지 확인하세요.
  • 페이지네이션 작업의 경우 각 페이지 후 next_cursor를 저장하세요.
  • 429 발생 시 재시도 전에 대기하고 커서를 보존하세요.

n8n Twitter 자동화 FAQ

TwexAPI를 통해 n8n을 Twitter에 연결하려면?

TwexAPI 커뮤니티 노드를 설치하거나 Authorization: Bearer YOUR_API_KEY로 Header Auth를 생성하세요. 모든 TwexAPI 요청에서 선택하세요.

n8n Twitter 검색은 어떻게 동작하나요?

커뮤니티 노드 또는 HTTP Request를 통해 POST /twitter/advanced_search/page를 호출하세요. 모든 페이지에 대해 쿼리와 커서를 저장하세요.

n8n에서 Twitter에 게시할 수 있나요?

예, POST /twitter/tweets/create를 통해 가능합니다. 쓰기 작업에는 쿠키 또는 auth_token이 필요합니다. 먼저 CLI로 페이로드를 미리보기하세요.

n8n Twitter 에이전트를 구축할 수 있나요?

예. n8n Twitter 에이전트는 https://api.twexapi.io/mcp의 MCP를 통해 트윗, 프로필, 트렌드를 검색할 수 있습니다.

자체 호스팅 n8n에서 TwexAPI를 사용할 수 있나요?

예. https://api.twexapi.io로 아웃바운드 HTTPS를 허용하세요.

다음 단계

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