SKILL.md

🔥 每日热榜

🎯 概述

提供 54 个热榜源 的本地化查询服务，基于 DailyHotApi 项目。

核心功能：

📊 热榜查询 - 查询任意平台的热榜数据

📋 分类浏览 - 列出所有支持的热榜源

💾 历史记录 - 自动保存每日热榜数据

⏰ 定时推送 - 自动推送热榜到飞书

🏗️ 架构设计

用户请求 → DailyHotApi Skill → 本地 DailyHotApi 服务 → 返回格式化结果

组件说明

组件

职责

DailyHotApi 服务

独立运行，抓取/聚合热榜数据

DailyHotApi Skill

OpenClaw 插件，处理用户请求

📡 支持的热榜源（54个）

🎬 视频/直播平台

接口

名称

bilibili

哔哩哔哩

acfun

AcFun

douyin

抖音

kuaishou

快手

coolapk

酷安

💬 社交媒体

接口

名称

weibo

微博

zhihu

知乎

zhihu-daily

知乎日报

tieba

百度贴吧

douban-group

豆瓣讨论小组

v2ex

V2EX

ngabbs

NGA

hupu

虎扑

📰 新闻资讯

接口

名称

baidu

百度热搜

thepaper

澎湃新闻

toutiao

今日头条

36kr

36氪

qq-news

腾讯新闻

sina

新浪网

sina-news

新浪新闻

netease-news

网易新闻

huxiu

虎嗅

ifanr

爱范儿

💻 科技/技术社区

接口

名称

ithome

IT之家

ithome-xijiayi

IT之家「喜加一」

sspai

少数派

csdn

CSDN

juejin

稀土掘金

51cto

51CTO

nodeseek

NodeSeek

hellogithub

HelloGitHub

🎮 游戏/ACG

接口

名称

genshin

原神

miyoushe

米游社

honkai

崩坏3

starrail

崩坏：星穹铁道

lol

英雄联盟

📚 阅读/文化

接口

名称

jianshu

简书

guokr

果壳

weread

微信读书

douban-movie

豆瓣电影

🔧 工具/其他

接口

名称

52pojie

吾爱破解

hostloc

全球主机交流

weatheralarm

中央气象台

earthquake

中国地震台

history

历史上的今天

🚀 部署说明

1. PM2 方式管理（推荐）

DailyHotApi 服务使用 PM2 管理，确保稳定运行。

cd /root/.openclaw/workspace/skills/daily-hot-api

# 部署并启动服务

./deploy.sh

# 查看状态

./deploy.sh status

# 重启服务

./deploy.sh restart

# 停止服务

./deploy.sh stop

# 查看日志

./deploy.sh logs

服务地址: http://localhost:6688

2. 配置环境变量

export DAILY_HOT_API_URL=http://localhost:6688

3. 安装 Skill 依赖

cd /root/.openclaw/workspace/skills/daily-hot-news

pip install requests aiohttp

🎮 使用示例

查询热榜

用户: 微博热搜

Skill: 调用 /weibo → 返回 Top 10 热榜

查看所有热榜

用户: 有什么热榜

Skill: 返回 54 个热榜源列表

查询历史热榜

用户: 微博历史

Skill: 显示之前保存的微博热榜记录

查看已保存数据

用户: 已保存了哪些数据

Skill: 返回所有已保存的热榜数据统计

定时推送

用户: 每天早上8点推送B站热门

Skill: 设置 cron 任务 → 每日调用 /bilibili → 推送到飞书

💾 数据存储

存储位置

所有热榜数据保存在：

/root/.openclaw/workspace/skills/daily-hot-news/data/

文件结构

data/

├── weibo/

│   ├── 2026-02-05.json

│   └── 2026-02-04.json

├── zhihu/

│   └── 2026-02-05.json

└── ...

配置项

环境变量

默认值

说明

DAILY_HOT_DATA_DIR

data/

数据存储目录

DAILY_HOT_AUTO_SAVE

true

是否自动保存热榜数据

管理命令

# 查看已保存的数据统计

python3 storage.py

# 清理 30 天前的旧数据

python3 storage.py --clear 30

📊 响应格式

热榜列表响应

{

  "platform": "微博",

  "updateTime": "2026-02-05 17:00:00",

  "data": [

    {

      "rank": 1,

      "title": "热搜标题",

      "hot": "1234万",

      "url": "https://..."

    }

  ]

}

⚙️ 配置项

环境变量

默认值

说明

DAILY_HOT_API_URL

http://localhost:6688

DailyHotApi 服务地址

DAILY_HOT_CACHE_TTL

3600

缓存时间（秒）

DAILY_HOT_MAX_ITEMS

返回最大条数

📊 资源占用

组件

内存

CPU

DailyHotApi 服务

~200MB

极低

DailyHotApi Skill

<10MB

可忽略

总计: <250MB，对服务器无压力

🔧 故障排查

问题: 服务无法连接

# 检查 PM2 状态

./deploy.sh status

# 查看日志

./deploy.sh logs

# 重启服务

./deploy.sh restart

📁 文件结构

daily-hot-news/

├── SKILL.md              # 本说明书

├── daily_hot_news.py     # 核心 Skill 脚本

├── api_client.py         # API 客户端封装

├── formatter.py          # 响应格式化

├── config.py             # 配置管理

├── storage.py            # 数据存储模块

├── data/                 # 热榜数据存储目录

├── README.md             # 快速开始

└── requirements.txt       # 依赖列表

📝 更新日志

v1.1.0 (2026-02-05)

✨ 新增数据存储功能

✨ 支持自动保存每日热榜

✨ 支持查询历史记录

✨ 新增数据统计命令

v1.0.0 (2026-02-05)

初始版本

支持 54 个热榜源

基础查询和定时推送功能

daily-hot-news