\n \n

🐦 Competitor Tweet Monitor

Search for tweets mentioning your competitors with powerful OR queries

\n\n \n

\n \n Twitter Search Query (use OR statements for multiple competitors)\n \n \n

\n 💡 Use quotes around usernames and domains. Combine with OR for multiple targets.\n

\n\n \n

Quick Examples (click to use):

\n Multiple Accounts:
\n \"@competitor1\" OR \"@competitor2\" OR \"@competitor3\"\n

\n Domain Names:
\n \"competitor.com\" OR \"rival.io\" OR \"alternative.ai\"\n

\n AI Companies:
\n \"@openai\" OR \"chatgpt\" OR \"claude\" OR \"@anthropic\"\n

\n\n \n

Search Results

\n \n

\n\n \n

⚠️

Error

\n\n \n

\n\n \n\n",[],[186,193],[186],{"_102":204,"_95":205,"_157":206,"_159":-5,"_160":137,"_161":207,"_163":164,"_104":208,"_99":209,"_166":198,"_168":210,"_169":22,"_170":-5,"_171":211,"_98":212},"fada3e2a-55d9-11f0-a5cf-f69ea79377d9","README.md","35ec41b1-1231-4886-b83f-96de0f0997ad",59,["D",1751305515324],3,"# Competitor Tweet Monitor\n\nA web application for searching and monitoring tweets mentioning your competitors using powerful OR query statements.\n\n## Project Structure\n\n```\n├── backend/\n│ └── index.ts (http) # Main HTTP API and static file server\n├── frontend/\n│ └── index.html # Web interface for searching tweets\n└── README.md\n```\n\n## Environment Variables\n\n### Required\n\n- **`TWITTER_BEARER_TOKEN`**: Your Twitter API bearer token for searching tweets\n\n### Getting a Twitter API Token\n\n1. Go to [developer.twitter.com](https://developer.twitter.com) and create a developer account\n2. Create a new app in the Twitter Developer Portal\n3. Navigate to the \"Keys and tokens\" tab\n4. Generate a Bearer Token\n5. Set the `TWITTER_BEARER_TOKEN` environment variable in Val Town with this token\n\n## How to Use\n\n1. Set up the `TWITTER_BEARER_TOKEN` environment variable with your Twitter API bearer token.\n2. Visit the web interface to enter custom search queries.\n3. Use OR statements to search for multiple competitors at once.\n4. View real-time results from the last 7 days.\n\n## Query Examples\n\n### Multiple Twitter Accounts\n```\n\"@competitor1\" OR \"@competitor2\" OR \"@competitor3\"\n```\n\n### Domain Names\n```\n\"competitor.com\" OR \"rival.io\" OR \"alternative.ai\"\n```\n\n### Mixed Queries\n```\n\"@openai\" OR \"chatgpt\" OR \"claude\" OR \"@anthropic\" OR \"openai.com\"\n```\n\n### Advanced Queries\n```\n(\"@competitor1\" OR \"competitor1.com\") AND (product OR launch OR announcement)\n```\n\n## Features\n\n- **Interactive Web Interface**: Easy-to-use form for entering custom queries\n- **OR Query Support**: Search multiple competitors simultaneously\n- **Real-time Results**: Get tweets from the last 7 days instantly\n- **Rich Tweet Display**: Shows author, content, metrics, and direct links\n- **Quick Examples**: Pre-built query templates for common use cases\n- **Responsive Design**: Works on desktop and mobile devices\n- **Error Handling**: Clear feedback for API issues or invalid queries\n\n## API Endpoints\n\n- `GET /` - Main web interface\n- `POST /api/search` - Search tweets with custom query\n- `GET /api/health` - Check API configuration status\n\n## Tweet Data Included\n\nEach tweet result includes:\n- Author name and username\n- Tweet content\n- Creation timestamp\n- Engagement metrics (likes, retweets, replies)\n- Direct link to original tweet\n- Retweet indicator",[],[205],"files",[154,173,184,191,203],"counts",{"_217":32,"_218":117,"_219":32,"_220":221},"pulls","branches","forks","envVars",{"_222":197,"_223":32},"count","emptyCount","contents",[226,229,232],{"_102":155,"_95":156,"_157":158,"_159":-5,"_160":137,"_161":162,"_163":164,"_104":227,"_99":32,"_166":167,"_168":-5,"_169":22,"_170":-5,"_98":228},["D",1751305359511],[156],{"_102":185,"_95":186,"_157":187,"_159":-5,"_160":137,"_161":188,"_163":164,"_104":230,"_99":32,"_166":167,"_168":-5,"_169":22,"_170":-5,"_98":231},["D",1751305413297],[186],{"_102":204,"_95":205,"_157":206,"_159":-5,"_160":137,"_161":207,"_163":164,"_104":233,"_99":209,"_166":198,"_168":210,"_169":22,"_170":-5,"_98":234},["D",1751305515324],[205],"upstreamProject",{"_102":146,"_95":96,"_110":237,"_111":-5,"_108":144,"_23":238},"it costs like $5k month for basic social listening tools lol",{"_93":239,"_129":240},"jamiedubs","https://avatars.githubusercontent.com/u/1903?v=4","upstreamBranch",{"_102":140,"_104":243,"_244":245,"_95":43,"_138":146,"_99":142,"_139":246,"_141":247,"_248":249,"_106":-5,"_151":22,"_108":144,"_150":239,"_16":148,"_149":96},["D",1747685840126],"updatedAt",["D",1748961260610],"daad77e8-26db-11f0-a5b3-569c3dd06744",21,"lockfileKey","1755542085510-esm.town_v_jamiedubs_twitterCompetitorMonitoring@26-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.environment-variables",{"_93":94,"_95":96,"_100":256,"_220":261},{"_102":103,"_95":96,"_104":257,"_106":-5,"_107":22,"_108":109,"_110":-5,"_111":-5,"_14":112,"_113":-5,"_114":22,"_115":-5,"_116":117,"_16":118,"_119":120,"_121":120,"_122":123,"_124":123,"_125":123,"_126":120,"_127":120,"_23":258,"_131":259,"_134":260,"_151":22},["D",1751299603436],{"_93":94,"_129":130},{"_93":94,"_133":130},{"_99":136,"_95":43,"_102":137,"_138":103,"_139":140,"_141":142,"_143":144,"_145":146,"_147":148,"_149":96,"_150":94},[262,267],{"_263":264,"_104":265,"_244":-5,"_110":72,"_266":22},"key","DISCORD_WEBHOOK",["D",1751303987696],"isEmpty",{"_263":268,"_104":269,"_244":270,"_110":72,"_266":22},"TWITTER_BEARER_TOKEN",["D",1751299603436],["D",1751304609266],"actionData","errors"]

Key	Description
DISCORD_WEBHOOK
TWITTER_BEARER_TOKEN

charmaine

twitterCompetitorMonitoring

Environment variables