douyin-hot-trend

# 抖音热榜

## 技能概述

此技能用于抓取抖音热榜数据，包括：
- 热点标题
- 热度值
- 详情跳转链接
- **封面图（如有）** ✅ 新增
- 热门标签
- 内容类型

## 获取热榜

获取热榜（默认 50 条，按榜单顺序返回）：

```bash
node scripts/douyin.js hot
```

获取热榜前 N 条：

```bash
node scripts/douyin.js hot 10
```

## 输出格式示例

```
🔥 抖音热榜 TOP 5
======================================================================

 1. 国防部正告日方
    🔥 热度: 11,849,702
    🏷️ 标签: 3
    🔗 链接: https://www.douyin.com/search/%E5%9B%BD%E9%98%B2%E9%83%A8%E6%AD%A3%E5%91%8A%E6%97%A5%E6%96%B9

 2. 中国女篮81:68马里女篮
    🔥 热度: 11,776,764
    🏷️ 标签: 1
    🔗 链接: https://www.douyin.com/search/%E4%B8%AD%E5%9B%BD%E5%A5%B3%E7%AF%AE81%3A68%E9%A9%AC%E9%87%8C%E5%A5%B3%E7%AF%AE
```

**注意：** 链接为纯文本 URL，可直接复制使用，无 HTML 标签包装。

## 返回数据字段

| 字段 | 类型 | 说明 |
|------|------|------|
| rank | number | 榜单排名（从 1 开始） |
| title | string | 热点标题 |
| popularity | number | 热度值（HotValue，已转为数字；解析失败时为 0） |
| link | string | 热点详情链接 |
| **cover** | **string \| null** | **封面图 URL（新增）** |
| label | string \| null | 标签/标识 |
| type | string | 内容类型（视频、音乐、挑战赛等） |

## 版本更新日志

### v1.1.0 (2025-02-27)

- ✨ **新增封面图字段**
- ✨ 优化数据输出格式
- ✨ 改进错误处理机制

### v1.0.0

- 初始版本
- 支持基本热榜获取

## 数据来源

抖音网页端公开接口

## 注意事项

- 该接口为网页端公开接口，返回结构可能变动
- 访问频繁可能触发风控
- **封面图：** 并非所有热点都有封面图，部分条目可能为空

# 抖音热榜获取技能

获取抖音热榜/热搜榜数据，包含热门视频、挑战赛、音乐等多领域热门内容，并输出标题、热度值与跳转链接。

## 功能特性

- 🔥 **实时热榜**: 获取抖音最新热门内容
- 📊 **热度值**: 显示每个话题的热度评分
- 🔗 **跳转链接**: 提供详情页直达链接
- 🎯 **自定义数量**: 可指定获取前 N 条数据
- 📱 **多领域内容**: 热门视频、挑战赛、音乐等

## 快速开始

```bash
# 获取抖音热榜前 50 条（默认）
node scripts/douyin.js hot

# 获取前 20 条
node scripts/douyin.js hot 20

# 获取前 10 条
node scripts/douyin.js hot 10
```

## 输出格式

每条热榜包含：
- 📌 **排名**: 热榜排名
- 🔥 **标题**: 热门话题/视频标题
- 📊 **热度值**: 热度评分
- 🔗 **链接**: 详情页跳转链接

## 使用示例

```bash
# 获取热门前 20
node scripts/douyin.js hot 20

# 输出示例：
# 1. 🔥 xxx话题
#    热度：1234567
#    链接：https://www.douyin.com/...
```

## 数据来源

抖音网页端公开接口

## 注意事项

- ⚠️ 该接口为网页端公开接口，返回结构可能变动
- ⚠️ 访问频繁可能触发风控
- ⚠️ 建议合理使用，避免频繁请求

## 使用场景

- 📰 热点追踪
- 📊 内容趋势分析
- 🎯 营销策划参考
- 📱 社交媒体运营

## Author

franklu0819-lang

## License

MIT