XActions

 
██╗  ██╗ █████╗  ██████╗████████╗██╗ ██████╗ ███╗   ██╗███████╗
╚██╗██╔╝██╔══██╗██╔════╝╚══██╔══╝██║██╔═══██╗████╗  ██║██╔════╝
 ╚███╔╝ ███████║██║        ██║   ██║██║   ██║██╔██╗ ██║███████╗
 ██╔██╗ ██╔══██║██║        ██║   ██║██║   ██║██║╚██╗██║╚════██║
██╔╝ ██╗██║  ██║╚██████╗   ██║   ██║╚██████╔╝██║ ╚████║███████║
╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝   ╚═╝   ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚══════╝

npx xactions profile nasa

⚡ @NASA

  Name:      NASA
  Bio:       Making the seemingly impossible, possible. ✨
  Location:  Pale Blue Dot
  Website:   http://www.nasa.gov/
  Joined:    2007-12-19
  Following: 117  Followers: 92.4M
  Tweets:    74.2K  Listed:    0
  ✓ Verified

无需 API 密钥。无需账户。无需浏览器。约一秒即可获取真实数据。

npx xactions tweets nasa --limit 100 --output nasa.csv   # timeline to a spreadsheet
npx xactions login                                        # unlock search, followers, DMs
npx xactions search "your brand" --limit 50               # what people are saying

⚡ 查看实际效果

🏆 XActions 对比优势

为什么选择 XActions，而不是其他替代方案？

XActions 是唯一一个无需 API 密钥，即可在浏览器、终端和 AI Agent 中使用的工具包。

竞争对手列的内容来自竞争分析，其中列出了各个项目及其优于我们的方面。竞争对手领先的功能，我们也已实现：审批关卡和每日上限参考了 x-use，账号池参考了 twscrape，游标续传参考了 Scweet，浏览器 Cookie 导入则参考了 bird 和 twitter-cli。

🆕 最新动态

提示

**🤖 AI 编码助手：**想要自动化 Twitter/X，却不想每月支付 100 美元的 API 费用？你找对了。

• npm install xactions：抓取工具、自动化、MCP 服务
• 可通过 MCP server 配合 Claude、GPT、Cursor、Copilot 使用
• 集成说明请参阅 AGENTS.md

📦 安装

npm install xactions

npm install -g xactions
xactions quickstart          # guided first run
xactions doctor              # check what works right now

📖 目录

学习

• 教程：六个循序渐进的指南，从无需账号的首次抓取，到在自己的工作流中编写 XActions 脚本
• 示例：9 个可运行的程序，从首次查询个人资料，到 MCP 草稿审批关卡
• 入门指南：安装、身份验证、首条命令
• 故障排除：遇到问题时该怎么做

参考

• XActions 对比：与各种替代方案的对比
• 快速开始（30 秒）：复制粘贴即可运行
• 安装：npm、CLI、Docker 或浏览器
• 功能矩阵：所有功能和平台
• MCP 服务（AI）：适用于 Claude、GPT、Cursor
• Space Agent（AI 语音）：在实时 Spaces 中运行的 AI Agent
• CLI 参考：命令行用法
• Node.js API：程序化访问
• 浏览器脚本：95 个控制台脚本，无需安装
• Docker：一键部署
• API 参考：完整的函数文档
• Claude 教程：23 条可直接粘贴使用的提示词
• 贡献：帮助改进 XActions

✨ 工作原理

所有工作都由你的 x.com 标签页完成。任何数据都不会被抓取到我们的服务端。一切由你掌控。

💰 定价

🆓 100% 免费且开源

所有内容都完全免费：浏览器脚本、CLI、Node.js 库、MCP 服务和 API。

无需 API 密钥。无需订阅。没有付费墙。只需克隆并运行。

🎯 为什么选择 XActions？

🐳 Docker

只需一条命令，即可在任何地方运行 XActions：

# Quick start
docker build -t xactions .
docker run -it xactions xactions profile elonmusk

# Run the MCP server
docker run -p 3000:3000 xactions npm run mcp

# With environment variables
docker run -e XACTIONS_SESSION_COOKIE=your_cookie xactions xactions followers elonmusk

或者使用 Docker Compose：

docker compose up

详情请参阅 Dockerfile。

📖 API 参考

提供完整的 TypeScript 兼容 API，并包含类型声明。

