Twitter 𝕏 keyword Alerts

Custom notifications for when you, your company, or anything you care about is mentioned on Twitter.

1. Authentication

You'll need a Twitter Bearer Token. Follow these instructions to get one.

Unfortunately it costs $100 / month to have a Basic Twitter Developer account. If you subscribe to Val Town Pro, I can let you "borrow" my token. Just comment on this val and I'll hook you up.

2. Query

Change the query variable for what you want to get notified for.

You can use Twitter's search operators to customize your query, for some collection of keywords, filtering out others, and much more!

3. Notification

Below I'm sending these mentions to a private channel in our company Discord, but you can customize that to whatever you want, @std/email, Slack, Telegram, whatever.

Readme

twitterAlert

Runs every 1 hrs

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

import { discordWebhook } from "https://esm.town/v/stevekrouse/discordWebhook";

import { twitterSearch } from "https://esm.town/v/stevekrouse/twitterSearch";

const query = "\"val.town\" OR \"val town\" -_ValTown_";

export async function twitterAlert({ lastRunAt }: Interval) {

const results = await twitterSearch({

query,

start_time: lastRunAt,

bearerToken: Deno.env.get("twitter"),

});

if (!results.length) return;

// format results

let content = results

.map(({ author_name, author_username, text, id }) => `https://fxtwitter.com/${author_username}/status/${id}`)

.join("\n");

// notify

await discordWebhook({

url: Deno.env.get("mentionsDiscord"),

content,

});

}

3

👆 This is a val. Vals are TypeScript snippets of code, written in the browser and run on our servers. Create scheduled functions, email yourself, and persist small pieces of data — all from the browser.

Sign up for free

v22 was merged from the PR "replaced twitter by fxtwitter for better embeds" by pomdtr

Comments

Hi! I would like to borrow your token please. I just signed up for Pro.

stevekrouse …

Sure thing! Let me make you your own private API!

Hiya! I'd also like to borrow it please if the offer still stands ^-^

stevekrouse …

Great! Will email you :)