# TrendWatch > ๐Ÿ“ˆ Free trend-monitoring & breakout alerts that run in your own GitHub repo. Watch Google, TikTok, YouTube, Reddit & Amazon - get pinged on Slack/Discord/Telegram/email when a keyword spikes. No server, no scraping. Powered by Trends MCP. - **Type:** MCP server - **Install:** `agentstack add mcp-trendsmcp-ai-trendwatch` - **Verified:** Yes โ€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [trendsmcp-ai](https://agentstack.voostack.com/s/trendsmcp-ai) - **Installs:** 0 - **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [trendsmcp-ai](https://github.com/trendsmcp-ai) - **Source:** https://github.com/trendsmcp-ai/TrendWatch - **Website:** https://www.trendsmcp.ai ## Install ```sh agentstack add mcp-trendsmcp-ai-trendwatch ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # ๐Ÿ“ˆ TrendWatch ### Get pinged the moment a topic starts blowing up - Google, TikTok, YouTube, Reddit, Amazon & more. **Free. Runs in your own GitHub repo. No server, no scraping, no API keys to juggle.** Fork it โ†’ add one free key โ†’ pick your keywords โ†’ GitHub Actions watches the trends and DMs you when something breaks out. [](https://github.com/trendsmcp/TrendWatch/generate) [](https://trendsmcp.ai) [](https://github.com/trendsmcp/TrendWatch/stargazers) **Alerts to:** [](#-notification-channels) [](#-notification-channels) [](#-notification-channels) [](#-notification-channels) [](#-notification-channels) **Data by** [](https://www.trendsmcp.ai) ยท works with any MCP client (Claude, Cursorโ€ฆ) --- ### ๐Ÿ“Š Live trends - updated 2026-07-26 14:36 UTC _All quiet - no watchlist breakouts in the latest run._ Auto-updated by TrendWatch ยท powered by [Trends MCP](https://www.trendsmcp.ai) --- ## Why TrendWatch? You want to know **when** "your brand", a competitor, or a whole category starts trending - *before* everyone else does. The usual options are bad: - ๐Ÿงฑ **Building a scraper** โ†’ breaks every time Google changes its HTML, needs a server, gets you rate-limited/blocked. - ๐Ÿ’ธ **Enterprise trend tools** โ†’ $100s/month, overkill, locked behind sales calls. - ๐Ÿ‘€ **Checking Google Trends by hand** โ†’ you forget, you miss the spike, you're late. **TrendWatch** is the lazy, reliable middle path: a tiny open-source job that runs on GitHub's free Actions runners, calls the [Trends MCP](https://www.trendsmcp.ai) API for clean normalized data, and pings you in Slack / Discord / Telegram / email the instant something moves. ``` your keywords Trends MCP API you, notified โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ "your brand" โ”‚ โ”‚ Google ยท TikTok ยท โ”‚ โ”‚ ๐Ÿ“ˆ Slack โ”‚ โ”‚ "competitor" โ”‚โ”€โ”€โ–ถโ”‚ YouTube ยท Reddit ยท โ”‚โ”€โ”€โ–ถโ”‚ ๐Ÿ’ฌ Discord โ”‚ โ”‚ "labubu" โ”‚ โ”‚ Amazon ยท Wikipediaโ€ฆ โ”‚ โ”‚ โœˆ๏ธ Telegram โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โœ‰๏ธ Email / Webhookโ”‚ config.yml (1 clean API call) โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ–ฒ GitHub Actions runs this on a schedule - for free. ``` --- ## โšก 60-second setup 1. **[Click "Use this template"](https://github.com/trendsmcp/TrendWatch/generate)** โ†’ create your own copy of this repo. 2. **[Grab a free API key](https://trendsmcp.ai)** (100 requests/month, no credit card). 3. In *your* repo: **Settings โ†’ Secrets and variables โ†’ Actions โ†’ New repository secret** - Name: `TRENDS_API_KEY` ยท Value: *(your key)* 4. **Edit [`config.yml`](config.yml)** - add the keywords you care about. 5. Go to the **Actions** tab, enable workflows, and hit **Run workflow** to test it. That's it. It now runs on a schedule and alerts you. ๐ŸŽ‰ > **Want desktop/phone alerts?** Add any of `SLACK_WEBHOOK_URL`, `DISCORD_WEBHOOK_URL`, `TELEGRAM_BOT_TOKEN` + `TELEGRAM_CHAT_ID`, or SMTP secrets. With none set, it still logs to the Actions console and updates your README dashboard. --- ## ๐ŸŽฏ What it detects **Watchlist breakouts** - your keywords, measured for momentum. > ๐Ÿš€ **labubu** is breaking out on google search: **+212%** over 7D (1M +140%, 3M +320%) Breakouts land in your alert channels, get written to [`reports/`](reports/) as dated Markdown, and refresh the live dashboard at the top of this README. --- ## ๐Ÿ”” Notification channels | Channel | Secrets to add | How to get it | |----------|----------------|---------------| | **Slack** | `SLACK_WEBHOOK_URL` | [Slack incoming webhooks](https://api.slack.com/messaging/webhooks) | | **Discord** | `DISCORD_WEBHOOK_URL` | Channel โ†’ Edit โ†’ Integrations โ†’ Webhooks | | **Telegram** | `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID` | [@BotFather](https://t.me/botfather) โ†’ new bot | | **Email** | `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`, `SMTP_TO` | Any SMTP (Gmail app password, Fastmailโ€ฆ) | | **Anything else** | `GENERIC_WEBHOOK_URL` | Zapier / Make / n8n / your own endpoint | Set one, several, or none - each activates only when its secret is present. --- ## ๐Ÿ“ก Data sources you can watch **Keyword momentum** (watchlist): `google search` ยท `google images` ยท `google news` ยท `google shopping` ยท `youtube` ยท `tiktok` ยท `reddit` ยท `amazon` ยท `wikipedia` ยท `news volume` ยท `news sentiment` ยท `app downloads` ยท `npm` ยท `steam` --- ## ๐Ÿงฎ Staying inside the free tier The free key gives you **100 requests/month**. TrendWatch spends **1 request per (keyword ร— source)** per run. Check your exact math anytime: ```bash python -m trendwatch quota ``` ``` Total per run : 2 request(s) Projected monthly usage by schedule: daily ~ 60 req/mo [OK ] every 12 hours ~ 120 req/mo [OVER] โœ“ On the free tier you can run up to: daily. Want more keywords or hourly checks? Upgrade: https://trendsmcp.ai/pricing ``` The default config (2 keywords, daily) lands at ~60/month - comfortably free. Need more? [Upgrade for more keywords, more sources, and hourly checks.](https://trendsmcp.ai/pricing) --- ## ๐Ÿ–ฅ๏ธ Run it locally (optional) ```bash git clone https://github.com/YOUR_USERNAME/trendwatch.git cd trendwatch pip install -r requirements.txt cp .env.example .env # then paste your TRENDS_API_KEY into .env python -m trendwatch check # validate config + key python -m trendwatch test # send a test alert to your channels python -m trendwatch run # do a real check now python -m trendwatch quota # see your monthly usage ``` --- ## โ“ FAQ **Is this just a Google Trends scraper?** No. There's no scraping anywhere in this repo - it makes authenticated API calls to [Trends MCP](https://www.trendsmcp.ai), which returns clean, normalized (0-100) trend data across 15+ platforms. No fragile HTML parsing, no Playwright, no proxies, no getting blocked. **Do I have to pay?** No. The free tier (100 req/month) covers daily monitoring of a small watchlist, which is what most people want. You only pay if you want more keywords, more sources, or higher frequency. **Will my API key leak if my repo is public?** No. Your key lives in GitHub **Secrets**, never in the code, and isn't exposed in logs or to forks of *your* repo. Everyone who uses TrendWatch brings their **own** key - there is no shared key in this template. **Where does the data come from?** From the Trends MCP API, which aggregates and normalizes signals from Google, YouTube, TikTok, Reddit, Amazon, Wikipedia, app stores, and more. See [trendsmcp.ai/docs](https://www.trendsmcp.ai/docs). **Can my AI agent use the same data?** Yes - Trends MCP is a [Model Context Protocol](https://modelcontextprotocol.io) server, so Claude, Cursor, and other MCP clients can query trends directly. TrendWatch is the "set-and-forget alerts" companion to that. See the [docs](https://www.trendsmcp.ai/docs). --- ## ๐Ÿ“ˆ Star history If TrendWatch is useful to you, a star helps others find it ๐Ÿ™ --- ## ๐Ÿค Contributing PRs welcome - new notification channels, smarter detection, nicer reports. See [CONTRIBUTING.md](CONTRIBUTING.md). ## โญ Like it? **[Star this repo](https://github.com/trendsmcp/TrendWatch)** so others can find it, and **[Use this template](https://github.com/trendsmcp/TrendWatch/generate)** to spin up your own trend radar in a minute. --- Built with [Trends MCP](https://www.trendsmcp.ai) - live trend data for AI assistants, agents & automations. TrendWatch is an open-source community project. It is not affiliated with, endorsed by, or sponsored by Google, TikTok, Reddit, Amazon, or any other platform named above. All trademarks belong to their respective owners. ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source โ€” we do not rehost the code. - **Author:** [trendsmcp-ai](https://github.com/trendsmcp-ai) - **Source:** [trendsmcp-ai/TrendWatch](https://github.com/trendsmcp-ai/TrendWatch) - **License:** MIT - **Homepage:** https://www.trendsmcp.ai Install and usage instructions live in the source repository linked above. ## Pricing - **Free** โ€” Free ## Security capabilities Automated source analysis of v0.1.0 โ€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** yes - **Dynamic code execution:** no *"Yes" means the capability is present in the source โ€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** โ€” security scan: passed โ€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-trendsmcp-ai-trendwatch - Seller: https://agentstack.voostack.com/s/trendsmcp-ai - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack โ€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.