全网热门榜单数据源

通过 curl tool 调用多个开源、免费、无需鉴权的热门榜单API，获取全球及国内主流平台的热搜、热门话题、热门内容数据。

鉴权

本数据源涉及的所有 API 完全免费且无需任何鉴权，无需 API Key、Token、Cookie 或登录凭证。直接发送 HTTP GET 请求即可获取数据。

注：以下 API 均经实测验证为可直接访问的公开接口

通用约定

• 无需鉴权：所有接口直接访问，无需传任何认证参数
• 响应格式：JSON（部分接口返回纯文本 Markdown）
• 请求方法：仅使用 GET
• 分页：所有接口都不支持分页，返回固定数量的热门条目（通常 30-50 条）
• 速率限制：无严格限制，但建议相邻请求间隔至少 3 秒，避免频繁请求
• 数据时效：热榜数据实时更新，每次调用获取当前最新热榜

⚠️ 速率限制策略（必须遵守）

1. 串行请求：同一时间只发 1 个 curl 请求，等返回后再发下一个。严禁并行发送多个请求
2. 请求间隔：每两个请求之间至少间隔 3 秒
3. 批量查询：需要查多个平台热榜时，一次只查一个平台，轮询获取
4. 429/503 重试：收到 429 或 503 错误后等待 60 秒再重试，严禁立即重试
5. 数据复用：已获取的热榜结果可以缓存 2-3 分钟，不要频繁重复请求同一平台

平台与类型编码对照表

常用接口

1. UAPI 热榜聚合 - 获取指定平台热榜

免费聚合接口，一键获取 40+ 平台实时热榜，支持热度值、排名、原始链接等完整数据。

GET https://uapis.cn/api/v1/misc/hotboard?type={platform}

参数：

关键返回字段：

示例请求：

curl(url = "https://uapis.cn/api/v1/misc/hotboard?type=weibo", X = "GET")

Curl 调用示例：

curl 'https://uapis.cn/api/v1/misc/hotboard?type=weibo'

2. Hacker News 热门故事 - 获取Top Stories

官方 API，获取全球技术圈热门的 Top Stories（最多 500 条，ids 列表）。

GET https://hacker-news.firebaseio.com/v0/topstories.json

参数：无

关键返回字段：

注意：此接口仅返回 ID 列表，需要进一步调用「获取故事详情」接口获取具体内容。

Curl 调用示例：

curl 'https://hacker-news.firebaseio.com/v0/topstories.json'

3. Hacker News - 获取故事详情

根据故事 ID 获取完整的故事信息（标题、链接、分数、评论数等）。

GET https://hacker-news.firebaseio.com/v0/item/{id}.json

参数：

关键返回字段：

Curl 调用示例：

curl 'https://hacker-news.firebaseio.com/v0/item/42089356.json'

4. Bilibili 综合热门

获取 Bilibili 当前综合热门视频榜单。

GET https://api.bilibili.com/x/web-interface/popular

参数：无

关键返回字段：

Curl 调用示例：

curl 'https://api.bilibili.com/x/web-interface/popular'

5. Hacker News 其他分类榜单

GET https://hacker-news.firebaseio.com/v0/newstories.json     # 最新故事GET https://hacker-news.firebaseio.com/v0/beststories.json   # 最佳故事GET https://hacker-news.firebaseio.com/v0/askstories.json    # Ask HNGET https://hacker-news.firebaseio.com/v0/showstories.json   # Show HNGET https://hacker-news.firebaseio.com/v0/jobstories.json    # 招聘信息

返回格式：与 topstories.json 相同，返回 ID 列表。

6. Jina AI Reader - 网页内容提取

无需鉴权的网页提取 API，可将任意网页转换为干净的 Markdown 格式，适合提取 Hacker News、Lobsters 等社区的内容。

GET https://r.jina.ai/http://{url}GET https://r.jina.ai/http://news.ycombinator.comGET https://r.jina.ai/http://lobste.rs

