信源采集 API

多通道采集公开内容：RSS 订阅、资讯站列表页、公开资讯接口。自带按「账号+标题」指纹去重，输出结构化文章池。

POST /v1/sources/fetch v1 免费额度 · 申请制

快速开始

替换 YOUR_KEY 为你申请到的 Key，直接发起首个请求：

# 一次请求采集多个信源
curl -X POST https://skyaibi.com/v1/sources/fetch \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sources": [
        {"id": "tech-media", "name": "科技媒体", "channel": "rss",
         "url": "https://example.com/feed", "account": "tech"},
        {"id": "sports-list", "name": "体育资讯", "channel": "zhibo8",
         "url": "https://news.zhibo8.cc/zuqiu/more.htm", "account": "sports"}
      ], "hours": 48, "limit_per_source": 30, "dedupe": true}'

# 响应
{"ok": true, "count": 14,
 "items": [{"title": "…", "url": "https://…",
            "published": "2026-10-04 18:30",
            "source_id": "tech-media", "fingerprint": "a1b2c3d4e5f60718"}],
 "stats": [{"source_id": "tech-media", "raw": 10, "kept": 6}],
 "errors": []}

示例参数为示意，正式字段与枚举值以 OpenAPI 3.1 规范为准（下方可下载，可直接导入 Apifox / Postman）。

鉴权与调用约束

只覆盖公网可达通道（RSS / 列表页 / 公开接口），需要登录态的通道不在开放范围内
去重指纹 = md5(账号 + 规范化标题) 前 16 位，同一批请求内自动去重；跨请求去重需自行比对 fingerprint
errors 是逐信源隔离的：单个信源失败不影响其它信源，成功部分照常返回，请在业务侧判断 errors 是否为空
限频规则：免费额度内默认 10 次/分钟，超限返回 429；单次请求信源数上限 20
请遵守目标站点的 robots 协议与访问频率限制，建议配合缓存使用

接口清单

方法	路径	说明
POST	/v1/sources/fetch	多通道采集，返回去重后的文章池
GET	/v1/sources/channels	获取支持的通道类型与参数说明
GET	/v1/sources/health	各通道可用性探测（返回最近一次探测结果）

错误码

code	含义	处理建议
40001	无效 API Key	检查 X-API-Key 是否正确、是否已开通
40002	免费额度用尽	升级套餐或联系商务扩容
422	参数缺失/不合法	按错误信息中 field 字段修正请求体
429	触发限频	降低调用频率，参考 Retry-After 响应头
500	服务内部错误	稍后重试，持续失败请联系我们
422	invalid_sources	信源列表为空或超过 20 个

规范与申请

下载 OpenAPI 3.1 规范（JSON）申请 API Key

FAQ

常见问题

支持哪些通道类型？

当前支持三类：rss（标准 RSS/Atom 订阅源）、zhibo8（结构稳定的资讯站列表页）、dongqiudi（App 公开资讯接口）。前两类为通用通道，可对接大多数站点；接口会随通道能力持续增加。

为什么不做登录态平台的内容采集？

出于合规考虑。需要登录才能访问的内容属于平台封闭生态，对外开放采集接口会带来账号安全与平台规则风险。本接口只处理公开可达的内容源。

采集到的内容可以直接用于发布吗？

不建议。本接口定位是帮你发现内容线索，采集结果建议用于选题参考与二次创作，直接搬运会有版权风险。