SkillsAdd

nirholas/xactions

xactions-cli

Command-line interface for scraping X/Twitter data, managing MCP server config, and running automation.

First seen Feb 28, 2026

Installation

$ npx skills add nirholas/xactions --skill xactions-cli
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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.

Also in this package

Other skills from nirholas/xactions · top by installs.

npx skills add nirholas/xactions
twitter-scraping 41 direct-messages 27 community-health-monitoring 23 growth-automation 18 engagement-interaction 18 follower-monitoring 17 creator-monetization 17 analytics-insights 16 content-posting 16 algorithm-cultivation 16

Browse all from nirholas/xactions

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 510
License LICENSE
Default branch main
Open issues 9
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version4.0
LicenseApache-2.0
CompatibilityRequires Node.js 18+. Install with npm install -g xactions.
Declared agents windsurf
More metadata
author
nichxbt
version
4.0

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,320 B
  • docs SUMMARY.md 330 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 14 installs

SKILL.md

XActions CLI

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

Installation

npm install -g xactions

Authentication

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

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

Scraping Commands

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

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

Flag Description
-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:

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

Examples

# 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

Problem Solution
"Not authenticated" Run xactions login first
Browser won't launch Install Chromium: npx puppeteer browsers install chrome
Scraping returns empty Account may be private or auth_token expired
Command not found Reinstall: npm install -g xactions
MCP config path wrong Use --client flag to specify your IDE

Related Skills

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