微信公众号订阅助手
    • WeRSS - 微信公众号订阅助手
    • 认证
      • 获取登录二维码
        GET
      • 获取登录二维码图片
        GET
      • 获取扫描状态
        GET
      • 扫码完成
        GET
      • 用户登录
        POST
      • 获取Token
        POST
      • 用户注销
        POST
      • 刷新Token
        POST
      • 验证Token有效性
        GET
      • 创建 Access Key
        POST
      • 获取 Access Keys 列表
        GET
      • 更新 Access Key
        PUT
      • 删除 Access Key
        DELETE
      • 停用 Access Key
        POST
      • 请求密码重置验证码
        POST
      • 重置密码
        POST
      • 切换微信账号
        POST
    • 用户管理
      • 获取用户信息
        GET
      • 修改用户资料
        PUT
      • 添加用户
        POST
      • 获取用户列表
        GET
      • 更新用户信息
        PUT
      • 修改密码
        PUT
      • 删除用户
        DELETE
      • 上传用户头像
        POST
      • 重置用户密码
        POST
      • 上传文件
        POST
    • 文章管理
      • 清理无效文章(MP_ID不存在于Feeds表中的文章)
      • 清理指定天数前的旧文章
      • 获取文章列表
      • 改变文章阅读状态
      • 获取文章列表
      • 改变文章收藏状态
      • 清理重复文章
      • 刷新单篇文章
      • 获取文章详情
      • 查询文章刷新任务状态
      • 删除文章
      • 获取下一篇文章
      • 获取上一篇文章
    • 公众号管理
      • 搜索公众号
      • 获取公众号列表
      • 添加公众号
      • 更新公众号文章
      • 添加精选文章
      • 获取公众号详情
      • 查询精选文章添加任务状态
      • 删除订阅号
      • 更新订阅号状态
      • 通过文章链接获取公众号详情
    • 配置管理
      • 获取配置项列表
      • 创建配置项
      • 获取单个配置项详情
      • 更新配置项
      • 删除配置项
    • 消息任务
      • 获取消息任务列表
      • 创建消息任务
      • 获取单个消息任务详情
      • 更新消息任务
      • 删除消息任务
      • 测试消息
      • 重载任务
      • 执行单个消息任务详情
    • 系统信息
      • 常规信息
      • 获取系统资源使用情况
      • 获取系统信息
      • 手动刷新文章统计
    • 资源反向代理
      • Reverse Proxy
      • Reverse Proxy
      • Reverse Proxy
      • Reverse Proxy
      • Reverse Proxy
    • 标签管理
      • 获取标签列表
      • 创建新标签
      • 获取单个标签详情
      • 更新标签信息
      • 删除标签
    • 导入
      • 导出
        • 导出公众号列表
        • 导入公众号列表
        • 导出公众号列表为OPML格式
        • 导出标签列表
        • 导入标签列表
    • Rss
      • 获取特定RSS源详情
      • 更新并获取RSS订阅列表
      • 获取RSS订阅列表
      • 获取缓存的文章内容
      • 更新并获取公众号文章RSS
      • 获取公众号文章
    • Feed
      • 获取公众号文章源
      • 获取公众号文章源
      • 获取公众号文章源
    • 工具
      • 导出文章
      • 下载导出文件
      • 获取导出文件列表
      • 删除导出文件
      • 删除导出文件(查询参数)
      • 图片裁剪
      • 下载裁剪后的图片
      • 代理下载远程图片
    • GitHub更新
      • 检查 Git 仓库状态
      • 从 GitHub 更新代码
      • 获取提交历史
      • 回滚到指定提交
      • 获取所有分支
    • 级联管理
      • 创建级联节点
      • 获取节点列表
      • 获取节点详情
      • 更新节点
      • 删除节点
      • 生成节点凭证
      • 测试节点连接
      • 获取父节点公众号数据
      • 获取父节点消息任务
      • 上报任务执行结果
      • 心跳接口
      • 接收父节点通知(子节点使用)
      • 获取同步日志
      • 子节点获取待处理任务(旧接口,建议使用claim-task)
      • 子节点认领任务(原子操作,支持互斥)
      • 更新任务分配状态
      • 子节点上行文章数据到网关
      • 子节点上报任务完成
      • 手动触发任务分发
      • 查看任务分配情况
      • 启动网关定时调度服务
      • 停止网关定时调度服务
      • 重载网关定时调度任务
      • 查看各公众号更新状态
      • 查看待认领的任务数量
    • 环境异常统计
      • 获取环境异常统计
      • 获取今日环境异常统计
    • 过滤规则管理
      • 获取过滤规则列表
      • 创建过滤规则
      • 获取过滤规则详情
      • 更新过滤规则
      • 删除过滤规则
      • 获取公众号的启用规则
    • 任务队列
      • 获取任务队列状态
      • 获取主队列状态
      • 获取内容补抓队列状态
      • 获取任务执行历史
      • 清空任务队列
      • 清空任务历史
      • 获取调度器状态
      • 获取定时任务列表
    • 代理服务
      • Proxy Get Request
      • Proxy Options Request
      • Proxy Post Request
    • 网页预览
      • 首页 - 显示所有标签
      • 文章列表页
      • 文章打印页
      • 文章详情页
      • 标签 - 显示所有标签
      • 标签详情页
      • 公众号 - 显示所有公众号
    • 数据模型
      • Schemas
        • Tags
      • BaseResponse
      • Body_add_featured_article_api_v1_wx_mps_featured_article_post
      • Body_add_mp_api_v1_wx_mps_post
      • Body_crop_image_api_v1_wx_tools_image_crop_post
      • Body_getToken_api_v1_wx_auth_token_post
      • Body_import_mps_api_v1_wx_export_mps_import_post
      • Body_import_tags_api_v1_wx_export_tags_import_post
      • Body_login_api_v1_wx_auth_login_post
      • Body_update_mp_status_api_v1_wx_mps__mp_id__put
      • Body_upload_avatar_api_v1_wx_user_avatar_post
      • Body_upload_file_api_v1_wx_user_upload_post
      • CommitInfo
      • ConfigManagementCreate
      • CreateAKRequest
      • CreateNodeRequest
      • DeleteFileRequest
      • ExportArticlesRequest
      • FilterRuleCreate
      • FilterRuleUpdate
      • HTTPValidationError
      • MessageTaskCreate
      • ReportCompletionRequest
      • ReportResultRequest
      • RequestResetCodeRequest
      • ResetPasswordRequest
      • RollbackRequest
      • StatusResponse
      • TagsCreate
      • TestConnectionRequest
      • UpdateAKRequest
      • UpdateNodeRequest
      • UpdateRequest
      • UpdateResponse
      • UpdateTaskStatusRequest
      • UploadArticlesRequest
      • ValidationError

    WeRSS - 微信公众号订阅助手

    We-MP-RSS Logo

    WeRSS - 微信公众号订阅助手

    Python Version
    License

    快速运行

    docker run -d  --name we-mp-rss  -p 8001:8001   ghcr.io/rachelos/we-mp-rss:latest
    

    http://<您的ip>:8001/ 即可开启

    一个用于订阅和管理微信公众号内容的工具,提供RSS订阅功能。

    功能特性

    • 微信公众号内容抓取和解析
    • RSS订阅生成
    • 用户友好的Web管理界面
    • 定时自动更新内容

    界面截图

    • 登录界面
      登录

    • 主界面
      主界面

    • 添加订阅
      添加订阅

    • 扫码授权
      扫码授权

    系统架构

    项目采用前后端分离架构:

    • 后端:Python + FastAPI
    • 前端:Vue 3 + Vite
    • 数据库:SQLite (默认)/MySQL

    安装指南

    后端服务

    1. 克隆项目
    git clone https://github.com/rachelos/we-mp-rss.git
    cd we-mp-rss
    
    1. 安装Python依赖
    pip install -r requirements.txt
    
    1. 配置数据库
      复制并修改配置文件:
    cp config.example.yaml config.yaml
    
    1. 启动API服务
    uvicorn web:app --host 0.0.0.0 --port 8001 --reload
    

    前端界面

    1. 进入web_ui目录
    cd web_ui
    
    1. 安装Node.js依赖
    npm install
    
    1. 启动开发服务器
    npm run dev
    

    定时任务

    配置定时抓取微信公众号内容:

    python job.py
    

    配置说明

    编辑config.yaml文件配置以下参数:

    • 数据库连接
    • 微信公众号配置
    • 抓取间隔时间
    • API密钥等

    API文档

    API服务启动后,访问以下地址查看文档:

    • Swagger UI: http://localhost:8001/api/docs

    ⚙️ 环境变量

    更多环境变量配置请查看config.example.yaml文件

    变量名说明默认值
    DB必填 数据库地址 例如: mysql+pymysql://<用户名>:<密码>@<数据库IP>/<数据库名>sqlite:///db.db
    INTERVAL抓取间隔时间,单位秒300
    SECRET_KEYJWT授权加密KEY'we-mp-rss'
    DINGDING_WEBHOOK钉钉机器人Webhook地址-
    WECHAT_WEBHOOK微信机器人Webhook地址-
    FEISHU_WEBHOOK飞书机器人Webhook地址-
    MODEL采集方式:web 或 apiweb
    PORTAPI服务端口8001
    DEBUG调试模式False
    MAX_PAGE第一次添加时采集的最大页数5
    RSS_BASE_URLRSS域名地址""
    RSS_LOCAL是否为本地RSS链接True
    TOKEN_EXPIRE_MINUTES登录会话有效时长(分钟)60
    GATHER.CONTENT是否采集内容True
    GATHER.MODEL采集模式(web模式可采集发布链接,api模式可采集临时链接)web
    LOG_FILE日志文件路径(空表示不输出到文件)-
    LOG_LEVEL日志级别(DEBUG, INFO, WARNING, ERROR, CRITICAL)INFO
    USERNAME管理员用户名admin
    PASSWORD管理员密码admin@123

    快速运行

    Docker Sqlite

    docker run -d \
      --name we-mp-rss \
      -p 8001:8001 \
      -e DB=sqlite:///db.db \
      -e USERNAME=admin \
      -e PASSWORD=admin@123 \
      -e DINGDING_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx \
      -v $(pwd)/data:/app/data \
      ghcr.io/rachelos/we-mp-rss:latest
    
    

    Docker Mysql

    docker run -d \
      --name we-mp-rss \
      -p 8001:8001 \
      -e DB=mysql+pymysql://<username>:<password>@<host>/<database> \
      -e USERNAME=admin \
      -e PASSWORD=admin@123 \
      -e DINGDING_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx \
      -v $(pwd)/data:/app/data \
      ghcr.io/rachelos/we-mp-rss:latest
    

    Docker构建及运行

    # 构建
    docker build -t we-mp-rss .
    # Docker运行
    docker run -d --name we-mp-rss -p 8001:8001 we-mp-rss
    

    开发指南

    后端开发

    1. 安装开发依赖
    pip install -r requirements-dev.txt
    
    1. 运行测试
    pytest
    

    前端开发

    1. 修改环境变量
      编辑.env.development文件

    2. 开发模式

    npm run dev
    
    1. 构建生产版本
    npm run build
    

    贡献指南

    欢迎提交Pull Request。在提交前请确保:

    1. 代码通过所有测试
    2. 更新相关文档
    3. 遵循代码风格指南

    ❤️ 赞助

    如果觉得 We-MP-RSS 对你有帮助,欢迎给我来一杯啤酒!

    仓库地址

    • GitHub:https://github.com/rachelos/we-mp-rss
    • Gitee:https://gitee.com/rachel_os/we-mp-rss

    a79cb7ebd1c2665f034f53f4f6013365.jpg

    许可证

    MIT License

    修改于 2026-01-13 08:18:20
    下一页
    获取登录二维码
    Built with