Model or dataset
sansan0/TrendRadar avatar
sansan0/TrendRadar

TrendRadar: Multi-Platform Trend Aggregator with AI Filtering and Push Alerts

AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts. 告别信息过载,你的 AI 舆情监控助手与热点筛选工具!聚合多平台热点 + RSS 订阅,支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机,也支持接入 MCP 架构,赋能 AI 自然语言对话分析、情感洞察与趋势预测等。支持 Docker ,数据本地/云端自持。集成微信/飞书/钉钉/Telegram/邮件/ntfy/bark/slack 等渠道智能推送。.

62,616 stars24,902 forksPythonGPL-3.0

At a glance

What is it?
TrendRadar is a Python-based tool that pulls trending content from multiple platforms, applies AI-powered filtering and analysis, and pushes digests to channels like Telegram, WeChat, Feishu, and email. It is built for individuals and teams who want to monitor public opinion or track hot topics without manually checking each platform.
Who is it for?
TrendRadar fits individuals and teams that need a self-hosted, AI-augmented news digest without building one from scratch. The GPL-3.0 license requires that any distributed modifications be released under the same terms, which matters for teams considering commercial use.
Can I use it commercially?
Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
Is it still maintained?
Yes. The repository last received commits 16 days ago.
What is it written in?
Mainly Python, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 29, 2026, and from our analysis. They are not legal advice.

DEEP OPEN-SOURCE ANALYSIS

What TrendRadar Solves: One Feed Instead of Many Tabs

Monitoring trending topics across multiple platforms means switching between them constantly, which produces noise as much as signal. TrendRadar addresses this by aggregating content from many sources into a single pipeline, applying keyword filters and AI-based relevance scoring, and delivering only the results that match a configured profile. The README describes its goal as lightweight and easy to deploy, and the project targets a reader who wants to stop scrolling through platforms and instead receive a filtered brief.

The tool supports RSS subscriptions alongside platform-specific hot-list sources, so it covers both real-time trending content and structured publication feeds. AI translation is also available, allowing monitoring of sources in one language while receiving summaries in another.

How TrendRadar Collects and Filters Data

TrendRadar fetches trending data from an external API provided by the newsnow project (github.com/ourongxing/newsnow). The README explicitly credits this dependency and asks users to control push frequency to avoid overloading the upstream service. This is a real architectural constraint: the data pipeline depends on a third-party API rather than direct platform scraping, so changes to that API can affect TrendRadar's data availability.

The pyproject.toml lists the key runtime dependencies: litellm 1.82.6 handles the AI model layer and supports multiple LLM providers through a unified interface, feedparser 6.0.12 processes RSS feeds, and json-repair 0.58.6 handles malformed JSON from API responses. Tenacity 0.5.0 adds retry logic. The project requires Python 3.12 or later.

After collection, the AI filtering step scores items against a configured topic profile. The README describes AI smart news filtering as a feature added in version 6.5.0. Items that pass the filter are packaged into a digest, optionally translated, and forwarded to the configured notification channels.

Deploying TrendRadar with Docker

The repository offers several deployment paths. Docker is the recommended route for most users, and the README describes it as a 30-second deployment. The Docker Hub images are published under the wantcat/trendradar and wantcat/trendradar-mcp names. The repository root also contains platform-specific setup scripts: setup-mac.sh for macOS and setup-windows.bat or setup-windows-en.bat for Windows, alongside start-http.sh and start-http.bat for launching the HTTP interface.

The pyproject.toml defines the project entry points:

toml
[project.scripts]
trendradar = "trendradar.__main__:main"
trendradar-mcp = "mcp_server.server:run_server"

The project uses uv as its package manager (uv.lock is in the root), and requires Python 3.12 or later as stated in pyproject.toml. A Cloudflare deployment path is also mentioned in the README navigation, expanding the options beyond local or VPS hosting. Configuration lives in the config/ directory and controls sources, filters, notification channels, and AI provider credentials.

Notification Channels and AI Analysis Push

