Twitter/𝕏 Keyword Alerts [TEMPLATE]

Get custom notifications when you, your company, or anything you care about is mentioned on Twitter/X, even if they don't tag you directly.

This template will help you:

1. Search for specific mentions on Twitter/X using customizable keywords.
2. Deliver notifications wherever you'd like (email, Discord, Slack, Telegram, etc).

This val tracks mentions of "Val Town" and related terms, excluding noise like retweets and irrelevant accounts. Notifications are sent to a Discord webhook but can be easily reconfigured for other platforms. To see exactly how we use this template at Val Town: https://www.val.town/v/stevekrouse/twitterAlert

To use this template, fork this val on the top right corner of this page.

The CODE box shows you the the full source code of this val, you may need to scroll down to see it.

Define what you want to search for by modifying:

• keywords: Add terms or phrases you care about.

const keywords = ["val.town", "val.run", "val town"];

• excludes: Exclude irrelevant mentions (e.g., retweets, specific users, or keywords).

const excludes = "-_ValTown_ -is:retweet -from:valenzuelacity -from:val__run";

Refer to Twitter's search operators to fine-tune your query.

Set isProd = false in the code if you are testing, to ensure there are enough tweets to display.
Toggle it back to true when you're ready to run this cron job in production.

Once you've followed the instructions to create your Discord webhook, save it in your environment variables as mentionsDiscord so the following will run:

  await discordWebhook({
      url: Deno.env.get("mentionsDiscord"),
      content,
    });

Currently, this val sends notifications to Discord.

Update the discordWebhook call to send notifications to your preferred platform (e.g., @std/email, Slack, or anywhere else.)

This val uses the SocialData API for Twitter data:

• Proxies via Val Town's SocialDataProxy: Limited to 100 calls/day for Val Town Pro users.
• Need more calls? Sign up for your own SocialData API token and configure the socialDataSearch function.