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 example tracks mentions of "valtown" 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 use this template, fork this val on the top right corner of this page.

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.