WeRSS

WeRSS是什么？

WeRSS（全称 we-mp-rss）是一款开源的微信公众号内容订阅工具，把公众号文章抓取后做成符合标准的 RSS 订阅源。它基于 Python + FastAPI 后端和 Vue 3 前端构建，支持 SQLite 和 MySQL 数据库，适合自部署使用。同时拥有简单的 web 管理页面，支持定时抓取和 webhook/web 接口接入等，帮助用户在微信生态之外高效订阅和管理公众号内容。项目支持 Docker 快速部署，适合开发者、信息聚合者和 RSS 爱好者使用。

WeRSS的主要功能特点 

• 微信公众号内容抓取：自动获取公众号文章内容，提供网页模式和 API 模式两种采集模式。
• RSS 订阅生成：将公众号内容转换成标准 RSS 格式，可全文或摘录输出，支持主流 RSS 通用阅读器。
• Web 管理界面：可直观对前端进行操作，添加/编辑/删除订阅源，查看抓取状态及日志。
• 定时自动更新：支持定时任务，自动抓取并更新订阅内容，无需手动操作。
• Webhook 推送：可将更新内容推送到钉钉、飞书、企业微信等平台，实现消息联动。
• API 接口支持：提供完整的 API 文档（Swagger UI），方便二次开发与系统集成。
• 多数据库支持：默认使用 SQLite，也支持 MySQL，适合不同部署需求。
• Docker 快速部署：提供官方 Docker 镜像与 Compose 配置，开箱即用，部署便捷。
• 过期授权提醒：支持公众号授权状态检测，自动提醒授权过期或失效。
• 多客户端兼容：生成的 RSS 可被 Inoreader、Tiny Tiny RSS、FreshRSS 等客户端订阅使用。

适用群体

• RSS 阅读用户：希望用 RSS 阅读器订阅微信公众号内容；
• 开发者与技术爱好者：需要自部署、定制化抓取和集成的用户；
• 信息聚合平台运营者：用于集中管理和再分发公众号内容；
• 自动化工具用户：希望将公众号更新推送到钉钉、飞书等平台。 

WeRSS的使用方法 

1. 快速部署（推荐 Docker）

docker run -d \
–name we-mp-rss \
-p 8001:8001 \
-e DB=sqlite:///data/db.db \
-e USERNAME=admin \
-e PASSWORD=admin@123 \
-v $(pwd)/data:/app/data \
ghcr.io/rachelos/we-mp-rss:latest

启动后访问：http://localhost:8001

默认账号密码：admin / admin@123

2. 添加公众号订阅

• 登录 Web 管理界面；
• 点击「添加订阅」，填写公众号主页链接；
• 系统自动抓取内容并生成 RSS 链接；
• 可复制链接到任意 RSS 阅读器中使用。

3. 可选功能

• 定时抓取更新：运行 python job.py；
• Webhook 推送：支持钉钉、飞书、企业微信；
• API 文档：访问 http://localhost:8001/api/docs 查看 Swagger UI。

常见问题解答（FAQ）

Q1：WeRSS 是免费的吗？
A1：是的，WeRSS 完全开源，基于 MIT 协议，免费使用。你可以在线部署，也可以本地运行。

Q2：支持哪些部署方式？
A2：推荐使用 Docker 一键部署；也支持源码部署（Python + FastAPI + Vue3）；支持 SQLite（默认）和 MySQL 数据库。

Q3：RSS 链接格式是什么？
A3：系统会为每个公众号生成唯一的 RSS 链接，格式如：http://<你的域名或IP>:8001/rss/<公众号ID>

Q4：支持哪些平台推送？
A4：支持通过 Webhook 将更新内容推送到：钉钉机器人、飞书机器人、企业微信机器人

Q5：是否支持定时抓取？
A5：支持。运行 python job.py 即可启动定时任务，自动抓取公众号更新内容。

Q6：抓取失败或内容为空怎么办？
A6：可能原因包括：

• 公众号设置了访问限制；
• 抓取模式未正确配置（可切换为 web 或 api 模式）；
• 网络代理或 User-Agent 设置不当；
• 可查看日志或调整配置文件 config.yaml 进行排查。

Q7：是否可以自定义 RSS 样式？
A7：支持部分自定义，包括：是否显示全文、是否添加封面图、RSS 标题与描述、分页大小等（通过配置文件设置）。

一句话总结：WeRSS 是一款开源、高效、可自部署的微信公众号 RSS 生成工具，支持自动抓取、Webhook 推送与多平台集成。