notifications-management

Manages X/Twitter notifications including filtering by type, bulk management, notification scraping, and automated notification handling. Use when users want to manage, filter, scrape, or process X notifications in bulk.

139 stars

Best use case

notifications-management is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Manages X/Twitter notifications including filtering by type, bulk management, notification scraping, and automated notification handling. Use when users want to manage, filter, scrape, or process X notifications in bulk.

Teams using notifications-management should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/notifications-management/SKILL.md --create-dirs "https://raw.githubusercontent.com/nirholas/XActions/main/skills/notifications-management/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/notifications-management/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How notifications-management Compares

Feature / Agentnotifications-managementStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Manages X/Twitter notifications including filtering by type, bulk management, notification scraping, and automated notification handling. Use when users want to manage, filter, scrape, or process X notifications in bulk.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Notifications Management

Browser console script for managing and filtering X/Twitter notifications.

## Script Selection

| Goal | File | Navigate to |
|------|------|-------------|
| Filter and manage notifications | `src/notificationManager.js` | `x.com/notifications` |
| Scrape notification data | `scripts/scrapeNotifications.js` | `x.com/notifications` |
| Welcome new followers | `src/welcomeNewFollowers.js` | `x.com/USERNAME/followers` |

## Notification Manager

**File:** `src/notificationManager.js`

Manages X notifications: filter by type (mentions, likes, reposts, follows, replies), mark as read, and track notification activity.

### How to Use

1. Navigate to `x.com/notifications`
2. Open DevTools (F12) -> Console
3. Paste the script -> Enter

### Configuration

```javascript
const CONFIG = {
  filterTypes: ['mentions', 'likes', 'reposts', 'follows'],
  markAsRead: true,
  scrollToLoadMore: true,
  maxNotifications: 200,
  actionDelay: 1000,
};
```

### Features
- Filter notifications by type
- Count notifications by category
- Scrape notification content with author and timestamp
- Export notification data as JSON
- Identify most-engaged users from notifications

## Notification Scraper

**File:** `scripts/scrapeNotifications.js`

Standalone scraper that exports all visible notifications as structured JSON with author, type, content, and timestamp.

## DOM Selectors

| Element | Selector |
|---------|----------|
| Notification cells | `[data-testid="notification"]` |
| Toggle switch | `[data-testid="settingsSwitch"]` |
| Notifications tab | `a[href="/notifications"]` |
| Mentions tab | `a[href="/notifications/mentions"]` |
| Notification text | `[data-testid="notification"] [dir="auto"]` |

## Strategy Guide

### Identifying engagement opportunities
1. Run `src/notificationManager.js` to filter for mentions
2. Identify high-value mentions (verified users, large accounts)
3. Prioritize replies to mentions from users with 1000+ followers
4. Use `src/engagementLeaderboard.js` to cross-reference top engagers

### Automated new follower pipeline
1. Run `src/welcomeNewFollowers.js` to detect new followers
2. Review generated welcome message templates
3. Customize messages per follower based on their bio/niche

## Notes
- Notifications page loads in batches — script scrolls to collect more
- Rate limit: process with 1-2s delays between actions
- Navigate to the Notifications tab before running
- Mentions tab shows only @mentions for easier filtering

Related Skills

x-pro-management

139
from nirholas/XActions

Navigate to X Pro (TweetDeck), set up monitoring columns, and manage multi-column view. Use when users want to use X Pro / TweetDeck features or set up a multi-column dashboard.

topic-management

139
from nirholas/XActions

Browse, follow, and unfollow X Topics. Manage your followed topics list and discover new ones by keyword. Use when users want to follow or unfollow topics on X, or manage their topic feed.

teams-management

139
from nirholas/XActions

Create and manage teams in XActions — invite members, assign roles, and collaborate on automation tasks. Use when users want to set up multi-user access or team-based account management.

profile-management

139
from nirholas/XActions

Updates X/Twitter profile information including bio, avatar, header image, display name, location, website, and QR code sharing. Use when updating profile fields, optimizing profile for growth, or sharing profile via QR code.

lists-management

139
from nirholas/XActions

Creates, populates, and exports X/Twitter lists from the browser console. Supports creating public or private lists, bulk-adding members by username, and exporting list members as JSON. Use when users want to create lists, add members to lists, or export list data on X.

crm-management

139
from nirholas/XActions

Manage a CRM (Contact Relationship Management) system for your X followers and contacts. Tag, segment, search, and sync follower data. Use when users want to manage relationships with their X audience at scale.

community-management

139
from nirholas/XActions

Manages X/Twitter community memberships. Bulk-leave all communities, join communities by topic, and manage community interactions. Use when leaving all communities, joining niche communities, or managing community presence.

bookmarks-management

139
from nirholas/XActions

Manages X/Twitter bookmarks — organize by category with auto-tagging, clear all bookmarks in bulk, and export/scrape bookmarks with full metadata. Supports keyword-based categorization, CSV and JSON export, keep-filters, and folder creation (Premium). Use when users want to export, organize, or clear their X bookmarks.

blocking-muting-management

139
from nirholas/XActions

Mass block, unblock, mute, unmute, and manage accounts on X/Twitter. Includes bot detection and blocking, keyword-based muting, muted word management, spam reporting, and follower removal via soft-block. Use when users want to block bots, mass block/unblock accounts, mute by keywords, manage muted words, or remove followers.

billing-management

139
from nirholas/XActions

Manage XActions subscriptions and billing — view plans, start a Stripe checkout, open the billing portal, or cancel a subscription. Use when users want to upgrade, downgrade, or manage their XActions subscription.

xactions-mcp-server

139
from nirholas/XActions

Free MCP server providing 68+ tools for AI agents to automate X/Twitter. Scrapes profiles, followers, tweets. Posts, follows, likes, retweets, downloads videos, analyzes sentiment, monitors brands, manages DMs, runs workflows, and more. Uses local Puppeteer -- no API keys or payments required. Compatible with Claude Desktop, Cursor, Windsurf, VS Code. Use when setting up or using AI agent Twitter automation via MCP.

xactions-cli

139
from nirholas/XActions

Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation. Scrapes profiles, followers, tweets, search results, and more from terminal. Outputs text, JSON, or CSV. Uses Puppeteer stealth. Use when running Twitter operations from command line or automated pipelines.