Advanced Search for X (Twitter) 🔍
A feature-rich userscript that upgrades your search experience on X (formerly Twitter)
No need to memorize complex search operators anymore. Build advanced queries with an intuitive UI, organize your saved searches, lists, and accounts into folders, and keep your timeline clean with powerful mute filters.
✨ Key Features
This script is more than a simple search helper. It provides everything you need to turn X into a serious “information gathering and analysis” tool.
🚀 1. Powerful Search Builder (Search)
- Intuitive input: Just fill in fields like “contains these words”, “does not contain these words”, “at least 100 likes”, and the script will automatically generate complex search queries for you.
- Two-way sync: Queries that you type directly into X’s search bar are parsed and reflected in the tool’s UI. This also helps you understand what existing search commands actually mean.
- Date filters: Use a calendar to specify ranges, or choose convenient shortcuts like “Last 24 hours” or “Last year”.
📂 2. Drag & Drop Organization (Folders)
- Folder management: Organize your “Saved searches”, “Accounts”, and “Lists” into custom folders that you create.
- Easy operations: Reorder items or move them between folders simply by dragging and dropping.
⭐ 3. Advanced Local Bookmarks (Favorites)
- Add a ★ button: A “★” button is added near the Tweet’s share button. Click it to instantly save the Tweet.
- Tagging: Attach colored “tags” to bookmarks for classification. Hierarchical tags (nested structure) are supported.
- No notifications to others: Everything is saved locally in your browser, so the Tweet author is never notified. Images and videos are also stored together with the bookmark metadata.
🔇 4. Advanced Mute & Filtering (Mute)
- Powerful filters: In addition to normal keyword mutes, you can use regular expressions (regex) for highly flexible filtering.
- Display options: Choose whether to completely hide (Hidden) matching Tweets, or collapse them (Collapsed).
- Scope control: Apply mute rules not only to Tweet text, but also to usernames and user IDs.
🛡️ 5. Privacy & Data Management
- Local storage only: All data (history, bookmarks, settings) is stored locally in your browser (e.g., Tampermonkey storage). Nothing is sent to any external server.
- Secret mode: A “secret mode” is available where no search history is stored.
- Backup support: Export and import all settings and data as JSON files for backup or migration.
📥 Installation
To use this tool, you need a userscript manager extension installed in your browser.
- Install a userscript manager:
Install one of the following extensions in your browser:
- Install the script:
- Click the Install Script button at the top of this page, or click here to install.
- Open X (Twitter):
- Reload the page. A “magnifying glass 🔍” icon will appear at the top-right of the screen.
📖 How to Use
Basic operations
Click the magnifying glass icon at the top-right to open the control panel (modal).
- Move: Drag the icon or the top area of the panel to reposition it anywhere on the screen.
- Resize: Drag the panel edges to resize it.
- Theme: The UI automatically adapts to X’s appearance settings (Light / Dim / Lights Out).
Tabs Overview
| Tab |
Description |
| Search |
Build advanced search conditions. Press “Search” or hit Enter to execute the query. Use the “Save” button in the bottom-left to store conditions. |
| History |
Shows your past search history. Queries made in secret mode are not recorded. |
| Saved |
Manage frequently used search conditions. You can organize them into folders. |
| Favorites |
View Tweets saved with the ★ button. You can filter or search by tags. |
| Mute |
Register and manage keywords or regular expressions to filter out content. |
| Lists |
Register lists you view frequently, organize them into folders, and access them quickly. |
| Accounts |
Register specific user profiles and organize them in folders for quick access. |
⚙️ Settings & Backup
Click the ⚙️ icon at the top-right of the panel to open the settings screen.
- UI language: Automatically detected, but you can manually switch between Japanese, English, and other supported languages.
- Tab visibility: Hide unused tabs to simplify the menu.
- Import / Export: Export data as JSON to back it up or move it to another PC, and import it later when needed.
⚠️ Disclaimer
- This script is a third-party project and is not affiliated with X Corp.
- Due to changes in X’s UI or specifications, the script may temporarily stop working.
- Data is stored in your browser’s local storage. Clearing browser data (cache/storage) may delete it, so regular backup (export) is recommended.
🤝 Contributions & Support
For bug reports or feature requests, please open an issue on the Issues page.
If you find this project useful, please consider giving the repository a star (★)!
License: MIT
Author: koyasi777
