综合介绍
AI RSS是一个创新的工具,通过AI技术将网页内容转换为RSS订阅源。它包含两个主要部分:一个浏览器插件和一个服务器端。浏览器插件允许用户选择网页中的列表并生成结构化数据描述(SDD)文件,而服务器端则读取SDD文件,根据配置抓取网页内容并生成RSS订阅源。该工具支持Chrome和Edge浏览器,并提供两种服务器部署方式:Vercel和Docker。用户需要注册OpenAI、API2D或SillconFlow账号并获取API Key来使用AI分析网页内容。
功能列表
- 浏览器插件:选择网页中的列表并生成SDD文件。
- 服务器端:读取SDD文件并生成RSS订阅源。
- Vercel部署:支持一键部署到Vercel平台。
- Docker部署:提供Docker Compose和直接使用Docker命令两种方式。
- API支持:提供获取RSS Feed、添加SDD配置和获取RSS Feed列表的API接口。
使用帮助
安装浏览器插件
- 准备工作:注册OpenAI、API2D或SillconFlow账号并获取API Key。
- 下载插件:访问Releases页面下载插件包。
- 解压插件包:解压下载的插件包。
- 加载插件:
- Chrome浏览器:打开
chrome://extensions/
页面,点击“加载已解压的扩展程序”,选择解压后的文件夹。 - Edge浏览器:打开
edge://extensions/
页面,点击“加载已解压的扩展程序”,选择解压后的文件夹。
- Chrome浏览器:打开
服务器部署
Vercel部署
- 点击“Deploy with Vercel”按钮:在GitHub页面上点击“Deploy with Vercel”按钮。
- 设置环境变量:
ADD_KEY
:设置添加RSS的API访问密钥。CACHE_MINUTES
:设置缓存时间(分钟)。
- 创建并连接Blob存储:
- 部署完成后进入Vercel项目控制台。
- 转到“Storage”标签页,点击“Create Blob Store”。
- 在项目的storage标签页选择新创建的Blob存储,点击“Connect to Project”。
- 注意事项:如果连接storage后首页依然显示“blobstorageconfigured: false”,请到Vercel控制台中重新部署一次。
Docker部署
- 使用Docker Compose(推荐):
- 创建工作目录并进入:
mkdir -p ai-rss-server && cd ai-rss-server
。 - 下载Docker Compose文件:
wget https://raw.githubusercontent.com/easychen/ai-rss/master/server/docker-compose.yml
。 - 创建
.env
文件并添加环境变量:ADD_KEY=your_api_key
,CACHE_MINUTES=60
。 - 启动Docker Compose:
docker-compose up -d
。
- 创建工作目录并进入:
- 直接使用Docker命令:
- 下载Docker镜像:
docker pull easychen/ai-rss-server:latest
。 - 运行Docker容器:
docker run -d --name ai-rss-server -e ADD_KEY=your_api_key -e CACHE_MINUTES=5 easychen/ai-rss-server:latest
。
- 下载Docker镜像:
使用API
- 获取RSS Feed:
- 接口:
GET /rss/:name
- 参数:
name
(RSS feed的唯一标识符) - 返回:RSS XML内容
- 接口:
- 添加SDD配置:
- 接口:
POST /add-sdd
- Header:
Content-Type: application/json
,X-Add-Key: your_api_key
- 请求体:包含SDD配置的JSON对象
- 返回示例:
{ "success": true, "key": "生成的唯一key", "rss_url": "/rss/unique_key" }
- 接口:
- 获取RSS Feed列表:
- 接口:
GET /list
- 授权:需要通过Header或URL参数提供API密钥
- 返回示例:
{ "success": true, "total": 2, "items": [ { "key": "unique_key1", "title": "Feed标题", "url": "原始网页URL", "rss_url": "RSS feed URL", "favicon": "网站图标URL" } ] }
- 接口: