nirholas Discovery & Explore
Browser console scripts and MCP tools for exploring trends, searching content, and discovering accounts on X/Twitter.
Script Selection
| Goal | File | Navigate to |
|---|---|---|
| Monitor trending topics | src/trendingTopicMonitor.js |
x.com/explore/tabs/trending |
| Search tweets | scripts/scrapeSearch.js |
Search results page |
| Scrape hashtag | scripts/scrapeHashtag.js |
x.com/hashtag/TAG |
| Find viral tweets | src/viralTweetDetector.js |
Any profile |
| Keyword monitoring | src/keywordMonitor.js |
Any page |
| Scrape explore page | src/exploreScraper.js |
x.com/explore |
MCP Tools
| Tool | Description |
|---|---|
x_get_trends |
Current trending topics |
x_get_explore |
Explore page content |
x_search_tweets |
Full-text tweet search |
Trending Topic Monitor
File: src/trendingTopicMonitor.js
Real-time trending topic scraper with niche classification.
Controls
XActions.scan()-- Scrape current trendsXActions.track()-- Log trend snapshot with timestampXActions.history()-- Show all tracked snapshotsXActions.forNiche(keyword)-- Filter trends by niche keywordXActions.export()-- Download trend data as JSON
Features
- Categorizes trends by niche (tech, politics, entertainment, sports, crypto, etc.)
- Tracks trend velocity (rising/falling)
- Identifies trending hashtags vs organic trends
- Alerts on niche-relevant trends
Keyword Monitor
File: src/keywordMonitor.js
Monitors X for mentions of specific keywords with sentiment classification.
Controls
XActions.setKeywords(['keyword1', 'keyword2'])-- Configure keywordsXActions.scan()-- Run one search cycleXActions.autoScan(intervalMs)-- Continuous monitoringXActions.stop()-- Stop auto-scanningXActions.report()-- Show summary with sentiment breakdownXActions.export()-- Download results as JSON
Strategy Guide
Trend-jacking workflow
- Run
src/trendingTopicMonitor.js->XActions.forNiche('your_niche') - Identify relevant trends with momentum
- Craft timely content using
src/threadComposer.jsorsrc/contentRepurposer.js - Post within the first 2 hours of trend emergence for maximum visibility
- Track performance with
src/tweetPerformance.js
Content ideation from search
- Use
scripts/scrapeSearch.jsorx_search_tweetsfor niche keywords - Analyze top results for content gaps
- Use
src/viralTweetDetector.json popular accounts in your niche - Repurpose successful formats with
src/contentRepurposer.js
Building a discovery routine
- Daily:
src/trendingTopicMonitor.js->XActions.track()for trend log - Weekly: Review
XActions.history()for recurring themes - Set
src/keywordMonitor.jsfor brand/topic monitoring
Notes
- Explore page content varies by region and account history
- Trends refresh every ~15 minutes on X
- Keyword monitor uses X search (subject to standard rate limits)
- Trending data is publicly accessible (no auth needed for viewing)