SKILL.md
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 |
xgettrends |
Current trending topics |
xgetexplore |
Explore page content |
xsearchtweets |
Full-text tweet search |
Trending Topic Monitor
File: src/trendingTopicMonitor.js
Real-time trending topic scraper with niche classification.
Controls
XActions.scan() -- Scrape current trends
XActions.track() -- Log trend snapshot with timestamp
XActions.history() -- Show all tracked snapshots
XActions.forNiche(keyword) -- Filter trends by niche keyword
XActions.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 keywords
XActions.scan() -- Run one search cycle
XActions.autoScan(intervalMs) -- Continuous monitoring
XActions.stop() -- Stop auto-scanning
XActions.report() -- Show summary with sentiment breakdown
XActions.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.js or src/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.js or xsearchtweets for niche keywords
- Analyze top results for content gaps
- Use
src/viralTweetDetector.js on 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.js for 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)