Most content is made by guessing. What is working this week in your topic is public, but it sits on four networks that each rank it their own way, and nobody checks them every day.
YouTube works with nothing to set up. Ask your AI what is going viral for a topic and it answers in seconds.
TikTok, Instagram and X are read through a data service with your own key. Its free plan includes 5 dollars of use a month, with no card.
Group the topics you care about and schedule one read a day. Ask what is hot and what is new since yesterday.
One question, four networks: recent posts from YouTube, TikTok, Instagram and X ranked together on one 0 to 100 score.
The outlier first: views against the size of the account, so a post that beats its own account stands out.
Monitoring: your groups of topics read on a daily schedule, and one plain line per group on what is hot, what is new and what is rising.
Each post comes with its hook, link, views, likes, length and author, so you start from a format that is already working.
Copy cards: the proof, the hook and the format of the top posts, with room for your own version and your test.
Your costs in your hands: your own data service key, a monthly ceiling you set, a cache, and every answer and run says what it cost.
It runs on your own computer as a tool for your AI, with an install guide and ready start prompts.
TikTok, Instagram and X need your own key of the data service Apify. Its free 5 dollars cover about 35 to 40 questions a month, or one topic watched daily plus about 15 questions.
On a free plan of that service Instagram returns one page per hashtag (about 8 posts), and some Instagram posts hide their views.
It shows what performs now. It cannot promise that your version will perform the same.
Two prompts to paste into your AI. The first one once, to set it up. The second one whenever you work with it (or keep
it in your AI's project instructions).
1. Setup (once)
Install and set up Viral Radar for me. The folder is <full path of the viral-radar folder>. Follow its INSTALL.md step by step and run the steps yourself: 1. Check Python 3.10 or newer, install requirements.txt, run "python viral_radar.py selftest". 2. Create ~/.viral-radar/.env with the three lines of INSTALL.md step 5, keeping the placeholders. Do NOT ask me for my keys and never put a key in this chat: tell me which file to open and which placeholder to replace, and wait until I say it is done. If I do not want TikTok, Instagram and X yet, leave the data service line out. 3. Tell me in two lines how to get my own free Apify key (apify.com, free plan with 5 dollars of use a month, no card; Console, Settings, API & Integrations, Personal API token). 4. Connect server.py to this app with its full path and tell me when to restart the app. 5. After the restart call sources_status and show me what it says, then find_viral with a topic I give you, and show me the top 5 posts across networks (network, hook, views, account size, link) and each network's status line and cost. 6. Ask me for 1 to 3 topics to watch, add them with watch_add to one group, run run_group once, and show me whats_hot. Then show me the monitoring table of INSTALL.md with what my plan would cost a month, and set up the daily run for my system (Task Scheduler on Windows, cron on macOS and Linux) once I agree to a plan.
2. Daily use
You have Viral Radar (an MCP server). What it is for: finding what is going viral right now for a topic on YouTube, TikTok, Instagram and X, and watching my topics so you can tell me what is hot, new and rising. When to call what: - "What is hot / what changed / anything new?" about my watched topics: whats_hot (one group or all). It costs nothing. Start your answer with its one line per group, then the best 3 new or rising posts with hook, network, numbers and link. - A topic I am not watching, or "what is viral on X for <topic>": find_viral(topic). Say what it cost (cost_usd). - "Watch this topic": watch_add(group, topic), then run_group(group) once so there is a first read. - "Read it again now": run_group(group), then whats_hot(group). - "Give me the ones to copy": copy_cards(group), then show me the cards of the top 3. - Which networks are on, my month's use, my groups: sources_status. The right order for a new topic: watch_add, run_group, whats_hot. For a daily check: whats_hot only (the daily run reads the networks; you do not need to read them again unless I ask). Never: - invent a trend, a number or a post. If whats_hot says "nothing new or rising", say exactly that. - ask me to paste a key into the chat, or print a key. - raise my monthly ceiling (VIRAL_RADAR_PAID_MONTHLY_USD), add many topics, or call run_group or find_viral again and again without telling me first what it will cost: TikTok, Instagram and X are billed to my own data service account. - present a post marked "ad": true as organic, or a score without its numbers. - promise that copying a post will make mine go viral: these are the posts to learn from, not a guarantee.
Viral Radar
See what is going viral now on YouTube, TikTok, Instagram and X for your topics, ranked on one score.