How sumitkr0843/trend_finder_backend works
Trend Finder gathers social content for a niche, ranks it, and mines it into a content brief; it also supports AI draft generation and review. The API is the principal user-facing workflow, with a separate CLI that saves results and can render an HTML dashboard. Platform collectors normalize results from external services, while ranking and analysis form the core processing layer. Source excerpts support the API/CLI call paths and integrations; unsampled implementation details are not inferred.
Main entry points: api/main.py Search API · main.py CLI workflow · config.py Credentials config · analyzer.py Trend mining
Components 17
Entry points
- Search API
api/main.py - CLI workflow
main.py - Credentials config
config/config.py
Social collection
- Reddit search
scripts/reddit.py - YouTube search
scripts/youtube.py - TikTok search
scripts/tiktok.py - Instagram search
scripts/instagram.py - X search
scripts/x.py
Analysis and ranking
- Engagement ranking
scripts/ranking.py - Trend mining
scripts/analyzer.py
Content and reporting
- Draft generation
scripts/analyzer.py - Draft review
scripts/analyzer.py - HTML dashboard
scripts/render.py
Other components
- User
- Apify actors
- Firecrawl search
- OpenAI service
Connections 34
- User → Search API: submits requests
api/main.py - User → CLI workflow: enters niche
main.py - Search API → Reddit search: dispatches search
api/main.py - Search API → YouTube search: dispatches search
api/main.py - Search API → TikTok search: dispatches search
api/main.py - Search API → Instagram search: dispatches search
api/main.py - Search API → X search: dispatches search
api/main.py - CLI workflow → Reddit search: dispatches search
main.py - CLI workflow → YouTube search: dispatches search
main.py - CLI workflow → TikTok search: dispatches search
main.py - CLI workflow → Instagram search: dispatches search
main.py - Reddit search → Credentials config: reads key
scripts/reddit.py - YouTube search → Credentials config: reads token
scripts/youtube.py - TikTok search → Credentials config: reads token
scripts/tiktok.py - Instagram search → Credentials config: reads token
scripts/instagram.py - X search → Credentials config: reads token
scripts/x.py - Trend mining → Credentials config: reads model settings
scripts/analyzer.py - Reddit search → Firecrawl search: searches web
scripts/reddit.py - YouTube search → Apify actors: runs actor
scripts/youtube.py - TikTok search → Apify actors: runs actor
scripts/tiktok.py - Instagram search → Apify actors: runs actors
scripts/instagram.py - X search → Apify actors: runs actor
scripts/x.py - Search API → Engagement ranking: ranks results
api/main.py - Search API → Trend mining: mines trends
api/main.py - CLI workflow → Engagement ranking: ranks results
main.py - CLI workflow → Trend mining: mines trends
main.py - CLI workflow → HTML dashboard: renders dashboard
main.py - Trend mining → OpenAI service: requests completion
scripts/analyzer.py - Search API → Draft generation: requests draft
api/main.py - Search API → Draft review: requests review
api/main.py - Draft generation → OpenAI service: generates content
scripts/analyzer.py - Draft review → OpenAI service: reviews draft
scripts/analyzer.py - Trend mining → HTML dashboard: writes report data
- CLI workflow → HTML dashboard: provides saved posts
main.py