---
title: "TypeScript SDK"
description: "使用 TwexAPI TypeScript SDK 进行推文搜索、粉丝导出、私信、媒体推文与 Node.js X API 自动化。"
---

当你需要在 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 编程AI Agent包

从 npm 安装捆绑的 TwexAPI Skills：

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

## 参考

* [SDK 概览](/sdks)
* [认证](/authentication)
* [MCP 服务器](/mcp/overview)
* [高级 Twitter 搜索](/api-reference/search-endpoints/get-data-page-twitter-advanced-search-page-post)
* [源码仓库](https://github.com/twexapi-dev/x-api-scraper-typescript)