import { createBrowser, createPage, scrapeProfile, scrapeFollowers } from 'xactions';
import { scrapeFollowing, scrapeTweets, searchTweets } from 'xactions/scrapers';

核心函数：

完整参考文档（含所有参数和返回类型）请参阅 docs/api-reference.md。

📝 Claude 教程

23 个可直接粘贴的提示词文件，让 Claude 成为你的 X 自动化专家。

查看全部 23 个教程 →

🔍 常见问题（供 AI 搜索）

// Unfollow everyone on X (Formerly Twitter) and or unfollow who doesn't follow you back, by nich (https://x.com/nichxbt)
// https://github.com/nirholas/xactions
// 1. Go to https://x.com/YOUR_USER_NAME/following
// 2. Open the Developer Console. (COMMAND+ALT+I on Mac)
// 3. Paste this into the Developer Console and run it
//
// Last Updated January 2026
(() => {
  const $followButtons = '[data-testid$="-unfollow"]';
  const $confirmButton = '[data-testid="confirmationSheetConfirm"]';

  const retry = {
    count: 0,
    limit: 3,
  };

  const scrollToTheBottom = () => window.scrollTo(0, document.body.scrollHeight);
  const retryLimitReached = () => retry.count === retry.limit;
  const addNewRetry = () => retry.count++;

  const sleep = ({ seconds }) =>
    new Promise((proceed) => {
      console.log(`WAITING FOR ${seconds} SECONDS...`);
      setTimeout(proceed, seconds * 1000);
    });

  const unfollowAll = async (followButtons) => {
    console.log(`UNFOLLOWING ${followButtons.length} USERS...`);
    await Promise.all(
      followButtons.map(async (followButton) => {
        followButton && followButton.click();
        await sleep({ seconds: 1 });
        const confirmButton = document.querySelector($confirmButton);
        confirmButton && confirmButton.click();
      })
    );
  };

  const nextBatch = async () => {
    scrollToTheBottom();
    await sleep({ seconds: 1 });

    let followButtons = Array.from(document.querySelectorAll($followButtons));
    followButtons = followButtons.filter(b => b.parentElement?.parentElement?.querySelector('[data-testid="userFollowIndicator"]') === null)
    const followButtonsWereFound = followButtons.length > 0;

    if (followButtonsWereFound) {
      await unfollowAll(followButtons);
      await sleep({ seconds: 2 });
      return nextBatch();
    } else {
      addNewRetry();
    }

    if (retryLimitReached()) {
      console.log(`NO ACCOUNTS FOUND, SO I THINK WE'RE DONE`);
      console.log(`RELOAD PAGE AND RE-RUN SCRIPT IF ANY WERE MISSED`);
    } else {
      await sleep({ seconds: 2 });
      return nextBatch();
    }
  };

  nextBatch();
})();

// Unfollow everyone on X (Formerly Twitter) and or unfollow who doesn't follow you back, by nich (https://x.com/nichxbt)
// https://github.com/nirholas/xactions
//
// 1. Go to https://x.com/YOUR_USER_NAME/following
// 2. Open the Developer Console. (COMMAND+ALT+I on Mac)
// 3. Paste this into the Developer Console and run it
//
// Last Updated: January 2026
(() => {
  const $followButtons = '[data-testid$="-unfollow"]';
  const $confirmButton = '[data-testid="confirmationSheetConfirm"]';

  const retry = {
    count: 0,
    limit: 3,
  };

  const scrollToTheBottom = () => window.scrollTo(0, document.body.scrollHeight);
  const retryLimitReached = () => retry.count === retry.limit;
  const addNewRetry = () => retry.count++;

  const sleep = ({ seconds }) =>
    new Promise((proceed) => {
      console.log(`WAITING FOR ${seconds} SECONDS...`);
      setTimeout(proceed, seconds * 1000);
    });

  const unfollowAll = async (followButtons) => {
    console.log(`UNFOLLOWING ${followButtons.length} USERS...`);
    await Promise.all(
      followButtons.map(async (followButton) => {
        followButton && followButton.click();
        await sleep({ seconds: 1 });
        const confirmButton = document.querySelector($confirmButton);
        confirmButton && confirmButton.click();
      })
    );
  };

  const nextBatch = async () => {
    scrollToTheBottom();
    await sleep({ seconds: 1 });

    const followButtons = Array.from(document.querySelectorAll($followButtons));
    const followButtonsWereFound = followButtons.length > 0;

    if (followButtonsWereFound) {
      await unfollowAll(followButtons);
      await sleep({ seconds: 2 });
      return nextBatch();
    } else {
      addNewRetry();
    }

    if (retryLimitReached()) {
      console.log(`NO ACCOUNTS FOUND, SO I THINK WE'RE DONE`);
      console.log(`RELOAD PAGE AND RE-RUN SCRIPT IF ANY WERE MISSED`);
    } else {
      await sleep({ seconds: 2 });
      return nextBatch();
    }
  };

  nextBatch();
})();

