# TrendRadar

> Open-source AI trend monitor with Docker, GitHub Actions and local deployment: aggregate trending news and RSS, then filter, analyze and push concise briefings.

TrendRadar（趋势雷达）：开源 AI 舆情监控与热点聚合工具：支持 Docker、GitHub Actions 与本地运行，聚合全网热搜与 RSS 订阅，AI 智能筛选、分析与翻译，简报直推微信、Telegram、钉钉、飞书等渠道。

- License: GPL-3.0 (free & open source)
- GitHub: https://github.com/sansan0/TrendRadar
- Creator X: https://x.com/heysandev (@heysandev)
- Docker Hub: https://hub.docker.com/r/wantcat/trendradar
- Web config editor: https://sansan0.github.io/TrendRadar/
- Website: https://trendradar.sandev.cc/en/ (English) / https://trendradar.sandev.cc/zh/ (中文)

## Documentation (English)

- [Quick Start: Choose the Right Deployment](https://trendradar.sandev.cc/en/docs/quick-start/): Compare Docker, GitHub Actions and local runs by prerequisites, data location and maintenance. Complete one first run, then continue with sources, filters and schedules.
- [Deploy with GitHub Actions: Serverless Trend Monitoring](https://trendradar.sandev.cc/en/docs/github-actions/): No server needed — create a repository from the template, set Secrets, and GitHub Actions fetches news on schedule, with clear check-in and storage guidance.
- [Docker Deployment: Self-Host with One Command](https://trendradar.sandev.cc/en/docs/docker/): Self-host TrendRadar with Docker and Docker Compose: image setup, environment variables, volumes and scheduled runs. Ideal for NAS, VPS and homelab.
- [Local Deployment: Run with Python](https://trendradar.sandev.cc/en/docs/local/): Run TrendRadar locally with Python on Windows, macOS or Linux: dependency install, configuration files and debugging tips for development.
- [Configure Content & Delivery After Deployment](https://trendradar.sandev.cc/en/docs/next-steps/): After the first successful push, configure sources, keyword filters and delivery, then add storage, AI analysis, channels or web publishing when needed.
- [Cloudflare Pages: Publish GitHub Actions Reports](https://trendradar.sandev.cc/en/docs/cloudflare/): Publish each TrendRadar report generated by GitHub Actions to Cloudflare Pages, with project setup, Secrets, access URLs and custom domain guidance.
- [Platform Configuration: Dozens of Trending Sources](https://trendradar.sandev.cc/en/docs/platforms/): Choose which trending platforms TrendRadar monitors: Weibo, Zhihu, Douyin, Bilibili, Baidu, Toutiao and dozens more, with custom ordering.
- [Self-hosted Sources: Deploy NewsNow or OmniTrends with AI](https://trendradar.sandev.cc/en/docs/self-hosted-sources/): Choose an AI agent or chat-guided prompt to deploy NewsNow or OmniTrends with Cloudflare Free quotas, authorize Wrangler, bind a custom domain if needed and connect TrendRadar.
- [RSS Feed Configuration: Monitor Any Source](https://trendradar.sandev.cc/en/docs/rss/): Add any RSS/Atom feed to TrendRadar: feed URLs, fetch limits, timeout and proxy settings. Bring blogs and media into one monitored stream.
- [Keyword Configuration: Filter News Precisely](https://trendradar.sandev.cc/en/docs/keywords/): Full frequency_words.txt syntax: word groups, required and excluded terms, regex and count limits — push only the news you care about.
- [Push Modes: Daily Digest, Current List or Incremental](https://trendradar.sandev.cc/en/docs/push-modes/): Compare TrendRadar's three push modes — daily digest, current ranking and incremental updates — with behavior differences and configuration.
- [Push Channels: WeChat, Telegram, Slack, Email & More](https://trendradar.sandev.cc/en/docs/push-channels/): Set up TrendRadar notifications for WeCom, WeChat, Feishu, DingTalk, Telegram, Email, ntfy, Bark, Slack and generic webhooks, step by step.
- [Scheduling: Control When Crawls and Pushes Run](https://trendradar.sandev.cc/en/docs/scheduling/): Configure TrendRadar's Timeline scheduler: built-in presets or fully custom schedules for when to crawl, push and run AI analysis each day.
- [AI Analysis Push: Trend Briefings to Your Phone](https://trendradar.sandev.cc/en/docs/ai-analysis/): Let AI analyze trending news and push briefings: works with OpenAI, DeepSeek and more, five analysis sections, push modes and custom prompts.
- [AI Smart Filtering: Pick News with Natural Language](https://trendradar.sandev.cc/en/docs/ai-filter/): Describe your interests in plain language and let AI filter the noise: interest file syntax, model selection and tuning tips for better picks.
- [AI Translation: Multilingual Push Notifications](https://trendradar.sandev.cc/en/docs/ai-translation/): Auto-translate pushed content into your language with AI: provider and model configuration, custom prompts and multilingual output examples.
- [MCP Chat Analysis: Query Trends by Conversation](https://trendradar.sandev.cc/en/docs/mcp/): Connect TrendRadar to Claude and other MCP clients: query trend data, sentiment and patterns in natural language, via Docker or local setup.
- [MCP Query Guide: Effective Prompts and Examples](https://trendradar.sandev.cc/en/docs/mcp-guide/): The complete TrendRadar MCP question handbook: recommended prompts for trend search, keyword stats, comparisons and sentiment analysis.
- [Storage: Local Files or S3-Compatible Cloud](https://trendradar.sandev.cc/en/docs/storage/): TrendRadar storage options: backend auto-selection by deployment, local files or S3-compatible object storage (R2, OSS, MinIO). Your data stays yours.
- [Visual Config Editor: No More Hand-Written YAML](https://trendradar.sandev.cc/en/docs/editor/): Use the official web editor to configure TrendRadar: form-based editing for config.yaml and keyword rules, with validation and one-click export.
- [Architecture: How TrendRadar Works](https://trendradar.sandev.cc/en/docs/architecture/): TrendRadar architecture explained: source aggregation, unified scheduling, keyword and AI filtering, multi-channel push and the MCP service.
- [FAQ: Deployment and Configuration Answers](https://trendradar.sandev.cc/en/docs/faq/): Answers to common TrendRadar questions: deployment errors, push issues, AI setup, crawl frequency and data storage.

## 文档（中文）

- [快速开始：选择适合你的部署方式](https://trendradar.sandev.cc/zh/docs/quick-start/): 对比 Docker、GitHub Actions 与本地运行三种方式，按服务器条件、数据位置和维护成本选择一条路径，先完成首次推送，再继续配置信息源、关键词与调度。
- [GitHub Actions 部署：免服务器定时监控热点](https://trendradar.sandev.cc/zh/docs/github-actions/): 无需自备服务器，使用模板创建独立仓库并配置 Secrets，即可让 GitHub Actions 定时抓取热点并推送到微信、Telegram 等渠道，含签到与存储说明。
- [Docker 部署：一条命令自托管热点监控](https://trendradar.sandev.cc/zh/docs/docker/): 用 Docker 与 Docker Compose 自托管 TrendRadar：镜像拉取、环境变量、数据卷与定时任务配置全流程，适合 NAS、VPS 与内网环境。
- [本地部署：Python 运行与二次开发](https://trendradar.sandev.cc/zh/docs/local/): 在 Windows、macOS 或 Linux 上用 Python 本地运行 TrendRadar：依赖安装、配置文件说明与运行调试技巧，适合开发调试与二次开发。
- [配置内容与推送：部署后的下一步](https://trendradar.sandev.cc/zh/docs/next-steps/): 完成首次部署与推送后，按信息源、关键词筛选和推送模式的顺序继续配置 TrendRadar，并按需添加存储、AI 分析、更多通知渠道与网页报告发布。
- [Cloudflare Pages：发布 GitHub Actions 网页报告](https://trendradar.sandev.cc/zh/docs/cloudflare/): 把 GitHub Actions 每次生成的 TrendRadar 热点报告自动发布到 Cloudflare Pages，包含项目创建、Secrets 配置、访问地址与自定义域名说明。
- [平台配置：接入数十个热榜数据源](https://trendradar.sandev.cc/zh/docs/platforms/): 配置 TrendRadar 监控的热榜平台：微博、知乎、抖音、B 站、百度、今日头条、财联社等数十个平台的开启与自定义方法。
- [自建热点源：用 AI 部署 NewsNow 或 OmniTrends](https://trendradar.sandev.cc/zh/docs/self-hosted-sources/): 按自动操作或聊天指导选择 AI 提示词，使用 Cloudflare Pages 免费额度部署 NewsNow 或更多数据源的 OmniTrends，了解 Wrangler 授权、按需绑定自定义域名与 TrendRadar 接入。
- [RSS 订阅配置：自定义信息源监控](https://trendradar.sandev.cc/zh/docs/rss/): 为 TrendRadar 添加任意 RSS/Atom 订阅源：feed 地址、抓取数量与超时代理设置，把博客、媒体和官方公告纳入统一监控与推送。
- [关键词配置：精准筛选你关心的新闻](https://trendradar.sandev.cc/zh/docs/keywords/): frequency_words.txt 语法详解：词组匹配、必含词、排除词、正则表达式与数量限制，让 TrendRadar 只推送你真正关心的热点新闻。
- [推送模式：每日汇总、当前榜单与增量](https://trendradar.sandev.cc/zh/docs/push-modes/): TrendRadar 三种推送模式对比：daily 每日汇总、current 当前榜单、incremental 增量监控的行为差异、适用人群与配置方法。
- [推送渠道：微信、飞书、钉钉、Telegram 等接入](https://trendradar.sandev.cc/zh/docs/push-channels/): TrendRadar 推送渠道配置指南：企业微信、个人微信、飞书、钉钉、Telegram、邮件、ntfy、Bark、Slack 与通用 Webhook 的接入步骤。
- [调度系统：自定义抓取与推送时间](https://trendradar.sandev.cc/zh/docs/scheduling/): TrendRadar 调度系统（Timeline）配置：内置预设模板与完全自定义时间安排，控制每天什么时间执行抓取、推送与 AI 分析。
- [AI 分析推送：热点简报直达手机](https://trendradar.sandev.cc/zh/docs/ai-analysis/): 让 AI 自动分析热点并推送简报：支持 OpenAI、DeepSeek 等提供商，五大分析板块、推送与分析模式、自定义提示词完整配置。
- [AI 智能筛选：用自然语言挑新闻](https://trendradar.sandev.cc/zh/docs/ai-filter/): 用一段自然语言描述兴趣，让 AI 从海量热点中筛出你关心的新闻：兴趣描述写法、模型选择与筛选效果调优指南。
- [AI 多语言翻译：外文热点自动翻译](https://trendradar.sandev.cc/zh/docs/ai-translation/): 开启 AI 翻译让推送内容自动译为目标语言：翻译提供商与模型配置、提示词自定义与多语言推送效果说明。
- [MCP 对话分析：用 AI 对话查询热点数据](https://trendradar.sandev.cc/zh/docs/mcp/): 把 TrendRadar 接入 Claude 等 MCP 客户端：用自然语言对话完成热点查询、舆情洞察与趋势分析，含 Docker 与本地接入配置。
- [MCP 提问指南：高效对话查询示例](https://trendradar.sandev.cc/zh/docs/mcp-guide/): TrendRadar MCP 完整提问手册：热点检索、关键词统计、趋势对比与舆情分析的推荐问法、工具行为与可调参数。
- [存储配置：本地与 S3 兼容云端自持](https://trendradar.sandev.cc/zh/docs/storage/): TrendRadar 数据存储方案：按部署方式自动选择后端，支持本地文件与 S3 兼容对象存储（R2、OSS、MinIO），数据完全自持。
- [可视化配置编辑器：告别手写 YAML](https://trendradar.sandev.cc/zh/docs/editor/): TrendRadar 官方 Web 配置编辑器使用指南：表单化编辑 config.yaml 与关键词规则，可视化控件完成全部配置并一键导出。
- [系统架构：TrendRadar 工作原理](https://trendradar.sandev.cc/zh/docs/architecture/): TrendRadar 架构解析：数据源聚合、统一调度、关键词与 AI 双层筛选、多渠道推送与 MCP 服务的模块关系与数据流。
- [常见问题：部署与配置疑难解答](https://trendradar.sandev.cc/zh/docs/faq/): TrendRadar 常见问题合集：部署报错、推送不生效、AI 配置、抓取频率与数据存储等高频问题的官方解答。

## Community, Partnerships, Individual Support & Credits

- [Community](https://trendradar.sandev.cc/en/community/): Join the TrendRadar community: GitHub Issues, WeChat official account, and QQ group. Help make TrendRadar better.
- [Corporate Sponsorships & Partnerships](https://trendradar.sandev.cc/en/sponsors/): Corporate sponsorships and partnerships with TrendRadar: GitHub README and website placements for developer tools, cloud services and AI products.
- [Gratitude Radar](https://trendradar.sandev.cc/en/credits/): TrendRadar Gratitude Radar: every real signal helped TrendRadar get here, with thanks to GitHub, Docker Hub, Cloudflare, NewsNow and the community.

## 社区、企业合作、个人支持与致谢

- [社区交流](https://trendradar.sandev.cc/zh/community/): 加入 TrendRadar 社区：GitHub Issues 反馈、关注公众号「硅基茶水间」获取更新、QQ 交流群，一起把 TrendRadar 做得更好。
- [企业赞助与合作](https://trendradar.sandev.cc/zh/sponsors/): TrendRadar 企业赞助与合作：面向开发工具、云服务与 AI 产品提供 GitHub README 和官网展示，触达开发者与自部署用户。
- [致谢雷达](https://trendradar.sandev.cc/zh/credits/): TrendRadar 致谢雷达：记录每一个让 TrendRadar 走到今天的真实信号，并感谢 GitHub、Docker Hub、Cloudflare、NewsNow 等基础设施、数据与社区支持。