---
title: "n8n"
description: "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 통합 선택

<CardGroup cols={2}>
  <Card title="TwexAPI 커뮤니티 노드" icon="plug">
    트윗 검색, 사용자 검색, 프로필 조회, 트렌딩 트윗, 잔액 확인을 위해 `@twexapi-dev/n8n-nodes-x-api-scraper`를 설치하세요.
  </Card>

  <Card title="HTTP Request + MCP" icon="workflow">
    문서화된 REST 경로에는 HTTP Request를 사용하세요. AI 에이전트가 먼저 엔드포인트를 발견해야 할 때 MCP Client Tool을 사용하세요.
  </Card>
</CardGroup>

## 전제조건

* [TwexAPI API 키](https://twexapi.io/dashboard)
* n8n Cloud 또는 자체 호스팅 n8n
* 아래 레시피용 선택적 Slack 및 Google Sheets 자격 증명

## 커뮤니티 노드 설치

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

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

소스: [twexapi-dev/n8n-nodes-x-api-scraper](https://github.com/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](/api-reference/overview)를 사용하세요. TwexAPI는 네이티브 계정 모니터나 이벤트 웹훅을 제공하지 않습니다. 반복 작업에는 예약 REST 호출 또는 노코드 플랫폼 웹훅을 사용하세요.

## API 키 자격 증명

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

<CardGroup cols={3}>
  <Card title="인증" icon="key-round">
    TwexAPI API 자격 증명 또는 HTTP Request 자격 증명에 Header Auth를 선택하세요.
  </Card>

  <Card title="헤더 이름" icon="braces">
    헤더 이름을 `Authorization`으로 설정하세요.
  </Card>

  <Card title="헤더 값" icon="shield-check">
    자격 증명 값으로 `Bearer YOUR_API_KEY`를 붙여넣으세요.
  </Card>
</CardGroup>

`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 행, 재시도 큐에서 원시 응답을 제외하세요.

<CardGroup cols={2}>
  <Card title="트윗 검색 페이지" icon="search">
    요청 쿼리를 저장하세요. 각 트윗 `id`, `text`, 작성자 사용자명, `created_at`을 `tweet_id`, `text`, `author_username`, `created_at`에 매핑하세요. 페이지 루프를 위해 `has_next_page`와 `next_cursor`를 유지하세요.
  </Card>

  <Card title="사용자 프로필 행" icon="users">
    소스 `id`를 `user_id`로 저장하고, `username`, `name`, 팔로워 수, 조회 또는 검색 입력을 함께 저장하세요.
  </Card>

  <Card title="트렌드 행" icon="trending-up">
    각 트렌드 이름, 주제, 콘텐츠 태그, 국가를 저장하세요. 요청한 지역을 워크플로 실행과 함께 유지하세요.
  </Card>

  <Card title="트윗 또는 답글 쓰기" icon="send">
    쓰기 작업에는 저장된 쿠키 또는 `auth_token`이 필요합니다. n8n에서 게시하기 전에 [CLI](/sdks/cli) `--dry-run`으로 미리보기하세요.
  </Card>
</CardGroup>

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

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

1. **AI Agent 노드 추가**

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

2. **MCP 클라이언트 도구 추가**

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

3. **에이전트에 프롬프트**

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

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

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

사용자 프롬프트 예시:

```text
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 채널에 알림을 보냅니다.

### 워크플로 구조

<CardGroup cols={2}>
  <Card title="예약 또는 수동 트리거" icon="calendar-clock">
    테스트 중에는 예약 또는 수동으로 실행하세요.
  </Card>

  <Card title="트윗 검색" icon="search">
    TwexAPI 노드 또는 HTTP Request로 `POST /twitter/advanced_search/page`를 호출하세요.
  </Card>

  <Card title="행 분할" icon="split">
    반환된 트윗에 대해 Split Out을 실행하세요.
  </Card>

  <Card title="알림 게시" icon="message-square">
    형식화된 텍스트를 Slack으로 보내세요.
  </Card>
</CardGroup>

### HTTP Request 예시

```json
{
  "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 노드를 사용하세요.

```text
@{{$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로

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

### 워크플로 구조

<CardGroup cols={2}>
  <Card title="예약 트리거" icon="calendar-clock">
    매일 또는 매시간보내기를 실행하세요. 테스트 중에는 수동 실행하세요.
  </Card>

  <Card title="트윗 검색" icon="search">
    TwexAPI 노드 또는 HTTP Request로 트윗을 검색하고 `next_cursor`를 저장하세요.
  </Card>

  <Card title="행 분할" icon="split">
    반환된 트윗에 대해 Split Out을 실행하세요.
  </Card>

  <Card title="행 추가" icon="file-spreadsheet">
    아래 매핑된 결과 필드로 Google Sheets Append Row를 사용하세요.
  </Card>
</CardGroup>

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

<CardGroup cols={2}>
  <Card title="트윗 ID" icon="hash">
    `id` 또는 `tweet_id`에 매핑하세요.
  </Card>

  <Card title="작성자" icon="at-sign">
    작성자 사용자명 또는 스크린 이름에 매핑하세요.
  </Card>

  <Card title="텍스트" icon="type">
    `text` 또는 `full_text`에 매핑하세요.
  </Card>

  <Card title="작성 시각" icon="calendar">
    `created_at` 또는 `createdAt`에 매핑하세요.
  </Card>

  <Card title="URL" icon="link">
    `https://x.com/i/web/status/{id}`에서 구성하세요.
  </Card>
</CardGroup>

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

## 유용한 REST 작업

<CardGroup cols={2}>
  <Card title="트윗 검색" icon="search">
    `POST /twitter/advanced_search/page`로 X 쿼리 검색을 실행하세요.
  </Card>

  <Card title="사용자 프로필 조회" icon="user-round">
    `GET /twitter/{screen_name}/about`로 X 프로필을 가져오세요.
  </Card>

  <Card title="팔로워 조회" icon="users">
    `POST /v3/twitter/users/followers`로 팔로워 목록을 읽으세요.
  </Card>

  <Card title="트렌드 조회" icon="trending-up">
    `GET /twitter/global-trending/tweets`로 글로벌 트렌딩 트윗을 읽으세요.
  </Card>

  <Card title="트윗 생성" icon="send">
    `POST /twitter/tweets/create`로 텍스트 또는 미디어 게시물을 게시하세요.
  </Card>

  <Card title="DM 전송" icon="message-circle">
    `POST /v3/twitter/send-dm`으로 DM을 보내세요.
  </Card>
</CardGroup>

## 테스트 체크리스트

* 각 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](/sdks/cli)로 페이로드를 미리보기하세요.

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

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

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

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

## 다음 단계

* 엄격한 JSON 핸드오프 패턴은 [에이전트 MCP 핸드오프](/mcp/agent-handoff)를 읽으세요.
* 쓰기 작업 dry-run 미리보기는 [CLI](/sdks/cli)를 읽으세요.
* AI Agent 워크플로 구축 시 [MCP 도구](/mcp/tools)를 사용하세요.