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

npm install xactions

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

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

Thread

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

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

Search & Scraping

Advanced Search

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
});