⚠️ 免责声明

警告

仅供学习

本项目仅用于学习和研究。这些脚本和工具尚未在个人账号上经过广泛测试。

• 使用风险自负
• 对于任何账号限制或封禁，我们概不负责
• 请始终遵守 X/Twitter 的服务条款
• 请从小批量操作开始，并谨慎测试

致 X/Twitter： 如果你对本项目有任何顾虑，或希望我们修改或移除任何功能，请直接联系 @nichxbt。我们很乐意与你合作。

致谢： 本项目的灵感源自 X 和 xAI 正在开展的创新。我们钦佩 Elon Musk 将 X 打造为万能应用的愿景，也赞赏 Grok 的 AI 理念。XActions 旨在帮助开发者和研究人员探索平台功能，同时尊重其生态系统。

🚀 快速入门示例

60 秒，无需账号

安装后，大多数读取操作即可使用。你不需要 X 账号、API 密钥或浏览器。

npm install -g xactions

xactions doctor                      # what works right now, and why
xactions profile NASA                # any public account
xactions analyze NASA                # engagement rate, cadence, content mix, best hour
xactions tweets NASA --limit 50 --json | jq -r '.[].text'

然后在真实浏览器中登录一次，即可使用搜索、关注者、正在关注、点赞、书签和私信功能：

xactions connect
xactions search "your topic" --limit 50

不带参数运行 xactions 会按任务分组打印全部 56 条命令。运行 xactions completion bash（或 zsh、fish）即可启用 Tab 补全。

示例 1：取消关注未关注你的人（30 秒）

浏览器控制台：无需安装！

// Go to: x.com/YOUR_USERNAME/following
// Press F12 → Console → Paste this:

(() => {
  const sleep = (s) => new Promise(r => setTimeout(r, s * 1000));
  const run = async () => {
    const buttons = [...document.querySelectorAll('[data-testid$="-unfollow"]')]
      .filter(b => !b.closest('[data-testid="UserCell"]')
        ?.querySelector('[data-testid="userFollowIndicator"]'));
    
    for (const btn of buttons) {
      btn.click();
      await sleep(1);
      document.querySelector('[data-testid="confirmationSheetConfirm"]')?.click();
      await sleep(2);
    }
    window.scrollTo(0, document.body.scrollHeight);
    await sleep(2);
    if (document.querySelectorAll('[data-testid$="-unfollow"]').length) run();
    else console.log('✅ Done! Reload page to continue.');
  };
  run();
})();

命令行：

xactions login
xactions non-followers YOUR_USERNAME --output non-followers.json

Node.js：

import { createBrowser, createPage, scrapeFollowing } from 'xactions';

const browser = await createBrowser();
const page = await createPage(browser);
const following = await scrapeFollowing(page, 'your_username', { limit: 500 });
const nonFollowers = following.filter(u => !u.followsBack);
console.log(`Found ${nonFollowers.length} non-followers`);
await browser.close();

💡 不想编写代码？ 使用 xactions.app：登录后点击即可！

示例 2：抓取任意个人资料

浏览器控制台：

// Go to any profile on x.com, then run:

(() => {
  const profile = {
    name: document.querySelector('[data-testid="UserName"]')?.textContent?.split('@')[0]?.trim(),
    username: location.pathname.slice(1),
    bio: document.querySelector('[data-testid="UserDescription"]')?.textContent,
    followers: document.querySelector('a[href$="/followers"] span')?.textContent,
    following: document.querySelector('a[href$="/following"] span')?.textContent,
  };
  console.log(profile);
  copy(JSON.stringify(profile, null, 2)); // Copies to clipboard!
})();

命令行：

xactions profile elonmusk --json

Node.js：

import { createBrowser, createPage, scrapeProfile } from 'xactions';

