docs: add parser auth status — 9 zero-config, 2 needs setup

This commit is contained in:
yumoqing 2026-08-04 08:46:26 +08:00
parent eb461bc7e5
commit fce2d78cfc

View File

@ -108,19 +108,28 @@ cd $SAGE_ROOT && python load_path.py
## 内置解析器
| 解析器名 | 平台 | API 端点 | 备注 |
|---------|------|---------|------|
| `weibo_hot` | 微博热搜 | weibo.com/ajax/side/hotSearch | 需 UA 头 |
| `zhihu_hot` | 知乎热榜 | zhihu.com/api/v3/feed/topstory/hot-lists | — |
| `baidu_hot` | 百度热搜 | top.baidu.com/board | — |
| `toutiao_hot` | 头条热榜 | toutiao.com/hot-event/hot-board | 需 Referer |
| `bilibili_hot` | B站热门 | api.bilibili.com/x/web-interface/popular | — |
| `douyin_hot` | 抖音热点 | 第三方聚合接口 | 非官方,可能不稳定 |
| `36kr_hot` | 36氪热榜 | 36kr.com/api/search/list/info-flow/hot | — |
| `github_trending` | GitHub | api.github.com/search/repositories | — |
| `hackernews` | HackerNews | firebaseio.com (两步抓取) | — |
| `v2ex_hot` | V2EX | v2ex.com/api/topics/hot.json | — |
| `rsshub` | RSSHub | 来源 url 即 RSSHub 地址 | 解析 RSS/Atom |
### 零配置即用9个
| 解析器名 | 平台 | 实时热度 | 需要认证 |
|---------|------|:---:|:---:|
| `weibo_hot` | 微博热搜 | ✅ | 无 — 公开接口 |
| `zhihu_hot` | 知乎热榜 | ✅ | 无 |
| `baidu_hot` | 百度热搜 | ✅ | 无 |
| `toutiao_hot` | 头条热榜 | ✅ | 无(需 Referer 头) |
| `bilibili_hot` | B站热门 | ✅ | 无 |
| `36kr_hot` | 36氪热榜 | ✅ | 无 |
| `github_trending` | GitHub Trending | ✅ | 无 — 匿名 60次/hToken 5000次/h |
| `hackernews` | HackerNews | ✅ | 无 |
| `v2ex_hot` | V2EX 热帖 | ✅ | 无 |
### 需要配置2个
| 解析器名 | 平台 | 需要什么 | 怎么获取 |
|---------|------|---------|---------|
| `rsshub` | RSSHub | RSSHub 实例地址 | 自建 `docker run rsshub/rsshub` 或用公共服务 |
| `douyin_hot` | 抖音热点 | ⚠️ 无官方 API | 第三方接口不稳定,建议用浏览器抓取 |
> 添加来源时只需选 `parser=builtin` + `builtin_name=weibo_hot` 即可,无需申请任何 Key。
## 提取器类型
@ -154,5 +163,6 @@ cd $SAGE_ROOT && python load_path.py
## 已知限制
- CSS 提取器为轻量正则实现,复杂页面结构建议使用 `json_path``builtin`
- 抖音解析器使用第三方聚合接口,官方 API 需企业资质
- 抖音(`douyin_hot`)使用第三方聚合接口 `dy.feigua.cn`,非官方数据源,`builtin_name=douyin_hot` 仅作为参考
- 无 Headless Browser 集成(需单独部署 Playwright/Selenium
- GitHub 匿名访问限速 60次/小时,高频使用建议配 Personal Access Token 到 headers