Trend Finder is an AI-powered tool designed to help marketing teams and individuals stay ahead of emerging trends on social media and the web. It automates the process of monitoring key influencers and websites, analyzing content for significant developments, and delivering timely notifications via Slack or Discord, thereby saving time and enabling rapid responses to market shifts.

How It Works

The system operates through a three-stage pipeline. First, data collection involves monitoring specified Twitter/X influencers via the X API and new content on websites using Firecrawl's extraction capabilities. This data is gathered on a scheduled basis using cron jobs. Second, the collected content is processed by AI models from Together AI, DeepSeek, or OpenAI to identify emerging trends, product launches, and relevant news, including sentiment analysis. Finally, the Notification System dispatches alerts to Slack or Discord when significant trends are detected, providing context and source information.

Quick Start & Requirements

• Install: Clone the repository, install dependencies with npm install, and configure environment variables by copying .env.example to .env.
• Run: Use npm run start for development or npm run build followed by execution for production. Docker and Docker Compose options are also available.
• Prerequisites: Node.js (v14+), npm/yarn, Docker, Docker Compose.
• API Keys: Required for X API, Firecrawl, and optionally Together AI, DeepSeek, or OpenAI. Notification webhooks for Slack or Discord are also necessary.
• Resources: Monitoring the X API free tier is limited to one account every 15 minutes.

Highlighted Details

• AI-powered trend analysis leveraging Together AI, DeepSeek, or OpenAI.
• Integrated monitoring for Twitter/X influencers and website content via Firecrawl.
• Real-time notifications to Slack or Discord.
• Scheduled monitoring capabilities using cron jobs.

Maintenance & Community

The project is open-source and accepts contributions via pull requests. Further community engagement channels are not explicitly mentioned in the README.

Licensing & Compatibility

The README does not specify a license. Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

The X API free tier has significant rate limits, restricting monitoring to one account every 15 minutes. The project requires multiple API keys and webhook configurations, which may involve costs or setup complexity. The absence of a specified license raises questions about usage rights and commercial viability.