| name | direct-messages |
| description | 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. |
| license | Apache-2.0 |
| metadata | {"author":"nichxbt","version":"3.0"} |
Direct Messages
Browser console scripts for sending, managing, and exporting X/Twitter DMs.
Available Scripts
| Script | File | Purpose |
|---|
| Send Direct Messages | src/sendDirectMessage.js | Send personalized DMs to a list of users |
| DM Manager | src/dmManager.js | Core DM management (read, filter, organize, export) |
Send Direct Messages
File: src/sendDirectMessage.js
Send personalized DMs to multiple users with message templates and rate limiting.
Configuration
const CONFIG = {
targetUsers: ['user1', 'user2'],
messageTemplate: 'Hey {username}! 👋 Just wanted to connect.',
limits: {
messagesPerSession: 10,
delayBetweenMessages: 30000,
},
skipIfAlreadyMessaged: true,
dryRun: true,
};
How to use
- Navigate to
x.com/messages
- Edit CONFIG with target users and message template
- Set
dryRun: false when ready
- Open DevTools (F12) → Console
- Paste the script → Enter
Safety features
- Tracks sent messages in
localStorage to avoid duplicates
- Configurable delay between messages (30s default)
- Session limit prevents over-messaging
- Dry-run mode previews actions without sending
Warning: Mass DMing can get your account restricted. Only message users who have open DMs or follow you.
DM Manager
File: src/dmManager.js
Core module for reading, filtering, organizing, and exporting DM conversations. Supports message requests, conversation search, and DM privacy settings.
How to use
- Navigate to
x.com/messages
- Open DevTools (F12) → Console
- Paste the script → Enter
Key Selectors
| Element | Selector |
|---|
| New message button | [data-testid="NewDM_Button"] |
| Search people | [data-testid="searchPeople"] |
| Message input | [data-testid="dmComposerTextInput"] |
| Send button | [data-testid="dmComposerSendButton"] |
| Conversation list | [data-testid="conversation"] |
| Message bubble | [data-testid="messageEntry"] |
| Message requests | [data-testid="messageRequests"] |
| Back button | [data-testid="app-bar-back"] |
Notes
- DM scripts require being on the Messages page (
x.com/messages)
- Group chats support up to 50 participants
- Message requests from non-followers must be approved before replying
- Add delays (30s+) between bulk DMs to avoid rate limits
{username} placeholder in templates is replaced with the recipient's handle- Sent history is persisted in
localStorage across sessions
