# sansan0/trendradar architecture

> Architecture diagram of the GitHub repository sansan0/trendradar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sansan0/trendradar
- Repository: https://github.com/sansan0/trendradar

## Overview

TrendRadar collects trending-news and RSS data, analyzes and filters it, then produces reports and notifications; it also exposes stored data and analytics through an MCP server. The graph preserves the documented AI, RSS, reporting, notification, storage, and MCP capabilities. Edges are limited to relationships visible in the supplied excerpts or SOURCE INDEX; several feature modules were not sampled, so their internal wiring is intentionally omitted.

Main entry points: [`trendradar/__main__.py`](https://github.com/sansan0/trendradar/blob/master/trendradar/__main__.py) (Application entry), [`mcp_server/server.py`](https://github.com/sansan0/trendradar/blob/master/mcp_server/server.py) (MCP server), [`trendradar/ai/filter_pipeline.py`](https://github.com/sansan0/trendradar/blob/master/trendradar/ai/filter_pipeline.py) (Filter workflow), [`mcp_server/services/data_service.py`](https://github.com/sansan0/trendradar/blob/master/mcp_server/services/data_service.py) (Data service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Collection and analysis"]
  node_entry["Application entry<br/>[__main__.py]"]
  node_context["App context<br/>[context.py]"]
  node_crawler["Hotlist crawler<br/>[fetcher.py]"]
  node_rssfetch["RSS fetching<br/>[fetcher.py]"]
  node_rssparse["RSS parsing<br/>[parser.py]"]
  node_analysis["News analysis<br/>[analyzer.py]"]
  node_frequency["Keyword frequency<br/>[frequency.py]"]
  node_ai_analyze["AI analysis<br/>[analyzer.py]"]
  node_ai_filter["AI filtering<br/>[filter.py]"]
  node_filter_pipeline["Filter workflow<br/>[filter_pipeline.py]"]
  node_translator["AI translation<br/>[translator.py]"]
end

subgraph group_delivery["Reports and notifications"]
  node_report["Report generation<br/>[generator.py]"]
  node_html["HTML rendering<br/>[html.py]"]
  node_dispatcher["Notification dispatch<br/>[dispatcher.py]"]
  node_senders["Notification senders<br/>[senders.py]"]
end

subgraph group_persistence["Storage and retrieval"]
  node_storage_manager["Storage manager<br/>[manager.py]"]
  node_local_storage[("Local storage<br/>[local.py]")]
  node_remote_storage[("Remote storage<br/>[remote.py]")]
  node_mcp_remote[("Remote backend<br/>[remote.py]")]
end

subgraph group_mcp["MCP access"]
  node_mcp_server["MCP server<br/>[server.py]"]
  node_mcp_data["Data service<br/>[data_service.py]"]
  node_mcp_parser["Database parser<br/>[parser_service.py]"]
  node_mcp_analytics["Analytics tools<br/>[analytics.py]"]
  node_mcp_query["Query tools<br/>[data_query.py]"]
  node_mcp_search["Search tools<br/>[search_tools.py]"]
  node_mcp_sync["Storage sync<br/>[storage_sync.py]"]
end

node_operator(("User or scheduler"))
node_newsnow{{"Newsnow API"}}

node_operator -->|"runs"| node_entry
node_entry -->|"uses"| node_context
node_entry -->|"imports"| node_analysis
node_entry -->|"imports"| node_filter_pipeline
node_entry -->|"imports"| node_html
node_entry -->|"imports"| node_rssparse
node_context -->|"uses"| node_filter_pipeline
node_filter_pipeline -->|"calls"| node_ai_filter
node_filter_pipeline -->|"uses"| node_frequency
node_rssparse -->|"imports"| node_html
node_storage_manager -->|"selects"| node_local_storage
node_storage_manager -->|"selects"| node_remote_storage
node_mcp_server -->|"dispatches"| node_mcp_query
node_mcp_server -->|"dispatches"| node_mcp_analytics
node_mcp_server -->|"dispatches"| node_mcp_search
node_mcp_server -->|"dispatches"| node_mcp_sync
node_mcp_query -->|"calls"| node_mcp_data
node_mcp_search -->|"calls"| node_mcp_data
node_mcp_analytics -->|"uses"| node_analysis
node_mcp_data -->|"uses"| node_mcp_parser
node_mcp_parser -->|"loads"| node_frequency
node_mcp_sync -->|"uses"| node_mcp_remote
node_newsnow -.->|"provides data"| node_crawler

click node_entry "https://github.com/sansan0/trendradar/blob/master/trendradar/__main__.py"
click node_context "https://github.com/sansan0/trendradar/blob/master/trendradar/context.py"
click node_crawler "https://github.com/sansan0/trendradar/blob/master/trendradar/crawler/fetcher.py"
click node_rssfetch "https://github.com/sansan0/trendradar/blob/master/trendradar/crawler/rss/fetcher.py"
click node_rssparse "https://github.com/sansan0/trendradar/blob/master/trendradar/crawler/rss/parser.py"
click node_analysis "https://github.com/sansan0/trendradar/blob/master/trendradar/core/analyzer.py"
click node_frequency "https://github.com/sansan0/trendradar/blob/master/trendradar/core/frequency.py"
click node_ai_analyze "https://github.com/sansan0/trendradar/blob/master/trendradar/ai/analyzer.py"
click node_ai_filter "https://github.com/sansan0/trendradar/blob/master/trendradar/ai/filter.py"
click node_filter_pipeline "https://github.com/sansan0/trendradar/blob/master/trendradar/ai/filter_pipeline.py"
click node_translator "https://github.com/sansan0/trendradar/blob/master/trendradar/ai/translator.py"
click node_report "https://github.com/sansan0/trendradar/blob/master/trendradar/report/generator.py"
click node_html "https://github.com/sansan0/trendradar/blob/master/trendradar/report/html.py"
click node_dispatcher "https://github.com/sansan0/trendradar/blob/master/trendradar/notification/dispatcher.py"
click node_senders "https://github.com/sansan0/trendradar/blob/master/trendradar/notification/senders.py"
click node_storage_manager "https://github.com/sansan0/trendradar/blob/master/trendradar/storage/manager.py"
click node_local_storage "https://github.com/sansan0/trendradar/blob/master/trendradar/storage/local.py"
click node_remote_storage "https://github.com/sansan0/trendradar/blob/master/trendradar/storage/remote.py"
click node_mcp_server "https://github.com/sansan0/trendradar/blob/master/mcp_server/server.py"
click node_mcp_data "https://github.com/sansan0/trendradar/blob/master/mcp_server/services/data_service.py"
click node_mcp_parser "https://github.com/sansan0/trendradar/blob/master/mcp_server/services/parser_service.py"
click node_mcp_analytics "https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/analytics.py"
click node_mcp_query "https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/data_query.py"
click node_mcp_search "https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/search_tools.py"
click node_mcp_sync "https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/storage_sync.py"
click node_mcp_remote "https://github.com/sansan0/trendradar/blob/master/trendradar/storage/remote.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_context,node_crawler,node_rssfetch,node_rssparse,node_analysis,node_frequency,node_ai_analyze,node_ai_filter,node_filter_pipeline,node_translator toneBlue
class node_report,node_html,node_dispatcher,node_senders toneAmber
class node_storage_manager,node_local_storage,node_remote_storage,node_mcp_remote,node_newsnow toneMint
class node_mcp_server,node_mcp_data,node_mcp_parser,node_mcp_analytics,node_mcp_query,node_mcp_search,node_mcp_sync,node_operator toneRose
```

## Components

### Collection and analysis

- [Application entry](https://github.com/sansan0/trendradar/blob/master/trendradar/__main__.py): `trendradar/__main__.py`
- [App context](https://github.com/sansan0/trendradar/blob/master/trendradar/context.py): `trendradar/context.py`
- [Hotlist crawler](https://github.com/sansan0/trendradar/blob/master/trendradar/crawler/fetcher.py): `trendradar/crawler/fetcher.py`
- [RSS fetching](https://github.com/sansan0/trendradar/blob/master/trendradar/crawler/rss/fetcher.py): `trendradar/crawler/rss/fetcher.py`
- [RSS parsing](https://github.com/sansan0/trendradar/blob/master/trendradar/crawler/rss/parser.py): `trendradar/crawler/rss/parser.py`
- [News analysis](https://github.com/sansan0/trendradar/blob/master/trendradar/core/analyzer.py): `trendradar/core/analyzer.py`
- [Keyword frequency](https://github.com/sansan0/trendradar/blob/master/trendradar/core/frequency.py): `trendradar/core/frequency.py`
- [AI analysis](https://github.com/sansan0/trendradar/blob/master/trendradar/ai/analyzer.py): `trendradar/ai/analyzer.py`
- [AI filtering](https://github.com/sansan0/trendradar/blob/master/trendradar/ai/filter.py): `trendradar/ai/filter.py`
- [Filter workflow](https://github.com/sansan0/trendradar/blob/master/trendradar/ai/filter_pipeline.py): `trendradar/ai/filter_pipeline.py`
- [AI translation](https://github.com/sansan0/trendradar/blob/master/trendradar/ai/translator.py): `trendradar/ai/translator.py`

### Reports and notifications

- [Report generation](https://github.com/sansan0/trendradar/blob/master/trendradar/report/generator.py): `trendradar/report/generator.py`
- [HTML rendering](https://github.com/sansan0/trendradar/blob/master/trendradar/report/html.py): `trendradar/report/html.py`
- [Notification dispatch](https://github.com/sansan0/trendradar/blob/master/trendradar/notification/dispatcher.py): `trendradar/notification/dispatcher.py`
- [Notification senders](https://github.com/sansan0/trendradar/blob/master/trendradar/notification/senders.py): `trendradar/notification/senders.py`

### Storage and retrieval

- [Storage manager](https://github.com/sansan0/trendradar/blob/master/trendradar/storage/manager.py): `trendradar/storage/manager.py`
- [Local storage](https://github.com/sansan0/trendradar/blob/master/trendradar/storage/local.py): `trendradar/storage/local.py`
- [Remote storage](https://github.com/sansan0/trendradar/blob/master/trendradar/storage/remote.py): `trendradar/storage/remote.py`
- [Remote backend](https://github.com/sansan0/trendradar/blob/master/trendradar/storage/remote.py): `trendradar/storage/remote.py`

### MCP access

- [MCP server](https://github.com/sansan0/trendradar/blob/master/mcp_server/server.py): `mcp_server/server.py`
- [Data service](https://github.com/sansan0/trendradar/blob/master/mcp_server/services/data_service.py): `mcp_server/services/data_service.py`
- [Database parser](https://github.com/sansan0/trendradar/blob/master/mcp_server/services/parser_service.py): `mcp_server/services/parser_service.py`
- [Analytics tools](https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/analytics.py): `mcp_server/tools/analytics.py`
- [Query tools](https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/data_query.py): `mcp_server/tools/data_query.py`
- [Search tools](https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/search_tools.py): `mcp_server/tools/search_tools.py`
- [Storage sync](https://github.com/sansan0/trendradar/blob/master/mcp_server/tools/storage_sync.py): `mcp_server/tools/storage_sync.py`

### Other components

- **User or scheduler**
- **Newsnow API**

## Connections

- User or scheduler → Application entry: runs (evidence: `trendradar/__main__.py`)
- Application entry → App context: uses (evidence: `trendradar/__main__.py`)
- Application entry → News analysis: imports (evidence: `trendradar/__main__.py`)
- Application entry → Filter workflow: imports (evidence: `trendradar/__main__.py`)
- Application entry → HTML rendering: imports (evidence: `trendradar/__main__.py`)
- Application entry → RSS parsing: imports (evidence: `trendradar/__main__.py`)
- App context → Filter workflow: uses (evidence: `trendradar/context.py`)
- Filter workflow → AI filtering: calls (evidence: `trendradar/ai/filter_pipeline.py`)
- Filter workflow → Keyword frequency: uses (evidence: `trendradar/ai/filter_pipeline.py`)
- RSS parsing → HTML rendering: imports (evidence: `trendradar/crawler/rss/parser.py`)
- Storage manager → Local storage: selects (evidence: `trendradar/storage/manager.py`)
- Storage manager → Remote storage: selects (evidence: `trendradar/storage/manager.py`)
- MCP server → Query tools: dispatches (evidence: `mcp_server/server.py`)
- MCP server → Analytics tools: dispatches (evidence: `mcp_server/server.py`)
- MCP server → Search tools: dispatches (evidence: `mcp_server/server.py`)
- MCP server → Storage sync: dispatches (evidence: `mcp_server/server.py`)
- Query tools → Data service: calls (evidence: `mcp_server/tools/data_query.py`)
- Search tools → Data service: calls (evidence: `mcp_server/tools/search_tools.py`)
- Analytics tools → News analysis: uses (evidence: `mcp_server/tools/analytics.py`)
- Data service → Database parser: uses (evidence: `mcp_server/services/data_service.py`)
- Database parser → Keyword frequency: loads (evidence: `mcp_server/services/parser_service.py`)
- Storage sync → Remote backend: uses (evidence: `mcp_server/tools/storage_sync.py`)
- Newsnow API → Hotlist crawler: provides data (evidence: `README.md`)