const browser = await createBrowser();
const page = await createPage(browser);
const profile = await scrapeProfile(page, 'elonmusk');
console.log(profile);
// { name: 'Elon Musk', followers: '200M', bio: '...', ... }
await browser.close();

示例 3：搜索并抓取推文

浏览器控制台：

// Go to: x.com/search?q=YOUR_KEYWORD&f=live

(() => {
  const tweets = [...document.querySelectorAll('article[data-testid="tweet"]')]
    .map(article => ({
      text: article.querySelector('[data-testid="tweetText"]')?.textContent,
      author: article.querySelector('[data-testid="User-Name"] a')?.href?.split('/')[3],
      time: article.querySelector('time')?.getAttribute('datetime'),
    }));
  console.table(tweets);
  copy(JSON.stringify(tweets, null, 2));
})();

命令行：

xactions search "AI startup" --limit 100 --output ai-tweets.json

Node.js：

import { createBrowser, createPage, searchTweets } from 'xactions';

const browser = await createBrowser();
const page = await createPage(browser);
const tweets = await searchTweets(page, 'AI startup', { limit: 100 });
console.log(`Found ${tweets.length} tweets`);
await browser.close();

示例 4：检测谁取消了对你的关注

浏览器控制台：

// Go to: x.com/YOUR_USERNAME/followers

(() => {
  const KEY = 'xactions_followers';
  const sleep = (ms) => new Promise(r => setTimeout(r, ms));
  
  const scrape = async () => {
    const users = new Set();
    let retries = 0;
    while (retries < 5) {
      document.querySelectorAll('[data-testid="UserCell"] a')
        .forEach(a => users.add(a.href.split('/')[3]?.toLowerCase()));
      window.scrollTo(0, document.body.scrollHeight);
      await sleep(1500);
      retries++;
    }
    return [...users].filter(Boolean);
  };

  scrape().then(current => {
    const saved = localStorage.getItem(KEY);
    if (saved) {
      const old = JSON.parse(saved);
      const gone = old.filter(u => !current.includes(u));
      console.log('🚨 Unfollowed you:', gone);
    }
    localStorage.setItem(KEY, JSON.stringify(current));
    console.log(`💾 Saved ${current.length} followers`);
  });
})();

命令行：

# First run saves snapshot
xactions followers YOUR_USERNAME --output snapshot1.json

# Later, compare
xactions followers YOUR_USERNAME --output snapshot2.json
# Use diff tools to compare

示例 5：按关键词自动点赞帖子

浏览器控制台：

// Go to: x.com/search?q=YOUR_KEYWORD&f=live

(async () => {
  const sleep = (s) => new Promise(r => setTimeout(r, s * 1000));
  const liked = new Set();
  
  while (liked.size < 20) { // Like 20 posts
    const buttons = [...document.querySelectorAll('[data-testid="like"]')]
      .filter(b => !liked.has(b));
    
    for (const btn of buttons.slice(0, 3)) {
      btn.click();
      liked.add(btn);
      console.log(`❤️ Liked ${liked.size} posts`);
      await sleep(3 + Math.random() * 2); // Random delay
    }
    window.scrollTo(0, document.body.scrollHeight);
    await sleep(2);
  }
  console.log('✅ Done!');
})();

⚠️ 请放慢速度！ Twitter 可能会限制你的请求频率。网站版本会自动处理这一点。

示例 6：退出所有社群

浏览器控制台：

// Go to: x.com/YOUR_USERNAME/communities

