# Saved Searches

> Create, manage, and run saved searches on X/Twitter. Save search queries, list saved searches, delete them, and run them to see fresh results. Use when users want to save or manage search queries on X.

- Skill: `nirholas/saved-searches` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nirholas/saved-searches`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nirholas/saved-searches/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: nirholas (https://skillmd.com/u/nirholas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nirholas/saved-searches

---


# 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

### Save a search

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`)

```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

```js
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

## Related Skills

- **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