BestBlogs 添加订阅源 - RSS 批量导入与 OPML 解析工具

BestBlogs 添加订阅源技能

技能概述

BestBlogs 添加订阅源（bestblogs-add-source）是用于向 BestBlogs 平台批量添加 RSS 订阅源的智能技能，支持从文本提取 RSS 链接、解析 OPML 文件批量导入，以及通过 API 串行添加订阅源，帮助用户高效管理和迁移博客订阅。

适用场景

1. 从文本提取 RSS 链接并批量添加

当您收集了大量博客网站的文本内容，需要从中识别并提取 RSS 订阅地址时，该技能可以自动解析文本中的 RSS URL 模式（如 /feed、/rss、/atom、.xml 等路径），去重后批量添加到 BestBlogs，省去手动逐个查找和添加的繁琐过程。

2. 解析 OPML 文件导入订阅源

如果您正在从其他 RSS 阅读器（如 Feedly、Inoreader）迁移到 BestBlogs，该技能可以读取导出的 OPML 文件，提取所有 xmlUrl 属性中的订阅源地址，经过确认后批量导入，实现订阅源的无缝迁移。

3. 通过 BestBlogs Admin API 管理订阅源

该技能集成 BestBlogs 管理员 API，支持添加单个或多个 RSS feed 到 BestBlogs。使用 BESTBLOGS_ADMIN_JWT_TOKEN 和 BESTBLOGS_ADMIN_USER_ID 进行认证后，可以安全地串行添加订阅源，避免系统压力，并获得详细的执行报告。

核心功能

1. 智能解析订阅源

支持多种输入格式的订阅源解析：

纯文本解析：识别包含 /feed、/rss、/atom、.xml 等路径的 RSS URL，自动去重和过滤无效地址

OPML 文件解析：读取标准 OPML XML 结构，提取 <outline> 元素中的 xmlUrl 属性，忽略分类节点

来源名称保留：可选提取 text 或 title 属性作为订阅源名称，便于后续管理

2. 用户确认机制

在执行添加操作前，会展示解析结果清单供用户确认：

#	RSS URL	来源名称（如有）
1	https://example.com/feed	Example Blog
2	https://another.com/rss	-

用户可以移除不需要的条目，确认后才执行添加，确保操作的准确性和可控性。

3. 串行执行与完整错误处理

通过 BestBlogs Admin API 串行执行添加操作，每个请求完成后再发起下一个，避免并发压力。包含完善的错误处理机制：

HTTP 400：请求参数错误，记录错误信息并继续下一个

HTTP 401：认证失败，立即停止并提示检查 BESTBLOGS_ADMIN_JWT_TOKEN

HTTP 403：权限不足，立即停止并提示检查 BESTBLOGS_ADMIN_USER_ID

HTTP 429：频率限制，等待 10 秒后重试一次

HTTP 200 但 success: false：业务错误（如 URL 已存在、格式无效），记录 message 字段并继续

连续失败 10 次：暂停并提示可能是系统性问题，等待用户决定是否继续

常见问题

如何批量添加 RSS 订阅源到 BestBlogs？

您需要准备包含 RSS 链接的文本文件或 OPML 文件，触发技能后选择对应的输入类型。技能会解析并展示订阅源列表，确认后通过 BestBlogs Admin API 串行添加。首次使用需要配置环境变量 BESTBLOGS_ADMIN_JWT_TOKEN 和 BESTBLOGS_ADMIN_USER_ID，这些凭据可以通过 BestBlogs 管理后台获取。

OPML 文件导入 BestBlogs 的步骤是什么？

首先从原 RSS 阅读器导出 OPML 文件（通常在设置或导出选项中），然后触发该技能并选择 OPML 文件输入。技能会解析文件中的所有订阅源地址，展示解析结果供您确认，确认后逐个调用 BestBlogs API 添加。整个过程是串行执行的，每个添加请求都会返回 Source ID，您可以在汇总报告中查看成功和失败的订阅源列表。

订阅源导入失败如何处理？

技能会输出详细的错误汇总报告，列出每个失败订阅源的具体错误原因。如果是认证问题（401/403），请检查环境变量配置是否正确。如果是 URL 格式无效（400/业务错误），请检查原始 RSS 地址是否正确。连续失败 10 次时技能会暂停，可能是系统性问题（如服务不可用或认证失效），请检查 BestBlogs 服务状态和凭据有效期后再决定是否继续。

bestblogs-add-source

作者

分类

安装