(() => {
  const $communityLinks = 'a[href^="/i/communities/"]';
  const $joinedButton = 'button[aria-label^="Joined"]';
  const $confirmButton = '[data-testid="confirmationSheetConfirm"]';
  const $communitiesNav = 'a[aria-label="Communities"]';

  const getLeftCommunities = () => {
    try { return JSON.parse(sessionStorage.getItem('xactions_left_ids') || '[]'); }
    catch { return []; }
  };
  const markAsLeft = (id) => {
    const left = getLeftCommunities();
    if (!left.includes(id)) {
      left.push(id);
      sessionStorage.setItem('xactions_left_ids', JSON.stringify(left));
    }
  };

  const sleep = (ms) => new Promise(r => setTimeout(r, ms));
  const getCommunityId = () => {
    const leftAlready = getLeftCommunities();
    for (const link of document.querySelectorAll($communityLinks)) {
      const match = link.href.match(/\/i\/communities\/(\d+)/);
      if (match && !leftAlready.includes(match[1])) return { id: match[1], element: link };
    }
    return null;
  };

  const run = async () => {
    console.log(`🚀 Left so far: ${getLeftCommunities().length}`);
    await sleep(1500);
    const joinedBtn = document.querySelector($joinedButton);
    if (joinedBtn) {
      const urlMatch = window.location.href.match(/\/i\/communities\/(\d+)/);
      const currentId = urlMatch ? urlMatch[1] : null;
      joinedBtn.click();
      await sleep(1000);
      const confirmBtn = document.querySelector($confirmButton);
      if (confirmBtn) { confirmBtn.click(); if (currentId) markAsLeft(currentId); await sleep(1500); }
      const communitiesLink = document.querySelector($communitiesNav);
      if (communitiesLink) { communitiesLink.click(); await sleep(2500); return run(); }
    }
    const community = getCommunityId();
    if (community) { community.element.click(); await sleep(2500); return run(); }
    else { console.log(`🎉 DONE! Left ${getLeftCommunities().length} communities`); sessionStorage.removeItem('xactions_left_ids'); }
  };
  run();
})();

📖 完整文档：docs/examples/leave-all-communities.md

📋 完整功能列表

功能可用性矩阵

图例： ✅ 完整支持 | ⚠️ 基础/手动 | ❌ 不可用

🤖 MCP 服务（AI Agent）

XActions 提供功能最全面的免费 X/Twitter MCP 服务。适用于 Claude、Cursor、Windsurf、VS Code 以及任何 MCP 客户端。

快速设置（30 秒）

添加到你的 Claude Desktop 配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "xactions": {
      "command": "npx",
      "args": ["-y", "xactions-mcp"],
      "env": {
        "XACTIONS_SESSION_COOKIE": "your_auth_token_here"
      }
    }
  }
}

获取你的 auth_token：x.com → 开发者工具（F12）→ Application → Cookies → 复制 auth_token 值

或者自动生成配置：

npx xactions mcp-config --client claude
npx xactions mcp-config --client cursor
npx xactions mcp-config --client windsurf

可用的 MCP 工具（152）

每个工具都只属于一个组，并且列表可筛选，因此客户端只会加载会话所需的工具：

npx xactions-mcp --tools read,analytics     # advertise these groups only
npx xactions-mcp --exclude write,dm         # or subtract from the full list
XACTIONS_MCP_TOOLS=read npx xactions-mcp    # same thing through the environment

经过筛选的工具既不会公开，也无法调用。各组按数量从多到少排列： read、analytics、write、monitoring、data、workflows、automation、 ai、persona、spaces、graph、drafts、dm、grok、lists、auth， 此外，服务以远程模式运行时还会有 x402。

所有写入操作均须由人工审核

XACTIONS_MCP_REQUIRE_APPROVAL=1 npx xactions-mcp

此后，所有发帖、删除、关注、静音或发送的工具都会保存为草稿，而不会直接执行。可使用 x_list_drafts、 x_approve_draft 和 x_discard_draft 发布或丢弃草稿；也可在 shell 中使用 xactions drafts list、xactions drafts approve <id> 和 xactions drafts discard <id> 操作。

无论是否启用此限制，每个写入操作都会计入按账号计算的滚动 24 小时上限。上限信息保存在 ~/.xactions 下的文件中，因此重启后仍会保留；任何会超出上限的调用都不会发送到 X。

通过 HTTP 运行服务

npx xactions-mcp --http --port 3000    # Streamable HTTP on /mcp

stdio 是默认模式，也是本地客户端所需的模式。--http（或 MCP_TRANSPORT=http）适用于远程和托管客户端；设置 XACTIONS_MCP_TOKEN 后，将要求提供 Authorization: Bearer <token>。

无需配置文件即可安装到 Claude Desktop

.mcpb 安装包包含服务及其依赖项，并会在安装时提示输入会话 Cookie 和工具组。从 最新版本下载，然后将其拖到 Claude Desktop > Settings > Extensions。

示例提示词

“分析 @paulg 的写作风格，并用他的口吻生成 3 条关于初创公司的推文创意” → 抓取推文 → 分析口吻 → 使用 AI 生成内容

“找出我关注的所有没有回关我的人，并按粉丝数排序” → 使用 x_get_following + x_get_followers → 计算差集 → 格式化结果

