nirholas/xactions/xactions-cli

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation. Scrapes profiles, followers, tweets, search results, and more from terminal. Outputs text, JSON, or CSV. Uses Puppeteer stealth. Use when running Twitter operations from command line or automated pipelines.

Install

npx vskill@latest install nirholas/xactions/xactions-cli

SKILL.md

XActions CLI

Entry point: src/cli/index.js. Config stored at ~/.xactions/config.json.

Installation

bash
npm install -g xactions

Authentication

bash
xactions login    # Interactive prompt for auth_token cookie
xactions logout   # Removes saved cookie
xactions info     # Show current auth status and config

Get your auth_token: DevTools (F12) -> Application -> Cookies -> x.com -> copy auth_token value.

Scraping Commands

bash
xactions profile <username>
xactions followers <username> [-l <limit>] [-o json|csv]
xactions following <username> [-l <limit>] [-o json|csv]
xactions non-followers <username>
xactions tweets <username> [-l <limit>] [-o json|csv]
xactions search "<query>" [-l <limit>] [-o json|csv]
xactions hashtag <tag> [-l <limit>] [-o json|csv]
xactions thread <url>
xactions media <username> [-l <limit>]

MCP Server Commands

bash
xactions mcp-config                     # Generate config for Claude Desktop
xactions mcp-config --client cursor     # Generate for Cursor
xactions mcp-config --client windsurf   # Generate for Windsurf
xactions mcp-config --client vscode     # Generate for VS Code
xactions mcp-config --write             # Write config directly to file

The mcp-config command auto-detects your OS and generates the correct config file path.

Output Flags

FlagDescription
-l, --limit <n>Maximum items to scrape
-o, --output <format>json or csv — saves to {username}_{command}.{ext}

Default output is pretty-printed to terminal with colored formatting.

Programmatic API

The CLI wraps the same scraper API available as a library:

javascript
import { createBrowser, createPage, loginWithCookie,
  scrapeProfile, scrapeFollowers, scrapeFollowing, scrapeTweets,
  searchTweets, scrapeHashtag, scrapeThread, scrapeMedia,
  exportToJSON, exportToCSV } from 'xactions';

Examples

bash
# Scrape a profile
xactions profile elonmusk
 
# Export followers as CSV
xactions followers nichxbt -l 200 -o csv
 
# Search tweets and save as JSON
xactions search "AI agents" -l 50 -o json
 
# Unroll a thread
xactions thread https://x.com/nichxbt/status/1234567890
 
# Generate Claude Desktop MCP config
xactions mcp-config --write

Troubleshooting

ProblemSolution
"Not authenticated"Run xactions login first
Browser won't launchInstall Chromium: npx puppeteer browsers install chrome
Scraping returns emptyAccount may be private or auth_token expired
Command not foundReinstall: npm install -g xactions
MCP config path wrongUse --client flag to specify your IDE

Related Skills

  • twitter-scraping — Detailed scraper API documentation
  • xactions-mcp-server — MCP server setup and tools

Security

  • Security scanPassed, 93 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
126
Repository forks
19
Repository npm downloads, 7 days
72
7-day trend score
37

Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 22 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/nirholas/xactions/xactions-cli/badge)](https://verified-skill.com/skills/nirholas/xactions/xactions-cli)

Something wrong with this skill or its page? Tell us.