⚡ XActions
🎯 Agent Skills

Saved Searches

Browser console scripts for managing saved searches on X/Twitter.

Script Selection

Goal File Navigate to
Save a search query src/saveSearch.js x.com/search?q=... (search results page)
List / delete / run saved searches src/savedSearchManager.js x.com

Quick Start

  1. Search for something on X: x.com/search?q=your+query
  2. Open DevTools (F12) → Console
  3. Paste src/saveSearch.js → Enter

Manage saved searches

  1. Go to x.com
  2. Open DevTools (F12) → Console
  3. Paste src/savedSearchManager.js → Enter

Available Functions (savedSearchManager.js)

XActions.list()            // List all saved searches
XActions.run('query')      // Run a saved search (navigates to results)
XActions.delete('query')   // Delete a saved search by name
XActions.export()          // Export all saved searches as JSON

Configuration

const CONFIG = {
  maxTweets: 100,          // Max tweets to collect when running a search
  scrollDelay: 2000,       // ms between scroll actions
  actionDelay: 1500,       // ms between UI actions
  maxScrollAttempts: 25,   // Max scroll rounds before stopping
};

Notes

  • X limits saved searches to 25 per account
  • Saved searches are stored in your X account (not just browser storage)
  • savedSearchManager.js can also scrape trending topics for discovery
  • discovery-explore — Browse trending topics and explore without saved searches
  • analytics-insights — Analyze search results for hashtags and keywords
  • twitter-scraping — Scrape full search result data

⚡ Free and open source

No API keys, no monthly fees, no signup. Star the repo if it saved you a subscription.

View on GitHub