参数：

关键返回字段：

Curl 调用示例：

curl 'https://r.jina.ai/http://news.ycombinator.com'curl 'https://r.jina.ai/http://lobste.rs'

使用建议：

• 用于获取 Hacker News、Lobsters 等社区的首页内容
• 返回格式为 Markdown，需要 AI 解析提取热门条目
• 可与 HN API 配合使用：先用此获取标题预览，再用 HN API 获取详细数据

调用示例

场景 1：用户询问"今天微博热搜有哪些？"

1. 调用 UAPI 获取微博热榜：

curl 'https://uapis.cn/api/v1/misc/hotboard?type=weibo'

2. 从返回中提取数据：

• 取 list 数组的前 10-20 条
• 从每条提取 title（标题）、hot（热度）、url（链接）

3. 整理输出： 按排名展示微博热搜列表，包含话题名称和热度值。

场景 2：用户询问"全球技术圈今天都在关注什么？"

1. 获取 Hacker News Top Stories ID 列表：

curl 'https://hacker-news.firebaseio.com/v0/topstories.json'

2. 从返回中提取前 5-10 个 ID：

• 返回是一个整数数组，如 [42089356, 42088145, ...]

3. 获取具体故事详情（每次请求间隔 3 秒）：

curl 'https://hacker-news.firebaseio.com/v0/item/42089356.json'curl 'https://hacker-news.firebaseio.com/v0/item/42088145.json'

4. 从详情中提取：

• title - 故事标题
• url - 故事链接
• score - 投票分数
• descendants - 评论数

5. 整理输出： 按热度分数排序展示。

场景 3: 用户询问"Lobsters 社区今天有什么热门内容？"

由于 Lobsters 没有 JSON API，使用 Jina AI Reader 提取：

curl 'https://r.jina.ai/http://lobste.rs'

2. 解析返回的 Markdown：

• 提取首页故事标题和链接
• 整理为结构化列表

场景 4: 获取完整的热门内容列表（覆盖国内外主流平台）

按以下顺序轮询（每个请求间隔 3 秒）：

curl 'https://uapis.cn/api/v1/misc/hotboard?type=weibo'      # 微博（国内）curl 'https://uapis.cn/api/v1/misc/hotboard?type=zhihu'      # 知乎（技术等3秒）curl 'https://uapis.cn/api/v1/misc/hotboard?type=bilibili'   # B站（再等3秒）curl 'https://hacker-news.firebaseio.com/v0/topstories.json' # HN（再等3秒）

然后获取 HN 故事详情（每次请求间隔 3 秒）。

错误处理

特殊处理说明：

Hacker News Story ID 可能为空（null）：

• 如果故事已被删除，/v0/item/{id}.json 可能返回 null
• 解析时需先判断是否为 null，再读取字段

UAPI 部分平台数据缺失：

• 某些平台在特定时间可能没有热榜数据
• 返回码仍为 200，但 list 数组为空
• 在这种情况下告知用户该平台暂无热榜数据

Jina AI Reader 处理限制：

• 部分网站可能有反爬机制，无法成功提取
• 如果返回内容为空或混乱，改用 HN API 获取

输出格式建议

向用户展示热榜数据时，建议按以下格式组织：

1. 分平台展示 - 将不同平台热榜分组
2. 取 Top N - 每个平台只展示热度最高的前 10-20 条
3. 包含热度标识 - 展示热度值或热门标签（爆/热/新/沸）
4. 提供原始链接 - 每个条目附带链接，方便用户点击查看详情
5. 标注时间 - 说明数据获取时间，便于用户判断时效性

注意事项

1. Dev.to API：需要 API Key 获取非公开文章，不在本 Skill 范围内
2. momoyu/pengyou.com：未找到公开可用且无需鉴权的 API 端点，如有更新可后续添加
3. GitHub Trending：暂时没有官方 API，可通过 Jina AI Reader 提取 trending 页面或定期关注开源项目提供的第三方 API