# Start prompts for Viral Radar

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