---
title: "TypeScript SDK"
description: "TwexAPI TypeScript SDK でツイート検索、フォロワーエクスポート、DM、メディアツイート、Node.js X API 自動化。"
---

Node.js、Bun、サーバーサイド TypeScript で TwexAPI REST ワークフローに型付きリクエスト、レスポンスモデル、リトライ、オートコンプリートが欲しいときに TypeScript SDK を使いましょう。

| TypeScript task | SDK call | Save |
| ---------------- | ------------------------ | ------------ |
| Search tweets | `client.search.advanced` | `nextCursor` |
| Read profile | `client.users.getAbout` | `screenName` |
| List followers | `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
```

## 参考

* [SDKs overview](/sdks)
* [Authentication](/authentication)
* [MCP Server](/mcp/overview)
* [Advanced Twitter Search](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)
* [Source Repository](https://github.com/twexapi-dev/x-api-scraper-typescript)