---
name: x-twitter-automation-guide
description: Guide to XActions — a TypeScript automation library for X (Twitter). Features browser automation, thread posting, engagement monitoring, follower analytics, and DM automation. 78 stars. Includes rate-limit-aware scheduling and anti-detection measures.
license: MIT
metadata:
  category: development
  difficulty: intermediate
  author: nich
  tags: [development, x-twitter-automation-guide]
---

# X/Twitter Automation Guide (XActions)

XActions is a TypeScript library for automating X (Twitter) actions. Features browser automation, thread posting, engagement monitoring, and DM management — with anti-detection and rate-limit-aware scheduling.

## Features

| Feature | Description | Rate Limit Aware |
|---------|-------------|-----------------|
| **Post Tweets** | Single tweets and threads | ✅ |
| **Engagement** | Like, retweet, reply, bookmark | ✅ |
| **Search** | Advanced search with filters | ✅ |
| **Followers** | Follow, unfollow, list management | ✅ |
| **DMs** | Send and read direct messages | ✅ |
| **Analytics** | Tweet performance, follower growth | ✅ |
| **Scheduling** | Queue tweets for future posting | ✅ |
| **Scraping** | Extract tweets, profiles, threads | ✅ |

## Quick Start

```bash
npm install xactions
```

```typescript
import { XClient } from 'xactions';

const client = new XClient({
  // Cookie-based auth (no API keys needed)
  cookies: process.env.X_COOKIES,
  // OR API-based auth
  apiKey: process.env.X_API_KEY,
  apiSecret: process.env.X_API_SECRET,
  accessToken: process.env.X_ACCESS_TOKEN,
  accessSecret: process.env.X_ACCESS_SECRET,
});
```

## Posting

### Single Tweet
```typescript
await client.tweet('Just minted my first ERC-8004 agent on @SperaxOfficial! 🤖');
```

### Thread
```typescript
await client.thread([
  'Thread: Understanding Sperax USDs auto-yield 🧵',
  '1/ USDs is a stablecoin that earns yield automatically just by holding it in your wallet',
  '2/ The yield comes from deploying collateral into battle-tested DeFi protocols',
  '3/ Current APY: ~7% — no staking, no locking, no claiming required',
  '4/ Available on Arbitrum. Learn more: https://app.sperax.io'
]);
```

### With Media
```typescript
await client.tweet('Check out this chart! 📈', {
  media: ['./chart.png'],
  altText: 'SPA price chart showing 50% gain this month'
});
```

## Search & Scraping

### Advanced Search
```typescript
const tweets = await client.search({
  query: 'sperax OR USDs OR $SPA',
  filter: 'latest',
  minLikes: 5,
  minReplies: 2,
  lang: 'en',
  since: '2024-01-01',
  limit: 100
});
```

### Profile Scraping
```typescript
const profile = await client.getProfile('SperaxOfficial');
// { followers, following, tweets, joined, bio, ... }

const tweets = await client.getUserTweets('SperaxOfficial', { limit: 50 });
```

## Engagement

```typescript
// Like a tweet
await client.like(tweetId);

// Retweet
await client.retweet(tweetId);

// Reply
await client.reply(tweetId, 'Great insight! USDs auto-yield makes this even better');

// Bookmark
await client.bookmark(tweetId);
```

## Scheduling

```typescript
import { Scheduler } from 'xactions';

const scheduler = new Scheduler(client);

// Schedule a tweet for later
scheduler.schedule('New Sperax Farm pools launching tomorrow! 🚀', {
  time: new Date('2024-12-01T09:00:00Z'),
  timezone: 'America/New_York'
});

// Schedule recurring tweets
scheduler.recurring({
  template: 'Daily DeFi tip: ${tip}',
  data: tips,
  frequency: 'daily',
  time: '09:00',
  timezone: 'UTC'
});
```

## Analytics

```typescript
// Get tweet performance
const analytics = await client.getTweetAnalytics(tweetId);
// { impressions, likes, retweets, replies, quotes, bookmarks, engagementRate }

// Follower growth over time
const growth = await client.getFollowerGrowth({
  period: '30d',
  granularity: 'daily'
});
```

## Anti-Detection

XActions includes built-in anti-detection:
- Randomized delays between actions
- Human-like typing simulation
- Fingerprint randomization
- Proxy rotation support
- Rate limit tracking and backoff

## Use Cases for Crypto

| Use Case | Description |
|----------|-------------|
| **Community Management** | Auto-engage with mentions and replies |
| **Content Distribution** | Schedule educational threads |
| **Sentiment Monitoring** | Track crypto project mentions |
| **Alpha Discovery** | Monitor whale/influencer accounts |
| **Sperax Marketing** | Distribute USDs/SPA content |

## Links

- GitHub: https://github.com/nirholas/XActions
- X API Docs: https://developer.x.com/en/docs
- Sperax: https://app.sperax.io