{"id":31424836,"url":"https://github.com/chemark/rssos","last_synced_at":"2026-04-19T04:37:43.011Z","repository":{"id":316725118,"uuid":"1064590552","full_name":"chemark/rssos","owner":"chemark","description":"🚀 Universal RSS Generator - Generate RSS feeds from any website without native RSS support. Convert blogs, portfolios, news sites into subscribable feeds.","archived":false,"fork":false,"pushed_at":"2025-09-26T11:18:43.000Z","size":97,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-26T11:18:52.480Z","etag":null,"topics":["api","feed-generator","nodejs","rss","universal","vercel","web-scraping"],"latest_commit_sha":null,"homepage":"https://rssos.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chemark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-26T09:01:47.000Z","updated_at":"2025-09-26T11:18:46.000Z","dependencies_parsed_at":"2025-09-26T11:18:54.383Z","dependency_job_id":"da859018-800f-4b0b-9328-746568bb474e","html_url":"https://github.com/chemark/rssos","commit_stats":null,"previous_names":["chemark/rssos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/chemark/rssos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chemark%2Frssos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chemark%2Frssos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chemark%2Frssos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chemark%2Frssos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chemark","download_url":"https://codeload.github.com/chemark/rssos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chemark%2Frssos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277627364,"owners_count":25849853,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-30T02:00:09.208Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","feed-generator","nodejs","rss","universal","vercel","web-scraping"],"created_at":"2025-09-30T04:06:15.691Z","updated_at":"2025-09-30T04:06:18.467Z","avatar_url":"https://github.com/chemark.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RSSOS - 通用RSS生成器\n\n🚀 将任何网站转换为RSS订阅源的智能工具\n\n## 🌟 特性\n\n- **🎯 智能识别**：自动识别博客、新闻、作品集、电商等不同类型网站结构\n- **⚡ 高效缓存**：智能缓存机制，快速响应，减少重复抓取\n- **🔄 实时更新**：定期更新RSS内容，确保订阅源保持最新状态\n- **🌐 多平台支持**：支持WordPress、Medium、GitHub、Figma等各种平台\n- **📱 响应式设计**：完美适配桌面和移动设备\n- **🔧 简单易用**：只需输入URL即可生成RSS订阅链接\n\n## 🛠️ 技术栈\n\n- **后端**：Node.js + Vercel Serverless Functions\n- **解析**：Cheerio + 智能内容检测\n- **缓存**：LRU Cache + 多层缓存策略\n- **前端**：原生JavaScript + 现代CSS\n- **部署**：Vercel\n\n## 🚀 快速开始\n\n### 在线使用\n\n访问 [https://rssos.vercel.app](https://rssos.vercel.app)\n\n1. 输入任何网站的URL\n2. 点击\"生成RSS\"\n3. 复制生成的RSS订阅链接\n4. 添加到你的RSS阅读器中\n\n### 本地部署\n\n```bash\n# 克隆项目\ngit clone https://github.com/chemark/rssos.git\ncd rssos\n\n# 安装依赖\nnpm install\n\n# 本地开发\nnpm run dev\n\n# 访问 http://localhost:3000\n```\n\n### Vercel部署\n\n1. Fork此项目\n2. 在Vercel中导入项目\n3. 一键部署完成\n\n## 📖 API使用\n\n### 生成RSS Feed\n\n```\nGET /api/generate?url=https://example.com\n```\n\n**参数：**\n- `url` (必需)：要生成RSS的网站URL\n- `refresh` (可选)：设置为`1`强制刷新缓存\n\n**响应：**\n- `Content-Type: application/rss+xml; charset=utf-8`\n- 标准RSS 2.0 XML格式\n\n**示例：**\n\n```bash\ncurl \"https://rssos.vercel.app/api/generate?url=https://jasonspielman.com\"\n```\n\n## 🎯 支持的网站类型\n\n### 1. 作品集网站 (Portfolio)\n- **检测特征**：portfolio、work、project、case-study、design关键词\n- **适用于**：设计师作品集、开发者项目展示\n- **示例**：https://jasonspielman.com\n\n### 2. 博客网站 (Blog)\n- **检测特征**：WordPress、Blogger特征，文章结构\n- **适用于**：个人博客、技术博客\n- **示例**：WordPress、Ghost、Medium博客\n\n### 3. 新闻网站 (News)\n- **检测特征**：article meta标签、新闻结构\n- **适用于**：新闻网站、媒体平台\n- **示例**：新闻门户、科技媒体\n\n### 4. 代码仓库 (Repository)\n- **检测特征**：GitHub域名、仓库结构\n- **适用于**：开源项目、代码仓库\n- **示例**：GitHub项目页面\n\n### 5. 电商网站 (E-commerce)\n- **检测特征**：产品列表、价格信息\n- **适用于**：在线商店、产品展示\n- **示例**：商品更新、新品发布\n\n## 🔧 配置选项\n\n### 缓存设置\n- **RSS内容缓存**：30分钟\n- **网站信息缓存**：1小时\n- **HTML内容缓存**：15分钟\n- **错误缓存**：1小时\n\n### 请求限制\n- **超时时间**：15秒\n- **重定向次数**：最多5次\n- **用户代理**：Mozilla/5.0 (compatible; RSSOS/1.0)\n\n## 📝 使用示例\n\n### 基本用法\n\n```javascript\n// 生成RSS\nconst rssUrl = 'https://rssos.vercel.app/api/generate?url=https://example.com';\n\n// 在RSS阅读器中添加订阅\n// Feedly、Inoreader、NetNewsWire等都支持\n```\n\n### 高级用法\n\n```javascript\n// 强制刷新缓存\nconst rssUrl = 'https://rssos.vercel.app/api/generate?url=https://example.com\u0026refresh=1';\n\n// 检查RSS状态\nfetch(rssUrl, { method: 'HEAD' })\n  .then(response =\u003e {\n    console.log('Site Type:', response.headers.get('X-Site-Type'));\n    console.log('Articles Found:', response.headers.get('X-Articles-Found'));\n    console.log('Cache Status:', response.headers.get('X-Cache'));\n  });\n```\n\n## 🚀 最新改进\n\n### v1.1.0 - 2024.09.25\n\n✨ **新增功能**\n- 添加了现代化的Web前端界面\n- 支持点击示例快速生成RSS\n- 添加了复制链接和下载RSS功能\n- 增加了实时错误提示和重试机制\n\n🔧 **技术优化**\n- 修复LRU Cache废弃API警告\n- 改进了阿里一峰博客的解析算法\n- 优化了Figma网站的内容提取\n- 增强了缓存机制和错误处理\n\n🎨 **用户体验**\n- 响应式设计，完美支持移动设备\n- 优雅的动画效果和交互反馈\n- 深色模式适配（自动检测）\n- 多语言Toast通知系统\n\n## 🎨 特色功能\n\n### 智能内容提取\n- 自动识别文章标题、链接、摘要\n- 智能提取发布时间和作者信息\n- 支持图片和富文本内容\n\n### Figma网站支持\n特别优化了对Figma构建的网站的支持：\n- 解析JSON数据结构\n- 提取交互链接和项目信息\n- 生成完整的项目描述\n\n### 缓存策略\n- 多层缓存设计\n- 智能缓存失效\n- 错误状态缓存，避免重复请求失败的网站\n\n## 🔍 故障排除\n\n### 常见问题\n\n1. **无法生成RSS**\n   - 检查网站URL是否正确\n   - 确认网站可以正常访问\n   - 尝试强制刷新缓存\n\n2. **内容不完整**\n   - 网站可能使用JavaScript动态加载\n   - 某些网站有反爬虫机制\n   - 联系开发者添加特定支持\n\n3. **更新不及时**\n   - RSS有30分钟缓存\n   - 可以使用refresh参数强制更新\n\n### 错误代码\n\n- `400`：URL参数缺失或格式错误\n- `405`：HTTP方法不支持\n- `500`：服务器内部错误或网站无法解析\n\n## 🤝 贡献\n\n欢迎贡献代码！请遵循以下步骤：\n\n1. Fork项目\n2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 打开Pull Request\n\n### 开发环境设置\n\n```bash\n# 克隆项目\ngit clone https://github.com/chemark/rssos.git\ncd rssos\n\n# 安装依赖\nnpm install\n\n# 运行测试\nnpm test\n\n# 启动开发服务器\nnpm run dev\n```\n\n## 📄 许可证\n\n本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情\n\n## 🙏 致谢\n\n- [Cheerio](https://cheerio.js.org/) - 服务器端jQuery实现\n- [Vercel](https://vercel.com/) - 无服务器部署平台\n- [LRU Cache](https://github.com/isaacs/node-lru-cache) - 高效缓存实现\n\n## 📞 联系方式\n\n- 项目主页：https://github.com/chemark/rssos\n- 问题反馈：https://github.com/chemark/rssos/issues\n- 在线体验：https://rssos.vercel.app\n\n## 🎯 路线图\n\n- [ ] 添加更多网站类型支持\n- [ ] 实现Webhook推送功能\n- [ ] 添加RSS订阅管理面板\n- [ ] 支持自定义RSS模板\n- [ ] 添加API密钥认证\n- [ ] 实现批量RSS生成\n\n---\n\n**让RSS订阅更简单！** 🚀","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchemark%2Frssos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchemark%2Frssos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchemark%2Frssos/lists"}