trend-rating

Simple n8n node for calculating video trend ratings using a mathematical formula

Package Information

Downloads: 57 weekly / 76 monthly
Latest Version: 1.0.4
Author: alex az

Available Nodes

Trend Rating Calculator
Calculate video trend rating using a simple formula

Documentation

n8n Trend Rating Node

A custom n8n node for calculating video trend ratings with comprehensive validation and API integration capabilities.

Features

  • Trend Rating Calculation: Uses the formula R = 10 + (50/U) - 2C + (30/C) + 0.01*V
  • Comprehensive Validation: Input validation with configurable strict/lenient modes
  • API Integration: Optional external API calls for enhanced calculations
  • English Output: All interpretations and messages in English
  • Configurable Options: Custom weight factors, timestamp inclusion, and validation modes

Installation

Docker Installation

  1. Build your custom node:
npm run build
  1. Build the Docker image:
docker build --build-arg N8N_VERSION=1.16.0 --tag=n8n-trend-rating .
  1. Run the container:
docker run -it --rm --name n8n -p 5678:5678 n8n-trend-rating

Global Installation

If you have n8n installed globally:

  1. Build the node:
npm run build
  1. Copy the dist folder to your n8n custom nodes directory:
cp -r dist/* ~/.n8n/custom/

Node Configuration

Required Parameters

  • User Content: Number of videos you have on this topic (1-10,000)
  • Competition: Number of competitor videos on this topic (1-1,000,000)
  • Views: Average views per video (0-1,000,000,000)

Optional Parameters

  • Use API Integration: Enable external API calls for enhanced calculations
  • Include Timestamp: Add timestamp to output (default: true)
  • Custom Weight Factor: Multiplier for final rating (0.1-10, default: 1)
  • Validation Mode: Strict or lenient validation

API Credentials

When API integration is enabled, configure:

  • API Key: Your API key for the trend rating service
  • API Endpoint: Base URL for the API (default: https://api.trendrating.com)
  • Timeout: Request timeout in milliseconds (default: 10000)

Output Format

{
  "rating": 45.2,
  "interpretation": "✅ Good Performance - Worth Continuing",
  "metrics": {
    "userContent": 5,
    "competition": 100,
    "views": 10000,
    "customWeight": 1
  },
  "timestamp": "2024-01-15T10:30:00.000Z",
  "apiEnhancement": {
    "enhancedScore": 7.3,
    "marketTrend": "upward",
    "confidence": 0.85,
    "recommendations": [
      "Consider increasing content frequency",
      "Focus on trending keywords",
      "Optimize posting schedule"
    ]
  }
}

Rating Interpretations

  • > 150: 🔥 Viral Insane! Huge Potential
  • > 60: 🎯 Great Success - Hot Topic
  • > 40: ✅ Good Performance - Worth Continuing
  • > 20: 📈 Potential Exists - Needs Optimization
  • ≤ 20: ⚠️ Needs Significant Improvement

Development

Build

npm run build

Development Mode

npm run dev

Linting

npm run lint
npm run lintfix

License

MIT

Discussion