“比较 @openai、@anthropic 和 @google 的互动指标” → 抓取个人资料和近期推文 → 计算平均互动量 → 展示对比结果

📖 完整设置指南：docs/mcp-setup.md

🎙️ 自主 Space Agent

AI Agent 可以加入实时 X Spaces、聆听对话，并使用语音 AI 自主发言。由 xspace-agent SDK 提供支持。

功能介绍

1. 启动无头浏览器并加入 X Space
2. 实时转录其他发言者的内容（Whisper STT）
3. 使用你选择的大模型（OpenAI、Claude 或 Groq）生成智能回复
4. 通过文本转语音功能（ElevenLabs、OpenAI 或浏览器）在 Space 中朗读回复
5. 处理轮流发言、上下文跟踪和正常关闭

设置

npm install xactions xspace-agent

设置你的凭据：

export X_AUTH_TOKEN="your_auth_token"     # From x.com cookies
export X_CT0="your_ct0_token"            # From x.com cookies
export OPENAI_API_KEY="sk-..."           # Or ANTHROPIC_API_KEY / GROQ_API_KEY

用法

MCP（Claude Desktop / Cursor）：

“以 AI Agent 身份加入这个 Space：https://x.com/i/spaces/1abc123”

Claude 会调用 x_space_join，你的 Agent 随即进入 Space。

Node.js：

import { joinSpace, leaveSpace } from 'xactions/spaces/agent';

await joinSpace({
  url: 'https://x.com/i/spaces/1abc123',
  provider: 'openai',
  systemPrompt: 'You are a helpful AI participant. Keep responses concise.',
});

// Later...
const summary = await leaveSpace();
// { duration: '300s', transcriptions: 42, responses: 8 }

MCP 工具：

📖 完整指南：docs/spaces-agent.md：配置、环境变量、事件、多 Agent 设置和示例。

💻 CLI 参考

包含 56 个按任务分组的命令，以及 85 个子命令。运行 xactions （不带参数）可查看分组界面；运行 xactions help <command> 可查看某个 命令的帮助；运行 xactions completion bash|zsh|fish 可根据实时命令树生成 制表符补全。

从这里开始 quickstart doctor connect login logout mcp-config skills drafts info

xactions quickstart         # guided first run, adapts to what you already have
xactions doctor             # what works right now, and what each failure needs
xactions connect            # log in through a real browser, no DevTools
xactions login --from-browser chrome    # or read cookies from an installed browser
xactions login --cookies-file cookies.txt   # or import a cookie export
xactions skills install --all           # 50 agent skills into Claude Code, Cursor, Codex, Windsurf
xactions drafts list                    # MCP writes waiting for your approval

读取账户信息（无需登录）profile tweets thread media analyze report history snapshot

xactions profile NASA
xactions tweets NASA --limit 50 --output nasa.csv
xactions thread https://x.com/NASA/status/1234567890
xactions media NASA --limit 30
xactions analyze NASA SpaceX          # engagement rate, cadence, content mix, best hour

关注者和受众 followers following non-followers audience crm graph

xactions followers YOUR_USERNAME --limit 1000 --output followers.json
xactions non-followers YOUR_USERNAME  # who does not follow back
xactions audience nasa spacex         # follower overlap between two accounts
xactions graph build nasa             # build and analyse a social graph

搜索和监控 search hashtag scrape platforms monitor sentiment rss stream

xactions search "your brand" --filter latest --limit 50
xactions hashtag ai --limit 50
xactions monitor yourbrand            # sentiment over time
xactions stream start tweet nasa      # tweet, follower or mention streams

创作和增长 engage ai optimize hashtags predict variations evergreen persona schedule bulk

xactions engage USERNAME --like --repost --comment --prompt "supportive, one honest question"
xactions ai generate "shipping fast" --voice nichxbt
xactions evergreen YOUR_USERNAME      # find and recycle top performers
xactions persona run my-persona

自动化 workflow agent notify plugin team dataset

xactions workflow run daily-digest
xactions notify test slack

迁移数据 export export-data archive import convert migrate diff

xactions export YOUR_USERNAME             # profile, tweets, followers, following, bookmarks
xactions archive summary ~/Downloads/twitter-archive.zip
xactions archive migrate ~/Downloads/twitter-archive.zip --to bluesky --execute
xactions diff exports/january exports/february

