最近折腾了一个命令行版的 V2EX 客户端，叫做 v2ex-cli，主要是给两类人用的：
1 ）日常习惯在终端里晃悠的 V 友
2 ）在搞各种 AI / Agent / 脚本自动化，希望能「机器可读」地用 V2EX 数据的人
简单说，它不是传统那种交互式 TUI 客户端，而是 一条命令跑完就退出，输出尽量高信息密度，既方便人肉看，也方便丢给脚本和 AI 去处理。
它大概长这样
安装（需要 Node 18+）：
npm install -g @pengyanai/v2ex-cli
# 或者直接临时跑
npx @pengyanai/v2ex-cli hot
看看热帖前 5 条：
v2ex hot --limit 5
看「问与答」节点最近的帖子：
v2ex topics qna --limit 5
默认输出是 TSV 风格的纯文本，没有花里胡哨的颜色和框框，拿 awk / sed 简单切一切就能继续用。
如果你想给脚本或者 LLM 看，加个 --json 就能直接变成结构化输出，例如：
v2ex hot --json --limit 5 | jq -r '.[].title'
为啥又造一个轮子？
市面上的 V2EX 终端客户端，大多是面向「人」的：全屏 TUI ，支持上下翻页、键盘快捷键，体验很好。但对「机器」和「 Agent 」就很不友好：
- 需要人手动交互，没法一条命令里把事情做完
- 输出样式复杂，不好被脚本解析
- 退出码不稳定，很难在 CI 、Agent 里判断成功 / 失败
v2ex-cli 做了几个刻意的设计取舍：
- 单次调用：一条命令只做一件事，打一个 API ，结束就退
- 高信息密度：默认输出接近「表格」，一行一条记录，方便管道处理
- JSON 一键切换：加
--json就变成稳定字段的 JSON - 退出码固定：
0正常 ·1API / 网络错误 ·2鉴权问题
所以无论是人肉在终端里扫一眼，还是写成 cron / 监控脚本 / AI 工具，都比较顺手。
能做些什么？
目前支持的命令大致包括：
v2ex latest/v2ex hot：看首页热帖、全站最新v2ex nodes：查看内置的一些常用节点v2ex topics <node>：某个节点下的帖子列表v2ex topic <id> [--with-replies]：单个帖子详情，也可以顺带拉第一页回复v2ex replies <topicId>：只看回复，带楼层号v2ex member [username]：看某个用户的公开信息v2ex notifications：看自己的通知（需要 token ）v2ex search <关键词...>：通过 SOV2EX 做搜索，支持稍微复杂一点的 ES 查询语法
想用来做点「小自动化」的话，比如：
- 每天定时查「问与答」里还没人回复的问题，顺手去帮忙解答
- 搜索某几个关键词（比如自己关注的技术栈、城市、关键字），有新贴就推送到 Telegram / 飞书
- 给自己的 AI Agent 挂一个「 V2EX 工具」，让它能自己查帖子、读回复、做统计
这类场景都可以直接靠一两行命令拼出来。
搜索场景举几个更接地气的例子
平时在站内大家应该都干过这些事：刷家庭矛盾、刷副业赚钱贴、看这一个月里又有多少人讨论某个话题。用 v2ex-cli 可以直接在终端里这么玩：
比如一口气看最近提到「家庭 / 矛盾 / 孩子 / 教育 / 婚姻 / 婆媳」这些关键词的帖子（背后是 SOV2EX 的 OR 查询）：
v2ex search '家庭|矛盾|孩子|教育|原生家庭|父母|养老|婚姻|婆媳'
刷「副业 / 赚钱」相关的帖子里，按回复数找出最热的前三个，只看标题和回复数：
v2ex search '副业|赚钱'
想看过去 30 天里有多少贴在讨论「 AI 编辑器」这类话题，也可以直接算一把：
v2ex search 'AI 编辑器' --sort created
上面这些，本质上就是把大家平时在网页上点来点去的动作，压成了几条命令；不管是自己在终端里看看，还是挂到某个监控脚本 / RSS / Agent 上，都比较顺手。
关于鉴权和隐私
V2EX 的公开 API 本身就支持匿名访问，所以大部分读操作都 不需要 token：
- 看热帖 / 最新
- 看节点、帖子、回复
- 看别人公开的 member 信息
只有涉及到你自己账号的部分才需要填 token ，比如：
v2ex auth自测 token 是否可用v2ex notifications看自己的站内通知- 不带用户名的
v2ex member（等于「看我自己」）
Token 获取方式还是官方后台那一套，用环境变量 V2EX_TOKEN 或者在 ~/.v2ex.json 里写入即可，支持配置代理。
给爱折腾的人准备的
整个工具其实就是遵循一个原则：尽量少给你加「界面」，多给你「数据」。
如果你只是偶尔想刷刷 V2EX ，浏览器肯定是最舒服的入口；
但如果你经常开着终端、写脚本、玩 AI / Agent ，或者就是习惯用搜索刷各种站内话题，那可能会用得上这么一个小东西。
项目完全开源，名字叫 v2ex-cli，包名是 @pengyanai/v2ex-cli，欢迎试用、拍砖，也可以直接提 issue 说说你希望它还能多做点什么。
Select Language