skills Skill
description: 基于 tophub 的命令行工具，提供快速获取实时热点资讯的功能。用于查询各大平台（微博、知乎、抖音等）的热点榜单和趋势数据。
Want an agent-native computer in the browser? Try HappyCapy.
Cloud sandbox for AI agents · No setup · Run autonomous workflows from your browser
Affiliate link — we may earn a commission at no extra cost to you.
Why use this skill
skills is most useful when you want an agent workflow that is more structured than an ad-hoc prompt. Instead of restating the same expectations every time, a dedicated SKILL.md file gives the assistant a repeatable brief. In this case, the core value is clarity: the repo already frames the workflow around utility skills tasks, and the skill source gives you a portable starting point you can evaluate, adapt, and reuse. The inferred platform for this skill is Generic Skills, which helps you judge whether it is likely to feel native in your current agent ecosystem or whether it is better treated as a general reference.
That matters because AI assistants are better when the operating context is explicit. A good skill turns hidden team expectations into visible instructions. It can name preferred tools, describe failure modes, define what “done” looks like, and reduce the amount of corrective prompting you need after the first draft. For developers exploring the wider SKILL.md ecosystem, this page helps answer the practical question: is this skill specific and maintained enough to be worth trying?
How to evaluate and use it
Start with the source repo and the preview below. The preview tells you whether the instructions are actionable or just aspirational. Strong skills usually describe triggers, recommended tools, steps, and known pitfalls. Weak skills tend to stay generic. This one lives in tiwe0/tophub-cli, which gives you a concrete repo context, update history, and direct ownership trail.
Once you confirm the scope looks right, test it on a small task before making it part of a larger workflow. If it improves consistency, keep it. If it is too broad, outdated, or conflicts with your own process, treat it as a reference rather than a drop-in rule. That is the healthiest way to use directory-discovered skills: not as magic plugins, but as reusable operational knowledge that still deserves judgment.
SKILL.md preview
Previewing the source is one of the fastest ways to judge whether a skill is truly useful. This snippet comes from the public file in the linked repository.
---
name: tophub-cli
description: 基于 tophub 的命令行工具，提供快速获取实时热点资讯的功能。用于查询各大平台（微博、知乎、抖音等）的热点榜单和趋势数据。
---
# Tophub CLI 技能说明
## 作用
使用 `tophub-cli` 获取 Tophub API 榜单数据，支持并发节点查询，并将结果导出为带时间戳的文件。
## 安装
查看当前机器架构，将文件夹中对应架构的二进制文件重命名为 `tophub-cli`, 并删除其他架构的二进制文件。要使用 chmod +x 命令赋予执行权限：
```bash
chmod +x tophub-cli
```
## 前置条件
- 在该技能目录下运行命令：`tophub-cli`，检验是否正确安装并可用。
- 对于以下命令，无需 API key：
- `query-db`
- 对于以下命令，需要提供 API key，必须通过以下方式之一提供：
- 命令:
- `node`
- 提供 API key 的方式（优先级从高到低）：
- `.env` 文件变量：`TOPHUB_APIKEY=...`
- 全局 CLI 参数：`--apikey <KEY>`
## 命令路由
根据用户意图选择命令，有时用户的意图可能需要多条命令：
- 查询节点数据库：
- `tophub-cli query-db [--category <类别>] [--name <名称>] [--id <id>]`
- 列出榜单节点：
- `tophub-cli nodes -p <页码>`
- 导出全部榜单（1~100页）到 JSONL：
- `tophub-cli nodes --dumpall`
- 查询一个或多个节点详情：
- `tophub-cli node <hashid>`
- `tophub-cli node <hashid1,hashid2,...>`
- 查询节点历史：
- `tophub-cli node-historys <hashid> <YYYY-MM-DD>`
- 全网热搜内容：
- `tophub-cli search <关键词> -p <页码> --hashid <可选hashid>`
- 今日热榜榜中榜：
- `tophub-cli hot --date <YYYY-MM-DD>`
- 节点快照列表/详情：
- `tophub-cli snapshots <hashid> [--date <YYYY-MM-DD>] [--details 0|1]`
- 单个快照详情：
- `tophub-cli snapshot <hashid> <ssid>`
- 日历事件：
- `tophub-cli calendar-events [--mode day|week|month] [--date <YYYY-MM-DD>] [--categories <ids|all>]`
- 并发混合请求：
- `tophub-cli batch --p <页码> --hashid <hashid> --date <YYYY-MM-DD> --q <关键词>`
## node 命令特殊说明
- `node` 支持逗号分隔多个 hashid。
- 多 hashid 时并发请求，输出顺序与输入一致。
- 多节点请求时会显示进度条。
## 导出行为
`node` 支持导出，查询时，优先加上 --dump 参数，方便后续用户溯源和数据分析。支持以下导出格式：
- `--dump csv`
- `--dump json`
- `--dump jsonl`
- `--name <filename>
...