底层操作 client

xactions client profile nasa          # the raw HTTP client, no browser at all

Agent 和管道的输出标志

所有读取命令均可使用以下全局标志：

xactions profile NASA --compact                              # one record per line, key=value
xactions tweets NASA --limit 200 --fields id,likes,text --compact
xactions tweets NASA --limit 200 --json | jq 'sort_by(-.likes) | .[:5]'

--compact 会以制表符分隔的 key=value 键值对形式输出，不显示颜色或加载动画。 --fields 会按你指定的顺序，仅输出指定的列。 --json 会输出完整的结构化对象，且优先级高于 --output，因此管道输出 不会被静默写入文件。如果同时传入 --compact 和 --json，则以 --compact 为准。

无需账户即可读取公开信息：profile、tweets、thread、media、 analyze、hashtag。搜索、followers、following、non-followers、点赞、 书签和私信均需要会话。完整参考文档： docs/cli-reference.md。

📚 Node.js API

快速入门

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

// Initialize
const browser = await createBrowser({ headless: true });
const page = await createPage(browser);

// Optional: Login for private data
await loginWithCookie(page, 'your_auth_token_cookie');

// Scrape profile
const profile = await scrapeProfile(page, 'elonmusk');

// Scrape followers with progress
const followers = await scrapeFollowers(page, 'elonmusk', {
  limit: 1000,
  onProgress: ({ scraped, limit }) => console.log(`${scraped}/${limit}`)
});

// Export data
await exportToJSON(followers, 'followers.json');
await exportToCSV(followers, 'followers.csv');

await browser.close();

所有抓取器函数

// Profile
scrapeProfile(page, username)

// Followers & Following
scrapeFollowers(page, username, { limit, onProgress })
scrapeFollowing(page, username, { limit, onProgress })

// Tweets
scrapeTweets(page, username, { limit, includeReplies, onProgress })
searchTweets(page, query, { limit, filter: 'latest'|'top' })
scrapeThread(page, tweetUrl)
scrapeHashtag(page, hashtag, { limit, filter })

// Media
scrapeMedia(page, username, { limit })
scrapeLikes(page, tweetUrl, { limit })

// Lists
scrapeListMembers(page, listUrl, { limit })

// Export
exportToJSON(data, filename)
exportToCSV(data, filename)

🌐 不想编写代码？

🔒 安全与最佳实践

注意

建议： 使用 2–5s 延迟 · 将自动操作与手动操作结合 · 先用小批量进行测试

避免： 每天大量关注数千人 · 全天候运行 · 垃圾评论

🛠️ 技术栈

📁 项目结构

列出所有顶层目录，让这里的内容一目了然。

src/            The library. cli/ mcp/ scrapers/ client/ automation/ agents/
                analytics/ streaming/ workflows/ plugins/ portability/ graph/
                a2a/ spaces/ ai/ auth/ scheduler/ notifications/, plus the
                browser console scripts that sit at the top level
