@renxqoo/rx60s-cli
v1.2.0
Published
rx60s — understand the world in 60 seconds every day, an open-data CLI built on @renxqoo/agent-data-cli, wrapping all public APIs of the vikiboss/60s open-source project (news, trending, weather, fuel prices, lunar calendar, translate, QR code, 60+ endpoi
Maintainers
Readme
@renxqoo/rx60s-cli (rx60s)
每天 60 秒读懂世界 · 开放数据 agent 命令行工具 —— 基于 @renxqoo/agent-data-cli 框架,全量封装 vikiboss/60s 开源项目的公开接口。无需登录、无需 API key。
快速开始
一键安装(推荐)
npx @renxqoo/rx60s-cli install自动完成两步:① 全局安装 CLI → ② 安装 Skill 到你的 AI 工具发现目录(~/.agents 始终写 + 已装工具 ~/.claude/~/.codex/~/.cursor/~/.zcode/~/.openclaw/~/.pi 自动探测)。需 Node ≥ 20。
npx无需预装,跑完即得全局rx60s命令 + 已就位的 skill。本工具无鉴权(全公开数据),无需配置凭证。
手动安装(分步,等价于一键安装)
如果一键安装某步失败或想单独执行:
第 1 步:安装 CLI
npm install -g @renxqoo/rx60s-cli安装后跑 rx60s --help 确认可用。不想全局装?用 npx @renxqoo/rx60s-cli <命令> 临时执行。
第 2 步:安装 Skill(让 AI 工具发现)
把 skill 同步到你的 AI 工具发现目录(~/.agents 始终写 + 已装工具如 ~/.claude/~/.cursor/~/.zcode 自动探测——覆盖 Claude Code / Cursor / Codex / ZCode / OpenClaw / Pi / Trae):
rx60s skills sync同步后 AI 工具即可在用户提到新闻/热搜/天气/油价/翻译/密码等关键词时自动触发本 skill。验证:
rx60s skills list # 列出已装的 skill
ls ~/.agents/skills/rx60s/ # 确认 skill 文件就位功能
覆盖新闻资讯、热搜榜单、生活服务、开发者工具等 60+ 类公开数据:
| 模块 | 说明 |
|------|------|
| news | 每天 60 秒读懂世界 / AI 资讯 / IT 之家资讯与排行 / RSS |
| hot | 微博 / 知乎 / 头条 / 抖音 / B站 / 小红书 / 百度 / 懂车帝 / 夸克 等热搜 |
| tech | Hacker News(top / best) |
| fun | 一言 / 段子 / 冷笑话 / 发病文学 / KFC 文案 / 答案之书 / 今日运势 / 摸鱼日历 |
| music | 网易云榜单 / 歌词搜索 / 唱鸭翻唱 |
| movie | 猫眼票房 / 豆瓣口碑榜 / Epic 免费游戏 |
| life | 实时天气 / 天气预报 / 油价 / 金价 / 汇率 / 老黄历 / 历史上的今天 / 奥运 |
| tool | 有道翻译 / Hash / 二维码 / OG 解析 / WHOIS / IP / 密码 / 颜色 / 化学 |
| kb | 百度百科 / JS 面试题 |
| health | BMI / 健康评估 |
| beta | 酷安热门 / QQ 信息(实验性) |
顶层快捷命令:60s / bing / weibo / zhihu / toutiao / hitokoto / moyu(免去 namespace 前缀)。
常用命令
rx60s 60s # 今天有什么新闻(项目核心)
rx60s hot weibo # 微博实时热搜
rx60s life weather 上海 # 上海实时天气
rx60s life fuel-price --region 广东 # 广东今日油价
rx60s tool fanyi "hello" --to zh-CHS # 有道翻译
rx60s tool password --length 20 --symbols # 生成 20 位含符号密码
rx60s life lunar # 今日老黄历
rx60s hitokoto # 随机一言
rx60s moyu # 摸鱼日历(离放假还有几天)加 --json 强制 JSON 输出(agent / 管道用);加 --no-json 强制人类可读(表格 / 卡片,被管道时仍 JSON 保护下游)。完整命令见 rx60s --help。
输出契约
遵循 agent-data-cli 统一输出格式:{ ok, source, data, meta }。source 恒为 rx60s;列表命令填 meta.count 与 meta.pagination.complete。
数据源
本项目是 vikiboss/60s 开源项目的命令行封装。所有数据由原项目提供并归原作者所有,本项目仅做 CLI 化(命令行封装),不持有/缓存任何数据。原项目 MIT License © Viki。
默认公共实例 https://60s.viki.moe(每日请求额度有限,限流较严格,仅供开发调试)。生产建议自部署原项目后切换:
export RX60S_BASE_URL=https://your-60s.example.com/v2开发
pnpm --filter @renxqoo/rx60s-cli build # 编译
pnpm --filter @renxqoo/rx60s-cli test # 测试(21 用例)
pnpm --filter @renxqoo/rx60s-cli typecheck # 类型检查Skill 文档:skills/rx60s/SKILL.md(frontmatter 手写符合 skill-creator 规范,AUTO-GEN 命令块由 rx60s skills gen 生成)。接口契约见 docs/API.md(68 接口完整字段级文档)。
技术决策
- 命名:npm 包
@renxqoo/rx60s-cli/ bin 命令rx60s/ skillrx60s/ 无 credentialNamespace(全公开数据,不挂 auth)。 - 无鉴权:60s 全部接口公开,
plugins: [],不挂 auth 插件、无需凭证配置。 - 走
ctx.get+ baseUrl:60s 是标准 REST(统一响应{ code, message, data }),用框架请求层 +errorOnStatus(400/404/429/5xx 自动 throw)。baseUrl 含/v2前缀。 - 业务码解包:个别接口可能 HTTP 200 +
code≠200,所有命令经unwrap()解包校验(src/envelope.ts)。 - 强制 json 编码:所有请求自动带
?encoding=json拿结构化数据;text/markdown 由 CLI 本地humanFormat渲染。 - 双 SKILL.md 规范协调:
agent-cli-builder的skills gen生成的 frontmatter 含version字段,但skill-creator的quick_validate.py拒绝version。解法:用gen生成 AUTO-GEN 机械块,frontmatter + 语义内容手写到符合 skill-creator 规范(已通过校验)。
数据来源与致谢
- 数据源 / 上游:vikiboss/60s —— 一系列高质量、开源、可靠、全球 CDN 加速的开放 API 集合,MIT License © Viki。本项目所有数据均来自该开源项目,版权归原项目及原始数据源所有。
- 本项目定位:基于
@renxqoo/agent-data-cli框架对 60s API 的 CLI 化(命令行封装),便于 AI agent 与终端用户调用,不修改、不持有、不缓存任何上游数据。 - CLI 框架:
@renxqoo/agent-data-cli(本 monorepo 的 cli-sdk)。 - 参考实现:
apps/a-stock(同为无鉴权公开数据 CLI)。 - 如上游接口有变动或问题,请至 vikiboss/60s issues 反馈;本项目 CLI 本身的问题请在 本仓库 issues 反馈。
免责声明
- 本项目仅供学习研究使用,不提供、不存储、不缓存任何数据,所有数据来自上游 vikiboss/60s 开源项目及其数据源,版权归原始数据源所有。
- 上游 60s API 的部分接口通过抓取或调用第三方平台(微博、知乎、QQ音乐、有道翻译等)获取数据,可能涉及第三方服务条款(ToS)。本 CLI 仅作为上游 API 的命令行客户端,不包含任何逆向、破解或绕过反爬的代码。 因使用本工具获取的数据而产生的任何法律责任,由使用者自行承担。
- 本项目不对数据的准确性、完整性、时效性做任何保证。用户基于本工具数据做出的任何决策,风险自负。
- 如任何数据源方认为本项目侵犯了其合法权益,请向上游 vikiboss/60s 项目提出,本项目将在收到通知后配合处理。
- 商业化使用(转售服务、集成到商业产品)可能放大法律风险,建议在法律顾问评估后进行。
