{"id":34653805,"url":"https://github.com/xhhcn/ns-rss","last_synced_at":"2026-05-27T10:33:51.167Z","repository":{"id":304398300,"uuid":"1018678074","full_name":"xhhcn/ns-rss","owner":"xhhcn","description":"Nodeseek Monitor based on RSS","archived":false,"fork":false,"pushed_at":"2025-07-23T16:11:46.000Z","size":64,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-23T18:13:58.409Z","etag":null,"topics":["nodeseek","rss","rss-feed"],"latest_commit_sha":null,"homepage":"https://xhhcn.github.io/ns-rss/","language":"Python","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/xhhcn.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}},"created_at":"2025-07-12T19:36:19.000Z","updated_at":"2025-07-23T16:11:49.000Z","dependencies_parsed_at":"2025-07-12T21:39:45.115Z","dependency_job_id":null,"html_url":"https://github.com/xhhcn/ns-rss","commit_stats":null,"previous_names":["xhhcn/ns-rss"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/xhhcn/ns-rss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xhhcn%2Fns-rss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xhhcn%2Fns-rss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xhhcn%2Fns-rss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xhhcn%2Fns-rss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xhhcn","download_url":"https://codeload.github.com/xhhcn/ns-rss/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xhhcn%2Fns-rss/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28005974,"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-12-24T02:00:07.193Z","response_time":83,"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":["nodeseek","rss","rss-feed"],"created_at":"2025-12-24T18:00:03.231Z","updated_at":"2025-12-24T18:00:03.961Z","avatar_url":"https://github.com/xhhcn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NodeSeek RSS 监控工具\n\n\u003cdiv align=\"center\"\u003e\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/xhh1128/ns-rss?style=for-the-badge\u0026logo=docker)](https://hub.docker.com/r/xhh1128/ns-rss)\n[![Docker Image Size](https://img.shields.io/docker/image-size/xhh1128/ns-rss/latest?style=for-the-badge\u0026logo=docker)](https://hub.docker.com/r/xhh1128/ns-rss)\n[![GitHub](https://img.shields.io/github/license/xhhcn/ns-rss?style=for-the-badge)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/xhhcn/ns-rss?style=for-the-badge)](https://github.com/xhhcn/ns-rss/stargazers)\n\n**🚀 高效、智能的 NodeSeek RSS 监控与 Telegram 推送工具**\n\n[快速开始](#-快速开始) • [Docker 部署](#-docker-部署) • [配置说明](##%EF%B8%8F-配置说明)\n\n\u003c/div\u003e\n\n## ✨ 功能特性\n\n- 🔍 **智能筛选**: 支持按类别和关键词筛选 RSS 内容\n- 📱 **多群推送**: 支持同时推送到多个 Telegram 群组/频道\n- 🚀 **Docker 部署**: 完整的 Docker 支持，一键部署\n- ⚡ **实时监控**: 可配置的检查间隔，实时获取最新内容\n- 🎯 **去重机制**: 智能去重，避免重复推送\n- 🗂️ **存储优化**: 自动清理历史记录，防止存储空间无限增长\n\n## 🏷️ 支持的类别\n\n\u003cdiv align=\"center\"\u003e\n\n| 类别 | 标题 | 类别 | 标题 |\n|------|------|------|------|\n| **`daily`** | 🔔 **NodeSeek日常帖子** | **`tech`** | 🔔 **NodeSeek技术帖子** |\n| **`info`** | 🔔 **NodeSeek情报帖子** | **`review`** | 🔔 **NodeSeek测评帖子** |\n| **`trade`** | 🔔 **NodeSeek交易帖子** | **`carpool`** | 🔔 **NodeSeek拼车帖子** |\n| **`dev`** | 🔔 **NodeSeek dev帖子** | **`photo-share`** | 🔔 **NodeSeek贴图帖子** |\n| **`expose`** | 🔔 **NodeSeek曝光帖子** | **`promotion`** | 🔔 **NodeSeek商家信息** |\n\n\u003c/div\u003e\n\n## 🚀 快速开始\n\n[![Deploy on Docker](https://img.shields.io/badge/Deploy%20on-Docker-2496ED?style=for-the-badge\u0026logo=docker\u0026logoColor=white)](https://hub.docker.com/r/xhh1128/ns-rss)\n\n### 1. 获取 Telegram Bot Token\n\n1. 在 Telegram 中找到 [@BotFather](https://t.me/BotFather)\n2. 发送 `/newbot` 创建新机器人\n3. 按提示设置机器人名称和用户名\n4. 获取 Bot Token\n\n### 2. 获取 Chat ID\n\n1. 将机器人添加到目标群组或频道\n2. 发送一条消息 `/start`\n3. 访问 `https://api.telegram.org/bot\u003cYOUR_BOT_TOKEN\u003e/getUpdates`\n4. 在返回的JSON中找到 `chat` → `id`\n\n## 🐳 Docker 部署\n\n### 方式一：Docker Run\n\n```bash\n# 创建数据目录\nmkdir -p ./data\n\n# 运行容器\ndocker run -d \\\n  --name ns-rss \\\n  -e TG_BOT_TOKEN=\"your_bot_token_here\" \\\n  -e TG_CHAT_ID='[\"your_chat_id_here\"]' \\\n  -e CATEGORIES='[\"daily\",\"review\"]' \\\n  -e KEYWORDS='[\"关键词1\",\"关键词2\"]' \\\n  -e WAIT_TIME=5 \\\n  -e CLEANUP_DAYS=7 \\\n  -v ./data:/app/data \\\n  --restart unless-stopped \\\n  xhh1128/ns-rss:latest\n```\n\n### 方式二：Docker Compose\n\n1. 创建 `docker-compose.yml` 文件：\n\n```yaml\nversion: '3.8'\n\nservices:\n  ns-rss:\n    image: xhh1128/ns-rss:latest\n    container_name: ns-rss-monitor\n    environment:\n      # 必填：Telegram Bot Token\n      - TG_BOT_TOKEN=your_bot_token_here\n      # 必填：Telegram Chat ID (JSON数组格式)\n      - TG_CHAT_ID=[\"your_chat_id_here\"]\n      # 可选：RSS 类别筛选 (JSON数组格式)\n      - CATEGORIES=[\"daily\",\"review\"]\n      # 可选：关键词筛选 (JSON数组格式)\n      - KEYWORDS=[\"关键词1\",\"关键词2\"]\n      # 可选：等待时间（秒），默认5秒\n      - WAIT_TIME=5\n      # 可选：历史记录保留天数，默认7天\n      - CLEANUP_DAYS=7\n    volumes:\n      - ./data:/app/data\n    restart: unless-stopped\n```\n\n2. 启动服务：\n\n```bash\ndocker-compose up -d\n```\n\n## ⚙️ 配置说明\n\n\u003cdiv align=\"center\"\u003e\n\n| 环境变量 | 类型 | 必填 | 默认值 | 说明 |\n|----------|------|------|--------|------|\n| **`TG_BOT_TOKEN`** | `String` | ✅ | - | Telegram Bot Token |\n| **`TG_CHAT_ID`** | `JSON Array` | ✅ | - | 聊天ID列表，如 `[\"123\",\"456\"]` |\n| **`CATEGORIES`** | `JSON Array` | ❌ | 全部 | 类别筛选，如 `[\"daily\",\"review\"]` |\n| **`KEYWORDS`** | `JSON Array` | ❌ | 无 | 关键词筛选，如 `[\"关键词1\",\"关键词2\"]` |\n| **`WAIT_TIME`** | `Integer` | ❌ | `5` | 检查间隔（秒） |\n| **`CLEANUP_DAYS`** | `Integer` | ❌ | `7` | 历史记录保留天数 |\n\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📋 配置示例\u003c/summary\u003e\n\n### 基础配置\n```bash\nTG_BOT_TOKEN=\"1234567890:ABCdefGHIjklMNOpqrsTUVwxyz\"\nTG_CHAT_ID=[\"123456789\"]\n```\n\n### 完整配置\n```bash\nTG_BOT_TOKEN=\"1234567890:ABCdefGHIjklMNOpqrsTUVwxyz\"\nTG_CHAT_ID=[\"123456789\", \"987654321\"]\nCATEGORIES=[\"daily\",\"tech\",\"review\"]\nKEYWORDS=[\"VPS\",\"服务器\",\"测评\"]\nWAIT_TIME=10\nCLEANUP_DAYS=14\n```\n\n### 监控特定内容\n```bash\n# 只监控日常和测评帖子\nCATEGORIES=[\"daily\",\"review\"]\n\n# 只推送包含特定关键词的内容\nKEYWORDS=[\"只测不评\",\"性能测试\"]\n\n# 组合使用：监控测评帖子中包含\"VPS\"的内容\nCATEGORIES=[\"review\"]\nKEYWORDS=[\"VPS\"]\n```\n\n\u003c/details\u003e\n\n## 📊 使用统计\n\n- 🐳 **Docker 镜像**: 多平台支持 (linux/amd64, linux/arm64)\n- 💾 **存储优化**: 自动清理历史记录，防止无限增长\n- 🔄 **实时监控**: 可配置检查间隔，实时获取最新内容\n- 📱 **多群推送**: 支持同时推送到多个 Telegram 群组\n\n## 🤝 贡献\n\n欢迎提交 Issue 和 Pull Request！\n\n## 📄 许可证\n\n本项目使用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。\n\n## 🔗 相关链接\n\n- [NodeSeek 官网](https://nodeseek.com)\n- [Docker Hub](https://hub.docker.com/r/xhh1128/ns-rss)\n- [GitHub Repository](https://github.com/xhhcn/ns-rss) ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxhhcn%2Fns-rss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxhhcn%2Fns-rss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxhhcn%2Fns-rss/lists"}