🧭 Project Overview

Field Detail
Project Name AI Trend Scoring Engine
Type Personal Tool / Portfolio Project
Status βœ… Shipped
Stack n8n Β· Reddit RSS Β· News RSS Β· Claude API / OpenRouter Β· Telegram
Hosted On Oracle Cloud VPS Β· Self-hosted n8n via Docker
Date Built May 2026

🎯 What It Does

An automated daily pipeline that scrapes trending content from Reddit and RSS news, scores each trend using an AI virality engine, and delivers the top 3 picks directly to Telegram β€” without any manual input.

Built as a channel-agnostic tool β€” originally adapted from a channel-specific workflow, refactored to run on pure trend data with no dependency on historical channel analytics.


πŸ”„ Pipeline Architecture

Trigger β†’ Fetch β†’ Score β†’ Deliver. Fully automated, zero manual input after setup.

Step 1: Trigger

⏰ Schedule Trigger fires daily. Kicks off both fetch branches in parallel.

Step 2: Parallel Data Fetch

Source Volume Processing
Reddit Hot 50 posts/run Fetch β†’ Code Extract (XML parse) β†’ Aggregate
News RSS / GNews 30–38 articles/run Fetch β†’ Code Extract β†’ Aggregate

Both branches run simultaneously, then merge into a single payload.

Step 3: Merge & Aggregate

πŸ”€ Merge All Trend Sources combines Reddit + News β†’ Aggregate Trends Objects consolidates into one clean item ready for AI.

Step 4: AI Virality Scoring

πŸ€– AI Virality Scoring Engine (Claude API / OpenRouter)

Scores each trend 0–100 based on: topic relevance, title pattern match, content format alignment, audience interest signals, and risk flags.

Returns structured JSON with viralScore, suggestedTitle, suggestedContentFormat, and reasoning.