TrendRadar supports a wide range of push destinations. The README badges list WeChat Work (企业微信), personal WeChat, Telegram, Feishu (Lark), DingTalk, ntfy, Bark, Slack, and email. This breadth is useful for teams distributed across communication tools, but each channel requires its own API credentials and configuration.

The AI analysis push feature (added in version 5.0.0 according to the README navigation) sends AI-generated briefings directly to the configured channels rather than requiring the user to visit a dashboard. Version 5.2.0 added AI multi-language translation, allowing the digest language to differ from the source language. These features depend on a configured LLM provider accessed through litellm, so a valid API key for at least one supported provider is required for AI features to function.

MCP Integration for Conversational Analysis

A separate Docker image (wantcat/trendradar-mcp) exposes TrendRadar as an MCP server. MCP (Model Context Protocol) is a standard that allows AI coding assistants and chat interfaces to call external tools. With this integration, a user can ask questions in natural language inside an MCP-compatible client and have TrendRadar fetch and analyze trending data as part of that conversation.

The pyproject.toml entry point for this mode is:

toml
trendradar-mcp = "mcp_server.server:run_server"

The repository includes README-MCP-FAQ.md and README-MCP-FAQ-EN.md, which document common questions about the MCP setup. The fastmcp 2.12.5 dependency handles the MCP server implementation.

Limitations Worth Knowing Before Deploying

The data pipeline depends on the newsnow API, which is a third-party service that the TrendRadar author does not control. The README explicitly asks users not to overwhelm this upstream source. If the newsnow service changes its API or becomes unavailable, the platform-specific hot-list data will stop flowing until TrendRadar is updated.

AI features require a valid LLM API key and incur API costs. The README mentions the project's own API costs as a reason for a small funding mechanism, which signals that the AI pipeline is not free at scale. The repository has no GitHub releases, so stable version tracking requires watching the repository directly or reading the version file. The current version listed in pyproject.toml is 6.10.0.

For users who want on-premises data with no third-party API dependency, TrendRadar's architecture does not currently support a fully self-contained data source for the platform hot-list feature.

TrendRadar vs. Standard RSS Readers

A conventional RSS reader such as FreshRSS handles feed aggregation and stores articles locally, but it does not apply AI scoring, generate summaries, or push filtered digests to external channels. It is also entirely feed-based and does not pull platform-specific hot lists.

TrendRadar sits in a different position: it is less a reading interface and more a pipeline. It collects, scores, and delivers without requiring the user to open a reader. The trade-off is that TrendRadar depends on an external data API for platform trends and requires an LLM API key for its AI features, whereas a standard RSS reader is self-contained and has no per-query cost. Teams that only need RSS aggregation will find TrendRadar heavier than necessary. Teams that want AI summarization and push delivery across multiple channels will find that a plain RSS reader does not cover those needs.

Editorial conclusion

TrendRadar fits individuals and teams that need a self-hosted, AI-augmented news digest without building one from scratch. The GPL-3.0 license requires that any distributed modifications be released under the same terms, which matters for teams considering commercial use. Before deploying, confirm that the notification channels you need are supported and that you have API access for whichever LLM provider you intend to use for AI filtering.

Frequently asked questions

What is TrendRadar?

TrendRadar is a self-hosted Python tool that aggregates trending content from multiple platforms, applies AI-powered keyword filtering and analysis, and pushes curated digests to notification channels including Telegram, WeChat, Feishu, and email.

Does TrendRadar require an API key for AI features?

Yes. The AI filtering, translation, and analysis features are handled through litellm, which requires credentials for at least one supported LLM provider. Platform hot-list data also depends on the newsnow project API.

What license does TrendRadar use?

TrendRadar is licensed under GPL-3.0. This means that any modifications you distribute must also be released under the same license terms.

Official sources

  1. Official documentation
  2. Official README
  3. Project repository
For maintainers

Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/sansan0-trendradar.svg)](https://hysenlabs.com/projects/sansan0-trendradar)
Community notes

Community notes