yarn-threads

Threads（Meta 出品）的命令行工具。支持读取、浏览和发帖。

安装

npm install -g yarn-threads-cli

验证安装：

yarn-threads --version

认证

支持三种认证方式（按推荐优先级排序）：

• Chrome 用户配置文件（推荐）
• Firefox 用户配置文件
• 手动提供 token（通过浏览器 DevTools → Application → Cookies 标签页，在 threads.net 域下获取）

有关认证配置的详细说明，请参阅 yarn-threads-cli 官方文档。

验证认证状态：yarn-threads whoami

核心命令

# 浏览
yarn-threads home                        # 首页信息流
yarn-threads likes                       # 你点赞过的帖子
yarn-threads saved                       # 你保存/收藏的帖子

# 读取
yarn-threads read           # 单条帖子
yarn-threads thread         # 帖子及其全部回复
yarn-threads replies        # 仅回复内容

# 用户资料
yarn-threads about               # 用户资料信息
yarn-threads user-posts          # 用户发布的所有帖子
yarn-threads followers           # 用户的粉丝列表
yarn-threads following           # 用户关注的人

# 搜索
yarn-threads search               # 按关键词搜索用户

# 发帖 / 互动
yarn-threads post "text"                 # 创建新帖子
yarn-threads reply  "text"  # 回复某条帖子
yarn-threads quote  "text"  # 引用某条帖子

输出格式选项

• --json —— 结构化 JSON 输出（适用于解析媒体 URL 和元数据）
• --plain —— 稳定的纯文本输出，不含 emoji 或颜色（适合管道传输）
• --json-full —— 包含原始 API 响应（用于调试）

分页控制

信息流/列表类命令支持以下分页参数：

• --all —— 获取全部分页内容
• --max-pages —— 限制最多获取的分页数
• --cursor —— 从指定游标位置开始获取

媒体资源

使用 --json 时，帖子对象中 media 字段将包含图片与视频的 CDN 地址。可使用 image 工具分析这些地址以获取视觉上下文。

示例

# 以 JSON 格式获取最近 2 页的点赞记录
yarn-threads likes --max-pages 2 --json

# 读取特定 thread
yarn-threads read https://www.threads.net/@user/post/abc123

# 发布一条限制回复权限的帖子
yarn-threads post "Hello Threads" --reply-control accounts_you_follow

# 获取用户资料
yarn-threads about zuck

完整参数参考请见 references/commands.md。