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

2. Build the Docker image:

docker build --build-arg N8N_VERSION=1.16.0 --tag=n8n-trend-rating .

3. 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

2. 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