diff --git a/README.md b/README.md index 205f8d7..7a8da5e 100644 --- a/README.md +++ b/README.md @@ -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次/h,Token 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