references/supporting-scripts.md
# Supporting Automation Scripts
All require `src/automation/core.js` pasted first.
## Quota Supervisor — `src/automation/quotaSupervisor.js`
Rate limiting supervisor. Enforces hourly and daily quotas per action type (follow, like, unfollow, etc.). Includes stochastic variance and automatic sleep behavior when limits are approached. **Paste before other automation scripts** for safety.
## Session Logger — `src/automation/sessionLogger.js`
Tracks all automation actions with timestamps. Generates summary reports. Exports data to JSON or CSV. Useful for measuring automation effectiveness and auditing.
## Multi-Account Manager — `src/automation/multiAccount.js`
Manages multiple X accounts with rotation. Tracks account status: active, paused, limited, or suspended. Rotates between accounts to distribute actions.
## Customer Service Bot — `src/automation/customerService.js`
Monitors mentions and DMs for incoming messages. Auto-responds using configurable response templates. Supports business hours configuration (only responds during set hours).
## Protect Active Users — `src/automation/protectActiveUsers.js`
Scans your posts for users who actively engage (like, retweet, reply). Adds them to a protected list that `smartUnfollow.js` respects — prevents unfollowing your most engaged followers.
## Actions Library — `src/automation/actions.js`
Complete DOM actions library (~2100 lines). Provides namespaced functions:
- `XActions.tweet.post()`, `XActions.tweet.like()`, `XActions.tweet.retweet()`
- `XActions.user.follow()`, `XActions.user.unfollow()`
- `XActions.dm.send()`
- `XActions.bookmark.add()`
Used internally by other automation scripts. Can also be used standalone after pasting `core.js`.
## Link Scraper — `src/automation/linkScraper.js`
Extracts all links shared by a user from their timeline. Filters by domain. Auto-downloads results as a file.
SKILL.md
---
name: growth-automation
description: Automates X/Twitter growth via browser console scripts. Auto-likes tweets by keyword/user filters, auto-comments on target users, follows by keyword search or engagement, follows audiences of target accounts with rich filtering, trains the algorithm for niches, and runs combined growth suites. All require pasting core.js first. Use when automating Twitter growth, engagement, following, or audience building.
license: Apache-2.0
metadata:
author: nichxbt
version: "4.0"
---
# Growth Automation
Browser console scripts for X/Twitter. **Always paste `src/automation/core.js` first** -- it provides shared config, selectors, utilities, and rate limiting.
## Script Selection
| Goal | File |
|------|------|
| Auto-like timeline tweets | `src/automation/autoLiker.js` |
| Auto-comment on target's posts | `src/automation/autoCommenter.js` |
| Follow users by keyword search | `src/automation/keywordFollow.js` |
| Follow users who engaged with posts | `src/automation/followEngagers.js` |
| Follow target account's audience | `src/automation/followTargetUsers.js` |
| All-in-one growth suite | `src/automation/growthSuite.js` |
| Train algorithm for your niche | `src/automation/algorithmTrainer.js` |
| Boost engagement systematically | `src/engagementBooster.js` |
| Welcome new followers | `src/welcomeNewFollowers.js` |
| Auto-plug viral tweets | `src/autoPlugReplies.js` |
## Key Scripts
### autoLiker.js
Scrolls timeline, checks tweets against configurable filters (keywords, users, skip replies/ads, min likes threshold, max per session), clicks Like. Gaussian-randomized delays.
### autoCommenter.js
Monitors a target user's profile for new posts. Replies with randomly rotated comment templates. Configurable check interval and max comments per session.
### keywordFollow.js
Searches X by keywords, follows users from results. Records follow timestamps (used by `smartUnfollow.js` for grace-period logic). Configurable daily limits, de-duplicates.
### followEngagers.js
Takes post URL(s), scans likers/retweeters/quote-tweeters, follows them. Configure engagement types and follow limit per post.
### followTargetUsers.js
Takes target account(s), follows their followers or following. Rich filters: min/max follower count, ratio, bio keywords (include/exclude), account age.
### growthSuite.js
Combines keyword follow + auto-like + smart unfollow + engagement tracking into a single long-running session with unified rate limiting.
### algorithmTrainer.js
Autonomous 24/7 algorithm training engine. Configurable niches with search terms and comment templates. Cycles through 8 phases: search top/latest, follow people, home feed engagement, influencer visits, profile visits, explore browsing, idle dwell. Human-like timing, probabilistic engagement, intensity presets (chill/normal/active), per-cycle and daily rate limits.
**Controls:** `stopTrainer()`, `trainerStatus()`, `trainerReset()`
### engagementBooster.js
Systematically likes and replies to tweets from target accounts. Tracks engagement history to avoid duplicates. Builds reciprocal relationships.
## Supporting Scripts
| File | Purpose |
|------|---------|
| `src/automation/quotaSupervisor.js` | Rate limiting with hourly/daily quotas |
| `src/automation/sessionLogger.js` | Action logging, reports, JSON/CSV export |
| `src/automation/multiAccount.js` | Multi-account rotation and tracking |
| `src/automation/customerService.js` | Auto-respond to mentions/DMs |
| `src/automation/protectActiveUsers.js` | Protect engaged followers from unfollow |
| `src/automation/smartUnfollow.js` | Time-based unfollow with whitelist |
| `src/automation/rssMonitor.js` | Monitor RSS feeds for content triggers |
## DOM Selectors
Defined in `src/automation/core.js`:
| Element | Selector |
|---------|----------|
| Like button | `[data-testid="like"]` |
| Tweet | `article[data-testid="tweet"]` |
| Tweet text | `[data-testid="tweetText"]` |
| User cell | `[data-testid="UserCell"]` |
| Follow button | `[data-testid$="-follow"]` |
## Rate Limits & Safety
- Auto-liker: 1-3s between likes, max 100/hour
- Keyword follow: 2-5s between follows, max 50/day recommended
- Auto-commenter: 30-60s between comments, max 20/day
- Algorithm trainer: built-in intensity presets with daily caps
- All scripts include rate-limit detection and automatic backoff
## Strategy Guide
### New account growth (0-1000 followers)
1. Set up `src/automation/algorithmTrainer.js` with your niche keywords
2. Run `src/automation/keywordFollow.js` targeting niche keywords daily
3. Use `src/automation/autoLiker.js` to engage with niche content
4. Enable `src/welcomeNewFollowers.js` to greet new followers
5. After 7 days, run `src/automation/smartUnfollow.js` to remove non-reciprocals
### Accelerating an established account
1. Use `src/automation/followEngagers.js` on competitor's viral tweets
2. Run `src/engagementBooster.js` targeting accounts in your space
3. Set up `src/autoPlugReplies.js` on your viral tweets
4. Use `src/automation/followTargetUsers.js` on competitor audiences with ratio filter
## Notes
- Always paste `src/automation/core.js` first for automation scripts
- Browser scripts in `src/` (non-automation) are standalone -- no core.js needed
- All growth scripts include pause/resume/abort controls
- Growth automation works best combined with quality content