- name
- zhihu-hot
- description
- 获取知乎每日热搜榜单，支持搜索、统计、范围分析。数据从 2021-01-08 至今。
知乎热搜
从 zhihu-hot-hub 获取知乎热搜数据。
数据覆盖: 2021-01-08 至今（1900+ 天完整归档，每小时更新）
快速使用
# 今日热搜
./zhihu-hot.py
# 前 10 条
./zhihu-hot.py -n 10
# 紧凑格式
./zhihu-hot.py -c
# 单行格式（适合推送）
./zhihu-hot.py -o
# 搜索热搜
./zhihu-hot.py -s AI命令参数
| 参数 | 简写 | 说明 |
|---|---|---|
DATE | 日期 (YYYY-MM-DD)，默认今天 | |
--limit | -n | 限制显示条数 |
--compact | -c | 紧凑格式输出 |
--oneline | -o | 单行格式（适合推送） |
--json | -j | JSON 格式输出 |
--url | -u | 显示完整 URL |
--search | -s | 搜索关键词 |
--range | -r | 日期范围分析 |
--archives | 显示归档信息 | |
--export | -e | 导出到文件 |
--clear-cache | 清理缓存 | |
--stats | 缓存统计 | |
--no-cache | 不使用缓存 | |
--version | -v | 显示版本 |
输出格式
默认表格格式
📊 知乎热搜 - 2026-03-27
⏰ 更新：2026-03-27 08:17:05 +0800
🔥 热门搜索
┌────┬──────────────────────────────────────────┐
│ 1 │ 你在低谷期学会了什么 │
│ 2 │ 郑钦文不敌萨巴伦卡 │
│ 3 │ C919 还能成批生产吗 │
└────┴──────────────────────────────────────────┘紧凑格式
📊 知乎热搜 2026-03-27 | ⏰ 08:17:05 +0800
1. 你在低谷期学会了什么
2. 郑钦文不敌萨巴伦卡
3. C919 还能成批生产吗单行格式（推送用）
📊 知乎热搜 2026-03-27: 你在低谷期学会了什么 | 郑钦文不敌萨巴伦卡 | C919 还能成批生产吗JSON 格式
{
"date": "2026-03-27",
"update_time": "08:17:05 +0800",
"hot_search": [
{"title": "你在低谷期学会了什么", "url": "...", "decoded_url": "..."}
]
}高级功能
🔍 搜索功能
# 搜索今日热搜
./zhihu-hot.py -s AI
# 搜索并显示 URL
./zhihu-hot.py -s 周杰伦 -u📊 日期范围分析
# 分析本月
./zhihu-hot.py -r 2026-03-01 2026-03-26
# 分析指定周期
./zhihu-hot.py -r 2026-03-01 2026-03-15 --export report.md📚 归档信息
./zhihu-hot.py --archives输出：
📚 归档信息
最早：2021-01-08
最新：2026-03-27
总计：1904 天📁 导出功能
# 导出今日热搜
./zhihu-hot.py -e today.md
# 导出 JSON
./zhihu-hot.py -j -n 50 -e hot50.json
# 导出分析报告
./zhihu-hot.py -r 2026-03-01 2026-03-26 -e march-report.md💾 缓存管理
# 查看缓存统计
./zhihu-hot.py --stats
# 清理缓存
./zhihu-hot.py --clear-cache
# 强制刷新
./zhihu-hot.py --no-cache 2026-03-20📅 历史热搜
./zhihu-hot.py 2026-03-20
./zhihu-hot.py 2026-03-20 -n 10
./zhihu-hot.py 2021-01-08 # 最早数据数据来源
- GitHub: https://github.com/SnailDev/zhihu-hot-hub
- 更新频率: 每小时更新
- 历史数据: 2021-01-08 至今（1900+ 天）
- 实时数据: README.md（当前）
缓存配置
| 类型 | 目录 | 有效期 |
|---|---|---|
| 日数据缓存 | ~/.cache/zhihu-hot/ | 1 小时 |
| 归档列表 | ~/.cache/zhihu-hot/ | 2 小时 |
集成示例
Python 调用
import subprocess
import json
# 获取 JSON 数据
result = subprocess.run(
["./zhihu-hot.py", "--json", "-n", "10"],
capture_output=True, text=True
)
data = json.loads(result.stdout)
print(data["hot_search"])
# 范围分析
result = subprocess.run(
["./zhihu-hot.py", "-r", "2026-03-01", "2026-03-26"],
capture_output=True, text=True
)
print(result.stdout)Shell 脚本
#!/bin/bash
# 每日推送
./zhihu-hot.py -o -n 5 | send-to-telegram
# 周报生成
./zhihu-hot.py -r $(date -d '7 days ago' +%Y-%m-%d) $(date +%Y-%m-%d) -e weekly-report.mdCron 定时任务
# 每日 9 点推送
0 9 * * * /path/to/zhihu-hot.py -o -n 10 --no-cache | mail -s "知乎热搜" user@example.com
# 每周一生成周报
0 10 * * 1 /path/to/zhihu-hot.py -r $(date -d '7 days ago' +%Y-%m-%d) $(date +%Y-%m-%d) -e /reports/weekly-$(date +%%Y%%m%%d).md版本历史
- v3.0 - 新增日期范围分析、归档信息查询、改进缓存管理
- v2.1 - 新增导出功能、缓存统计、彩色输出
- v2.0 - 新增搜索功能、URL 解码、多种输出格式
- v1.0 - 基础功能：获取今日/历史热搜