---
title: "TypeScript SDK"
description: "Node.js X API 자동화를 위해 TwexAPI TypeScript SDK로 트윗 검색, 팔로워보내기, DM, 미디어 트윗을 사용합니다."
---

Node.js, Bun 또는 서버 사이드 TypeScript에서 TwexAPI REST 워크플로를 위해 타입 요청 매개변수, 응답 모델, 재시도, 자동 완성이 필요할 때 TypeScript SDK를 사용하세요.

| TypeScript 작업 | SDK 호출 | 저장 |
| ---------------- | ------------------------ | ------------ |
| 트윗 검색 | `client.search.advanced` | `nextCursor` |
| 프로필 읽기 | `client.users.getAbout` | `screenName` |
| 팔로워 목록 | `client.users.followers.list` | cursor |

쓰기 페이로드를 테스트할 때는 먼저 [CLI](/sdks/cli)에서 `--dry-run`을 사용하세요.

## 오류 처리

```ts
import { XApiScraper } from "@twexapi-dev/x-api-scraper";
import * as errors from "@twexapi-dev/x-api-scraper/models/errors";

try {
  await client.search.advanced({
    searchTerms: ["from:elonmusk"],
    sortBy: "Latest",
    nextCursor: "",
  });
} catch (error) {
  if (error instanceof errors.XAPIScraperError) {
    console.error(error.statusCode, error.body);
  } else {
    throw error;
  }
}
```

클라이언트는 기본적으로 지수 백오프로 연결 오류를 재시도합니다. `retries` 옵션으로 요청별로 재정의할 수 있습니다.

## Pi 코딩 에이전트 패키지

npm에서 번들 TwexAPI Skills를 설치하세요.

```bash
pi install npm:@twexapi-dev/x-api-scraper
```

## 참고 자료

* [SDK 개요](/sdks)
* [인증](/authentication)
* [MCP 서버](/mcp/overview)
* [고급 트위터 검색](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)
* [소스 저장소](https://github.com/twexapi-dev/x-api-scraper-typescript)