nirholas Lists Management
Browser console script for creating and managing X/Twitter lists.
Script Selection
| Goal | File | Navigate to |
|---|---|---|
| Create a new list | src/listManager.js |
x.com/USERNAME/lists |
| Add users to a list | src/listManager.js |
List page |
| Export list members | src/listManager.js |
List members page |
List Manager
File: src/listManager.js
Browser console script that creates lists, adds members by username, and exports member data.
How to Use
- Navigate to
x.com/YOUR_USERNAME/lists(or an existing list page) - Open DevTools (F12) → Console
- Edit the CONFIG section to enable desired operations
- Paste the script → Enter
Configuration
const CONFIG = {
createList: {
enabled: false,
name: 'My List',
description: 'Created by XActions',
isPrivate: true,
},
addUsers: {
enabled: true,
usernames: ['user1', 'user2'],
},
exportMembers: {
enabled: false,
maxMembers: 200,
},
actionDelay: 2000,
};
Create List
Sets createList.enabled: true to create a new list. Fills in the name, description, and privacy toggle, then saves.
Add Members
Sets addUsers.enabled: true with a list of usernames. Opens the add-member search, types each username, clicks the matching user cell, and repeats. Navigate to the target list page first.
Export Members
Sets exportMembers.enabled: true. Scrolls through the list members page and exports all members (username, display name, bio) as a JSON download.
DOM Selectors
| Element | Selector |
|---|---|
| Create list button | [data-testid="createList"] |
| List name input | [data-testid="listNameInput"] |
| List description | [data-testid="listDescriptionInput"] |
| Private toggle | [data-testid="listPrivateToggle"] |
| Save button | [data-testid="listSaveButton"] |
| Add members | [data-testid="addMembers"] |
| Search people | [data-testid="searchPeople"] |
| User cell | [data-testid="UserCell"] |
Rate Limiting
- 2s delay between adding individual users
- 1.5s scroll delay when exporting members
- Up to 5 retries when no new members load during export scroll
X List Limits
- Maximum 1,000 lists per account
- Maximum 5,000 members per list
- Lists can be public (visible to anyone) or private (only you)
Troubleshooting
| Problem | Solution |
|---|---|
| Create button not found | Navigate to x.com/USERNAME/lists first |
| User not found when adding | Verify username spelling; user may have changed handle |
| Export stops early | Page may have finished scrolling; increase maxMembers if needed |
| Search input not found | Ensure you clicked "Add member" — script expects the search overlay |