discovery-explore
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)
More from nirholas/xactions
twitter-scraping
Scrapes X/Twitter data without API access using Puppeteer stealth and browser console scripts. Extracts profiles, followers, following lists, tweets, search results, hashtags, threads, media, bookmarks, notifications, DMs, likes, and viral tweets. Exports to JSON/CSV. Use when collecting, exporting, or analyzing Twitter data.
25direct-messages
Sends, manages, and automates direct messages on X/Twitter. Supports personalized bulk DMs with templates, conversation management, message request filtering, and DM export. The agent uses this skill when a user needs to send DMs, manage conversations, or automate direct messaging workflows.
10growth-automation
Automates X/Twitter growth via browser console scripts. Auto-likes tweets by keyword/user filters, auto-comments on target users, follows by keyword search or engagement, follows audiences of target accounts with rich filtering, trains the algorithm for niches, and runs combined growth suites. All require pasting core.js first. Use when automating Twitter growth, engagement, following, or audience building.
10engagement-interaction
Automates X/Twitter engagement actions — like, unlike, reply, bookmark, hide replies, and auto-like by keyword. Also bulk-unlikes all posts. Use when users want to automate likes, send replies, manage bookmarks on tweets, hide replies, or clear their entire likes history.
10follower-monitoring
Monitors X/Twitter follower changes using browser console scripts. Detects who unfollowed, tracks new followers with welcome messages, monitors any public account, runs continuous monitoring with alerts, tracks follower growth over time, and analyzes follower demographics. Use when tracking follower changes, detecting unfollowers, or monitoring Twitter accounts.
9grok-ai
Integrates with X/Twitter's Grok AI for chat, image generation, tweet analysis, and content creation. Automates Grok prompts, scrapes Grok responses, and uses Grok for content strategy. Requires X Premium+. Use when users want to use Grok AI for content generation, analysis, or chat automation on X.
8