twitter-x-hub · diff

git:20260309.c0ef647 to git:20260408.d201033

85 added, 57 removed. Audit A to A.

---

name: twitter-x-hub

description: >

使用 Python + UV 读写 Twitter/X 数据的技能，零第三方依赖（纯标准库），通过直接传入

auth_token + ct0 Cookie 完成认证。在 Minis 环境中，Cookie 可通过 browser_use 工具

导航到 x.com 后用 get_cookies 动作自动获取，无需手动复制。支持抓取主页时间线、关注列表、

- 书签、搜索、用户资料、用户推文、点赞、推文详情、List 时间线、粉丝/关注列表，以及发推、

- 删推、点赞、转推、收藏等写操作。当用户提到"抓取 Twitter 数据"、"获取 X 推文"、

- "Twitter 时间线"、"X 书签"、"搜索推文"、"twitter-x-hub"、"用 Cookie 请求 Twitter"、

- "Twitter GraphQL"，或任何需要以编程方式读写 Twitter/X 数据的场景，必须触发本技能。

+ 书签（含书签文件夹）、搜索、用户资料、用户推文、点赞、推文详情（单条/含回复）、List 时间线、

+ 粉丝/关注列表，以及发推、删推、点赞、转推、收藏等写操作。当用户提到"抓取 Twitter 数据"、

+ "获取 X 推文"、"Twitter 时间线"、"X 书签"、"搜索推文"、"twitter-x-hub"、

+ "用 Cookie 请求 Twitter"、"Twitter GraphQL"，或任何需要以编程方式读写 Twitter/X

+ 数据的场景，必须触发本技能。

---

# twitter-x-hub

- > **改造来源**：[jackwener/twitter-cli](https://github.com/jackwener/twitter-cli)

- > 本技能对原仓库做了以下简化：移除 `browser-cookie3`/`rich`/`click`/`PyYAML` 依赖，

- > 改为纯标准库实现；认证方式改为直接传入 Cookie，不做浏览器自动提取。

+ > **改造来源**：[public-clis/twitter-cli](https://github.com/public-clis/twitter-cli)（原 jackwener/twitter-cli）

+ > 本技能对原仓库做了以下简化：移除 `browser-cookie3`/`rich`/`click`/`PyYAML`/`curl_cffi`/

+ > `xclienttransaction`/`beautifulsoup4` 依赖，改为纯标准库实现；认证方式改为直接传入 Cookie，

+ > 不做浏览器自动提取；移除 Twitter Article 渲染和图片上传功能。

---

## 文件结构

```

/var/minis/skills/twitter-x-hub/

├── SKILL.md

├── pyproject.toml # UV 项目配置（零第三方依赖）

└── scripts/

├── __init__.py

- ├── models.py # 数据模型（Tweet, Author, Metrics, UserProfile…）

+ ├── models.py # 数据模型（Tweet, Author, Metrics, UserProfile, BookmarkFolder）

+ ├── parser.py # GraphQL 响应解析（从 client.py 拆出，同步自上游 v0.8.6）

├── client.py # GraphQL 客户端（核心逻辑）

└── cli.py # 命令行入口（argparse）

```

---

## 认证方式

Twitter/X 内部 GraphQL API 使用两个 Cookie 做认证：

| Cookie | 说明 |

|--------|------|

| `auth_token` | 用户登录凭证（OAuth Session Token） |

| `ct0` | CSRF Token，同时作为 `X-Csrf-Token` 请求头 |

### 方法一：browser_use 工具自动获取（推荐，Minis 环境首选）

在 Minis 中可直接用 `browser_use` 工具导航到 x.com，再用 `get_cookies` 动作读取 Cookie，

无需手动复制。**获取后应立即存入环境变量**，避免明文出现在对话上下文中。

操作步骤：

1. `browser_use navigate` 打开 `https://x.com`，确认已登录

- 2. `browser_use get_cookies` 过滤 `auth_token`，再过滤 `ct0`

- - 工具会返回一个 offload env 文件路径（如 `/var/minis/offloads/env_cookies_xxx.sh`）

- - **Cookie 原始值不会出现在对话中**，通过 `. <env_file>` 加载到 shell 环境变量

- 3. 加载后即可直接使用环境变量调用脚本：

+ 2. `browser_use get_cookies` 获取所有 cookie

+ - 工具返回 offload env 文件路径（如 `/var/minis/offloads/env_cookies_xxx.sh`）

+ - **Cookie 原始值不会出现在对话中**

+ 3. 加载后即可使用：

```bash

. /var/minis/offloads/env_cookies_xxx.sh

- # 文件内已导出 COOKIE_AUTH_TOKEN / COOKIE_CT0 等变量，按实际变量名使用

export TWITTER_AUTH_TOKEN="$COOKIE_AUTH_TOKEN"

export TWITTER_CT0="$COOKIE_CT0"

```

- > **注意**：`get_cookies` 仅对当前页面的域名生效，需先 navigate 到 `https://x.com` 再调用。

- ### 方法二：手动从浏览器 DevTools 获取

+ ### 方法二：手动设置环境变量

- 1. 登录 x.com，打开 DevTools → Application → Cookies → `https://x.com`

- 2. 找到 `auth_token` 和 `ct0` 的值，复制后存入 Minis 环境变量（Settings → Environments）

+ 从浏览器 DevTools → Application → Cookies → `https://x.com` 复制 `auth_token` 和 `ct0`，

+ 存入 Minis 环境变量（Settings → Environments）：`TWITTER_AUTH_TOKEN` + `TWITTER_CT0`

### 传入方式（三种，优先级从高到低）

- 1. 环境变量：`TWITTER_AUTH_TOKEN` + `TWITTER_CT0`（推荐，避免明文出现在命令行）

+ 1. 环境变量：`TWITTER_AUTH_TOKEN` + `TWITTER_CT0`（推荐）

2. CLI 参数：`--auth-token <value> --ct0 <value>`

3. 代码直接传入：`TwitterClient(auth_token=..., ct0=...)`

---

## 快速使用

### 环境准备

```bash

# 确认 UV 可用

which uv || pip install uv

# 进入 skill 目录

cd /var/minis/skills/twitter-x-hub

```

### CLI 用法

```bash

# 抓取首页 For-You 时间线（默认20条）

- uv run python -m scripts.cli feed \