api/            Express REST API: routes/ services/ middleware/ realtime/
bin/            Legacy command name (unfollowx), forwards to the CLI
packages/       xactions-mcp, the thin MCP wrapper published to npm
skills/         50 Agent Skills, one directory each
extension/      Chrome and Edge extension (Manifest V3)
integrations/   Third-party glue (n8n and friends)
worker/         Cloudflare Worker entry point
functions/      Cloudflare Pages Functions for the /api/* edge surface

site/           The marketing landing page served at /
dashboard/      The signed-in app shell at /dashboard, plus the generated
                docs, guides, skills and script pages the site serves
public/         Static assets: OG images, robots.txt, sitemap
playground/     Standalone in-browser playground

docs/           Documentation source (Markdown)
tutorials/      Guided walkthroughs
examples/       Runnable programs, from a profile lookup to the MCP draft gate
prompts/        Prompt library for coding agents

tests/          Vitest suite
scripts/        The 95 browser console scripts, plus build, docs and
                maintenance tooling. twitter/ holds standalone console variants
config/         Agent, niche and persona configuration
prisma/         Database schema and migrations
deploy/         Cloudflare and GCP deployment assets
types/          TypeScript declarations
data/           Runtime output (gitignored, keeps a .gitkeep)
archive/        Retired code, kept for reference. Do not modify

python/         xeepy, the Python twin of the library
xspace-agents/  The Spaces agent monorepo

python/ 和 xspace-agents/ 都是自包含项目，位于此仓库中，但各自独立构建。请从它们的 README 开始，而不是从本文档开始。

🤝 参与贡献

欢迎贡献。请参阅 CONTRIBUTING.md，并查看 AGENTS.md，了解仓库结构图和三种运行时上下文。

git clone https://github.com/nirholas/xactions.git
cd xactions && npm install
npm run cli -- profile elonmusk   # run the CLI from the source tree
npm run mcp                       # run the MCP server

需要 Node.js 22.12 或更高版本（engines.node 为 >=22.12）；CI 会在 22 和 24 版本上运行测试套件。提交 PR 前请运行以下三个命令，它们也都会在 CI 中运行：

npm test              # the whole suite, offline, under a minute
npm run lint          # ESLint over the repo
npm run docs:check    # dead links, stale counts, invented CLI commands

贡献者

感谢所有通过代码、错误报告和调查让 XActions 变得更好的人，包括 @RandyLu87、 @ni3a、 @nelsongallardo、 @azeezalhajj570-ai、 @stone-w4tch3r 和 @avner-assistant。完整名单以及每个人的发现或构建内容，请见 CONTRIBUTORS.md。只要提交了准确的错误报告，就能和合并的 PR 一样获得列名机会。

⭐ Star 历史

如果 XActions 帮你省下了每月为 Twitter API 支付的 100 美元，请给仓库点个 Star：这正是开源发展的动力。

📚 完整教程库

XActions 完全免费且开源。 访问 xactions.app 查看交互式教程。

🚀 一键脚本运行器

全新功能！ 无需任何编程知识即可运行脚本：

1. 访问 xactions.app/run.html
2. 将任意蓝色按钮拖到书签栏
3. 前往 x.com 并点击书签脚本

无需控制台，无需代码，无需设置！

按类别快速链接

全部文档

• 快速入门
• CLI 参考
• 自动化指南
• 监控指南

示例文档（完整代码）

⚡ XActions，完整的 X/Twitter 自动化工具包
100% 免费且开源 · Apache 2.0 许可证

xactions.app · GitHub · @nichxbt

   

🌐 通过 HTTP 运行 MCP 服务

stdio 是默认传输方式，也是本地客户端所需的方式。对于远程或托管客户端，同一服务可在 /mcp 上使用 MCP Streamable HTTP， 并提供相同的 154 个工具和相同的工具组筛选功能：

npx xactions-mcp --http --port 3000
# or: MCP_TRANSPORT=http PORT=3000 npx xactions-mcp

设置 XACTIONS_MCP_TOKEN 即可要求客户端提供令牌；客户端随后发送 Authorization: Bearer <token>。

从任意 MCP 客户端连接

{
  "mcpServers": {
    "xactions": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

在 Shell 中检查

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

要将其部署到公开环境？请在 TLS 后运行，并设置 XACTIONS_MCP_TOKEN， 同时优先选择范围较窄的工具集（--tools read,analytics），而不是完整列表。 Dockerfile 和 docs/deployment.md 介绍了 Railway、Fly.io、Docker 和 Cloudflare 的部署方式。

🏆 完整对比矩阵

扩展的逐项功能对比，涵盖所有替代方案。

本对比反映了撰写时（2026 年 8 月）各项目公开 README 中的信息；如果某一列已过时，请提交 issue。

文档

完整文档网站：https://nirholas.github.io/XActions/

• 开始使用介绍安装和首次运行。
• 示例包含可直接复制粘贴的代码片段。

支持这个项目

如果 XActions 为你节省了时间，请在 GitHub 上点星。星标能帮助其他开发者和 AI Agent 找到值得信赖的仓库，而且只需点击一下。

认识可能会用到它的人吗？发布到 X · 分享到 Bluesky · 分享到 LinkedIn · 提交到 Hacker News · 分享到 Reddit

同样为 AI Agent 打造

编码 Agent 和大模型工具可以直接读取此仓库：AGENTS.md、llms.txt、llms-full.txt。将 https://github.com/nirholas/XActions 提供给 Agent，它就能获取所需的上下文。

同一作者的更多项目

• nirholas 的所有仓库：按主题分组的完整目录
• three.ws：面向 3D AI Agent 的平台，支持 Solana 钱包、技能市场和 x402 支付
• 有问题或想法：提交 issue或发起讨论

Contributors