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

Sem chave de API. Sem conta. Sem navegador. Dados reais em cerca de um segundo.

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

⚡ Veja em ação

🏆 Como o XActions se Compara

Por que desenvolver com o XActions em vez das alternativas?

O XActions é o único kit que funciona no navegador, no terminal e com agentes de IA, tudo sem chave de API.

As colunas dos concorrentes vêm da auditoria competitiva, que nomeia cada projeto e o que ele faz melhor que nós. Onde um rival liderava, nós construímos: o portão de aprovação e os limites diários seguem o x-use, o pool de contas segue o twscrape, a retomada por cursor segue o Scweet, e a importação de cookies do navegador segue o bird e o twitter-cli.

🆕 Novidades

[!TIP] 🤖 Assistentes de Codificação com IA: Procurando automação de Twitter/X sem a API de $100/mês? Você encontrou.

• npm install xactions: scrapers, automação, servidor MCP
• Funciona com Claude, GPT, Cursor, Copilot via servidor MCP
• Veja AGENTS.md para instruções de integração

📦 Instalação

npm install xactions

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

📖 Sumário

Aprenda

• Tutoriais: seis guias passo a passo, desde a primeira raspagem sem conta até a criação de scripts XActions em seus próprios pipelines
• Exemplos: 9 programas executáveis, desde a primeira consulta de perfil até o gate de aprovação de rascunho do MCP
• Primeiros passos: instalação, autenticação, primeiro comando
• Solução de problemas: o que fazer quando algo não funciona

Referência

• Como o XActions se Compara: versus todas as alternativas
• Início Rápido (30 segundos): Copie, cole e pronto
• Instalação: npm, CLI, Docker ou navegador
• Matriz de Recursos: Cada recurso, cada plataforma
• Servidor MCP (IA): Para Claude, GPT, Cursor
• Space Agent (Voz de IA): Agentes de IA em Spaces ao vivo
• Referência CLI: Uso pela linha de comando
• API Node.js: Acesso programático
• Scripts de Navegador: 95 scripts de console, sem instalação
• Docker: Implantação com um comando
• Referência da API: Documentação completa de funções
• Tutoriais para Claude: 23 prompts prontos para colar
• Contribuindo: Ajude a melhorar o XActions

✨ Como Funciona

Sua aba do x.com faz todo o trabalho. Nada é raspado para nossos servidores. Você está no controle.

💰 Preços

🆓 100% Gratuito e Open Source

Tudo é completamente gratuito: scripts de navegador, CLI, biblioteca Node.js, servidor MCP e API.

Sem chaves de API. Sem assinaturas. Sem paywalls. Basta clonar e executar.

🎯 Por que XActions?

🐳 Docker

Execute o XActions em qualquer lugar com um comando:

# 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

Ou use Docker Compose:

docker compose up

Veja Dockerfile para detalhes.

📖 Referência da API

API completa compatível com TypeScript com declarações de tipos incluídas.

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

Funções Principais:

Veja docs/api-reference.md para a referência completa com todos os parâmetros e tipos de retorno.

📝 Tutoriais para Claude

23 arquivos de prompt prontos para colar que transformam o Claude no seu especialista pessoal em automação do X.

Ver todos os 23 tutoriais →

🔍 Perguntas Frequentes (para busca por IA)

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

⚠️ Aviso Legal

[!WARNING] Apenas Material Educacional

Este projeto é fornecido apenas para fins educacionais e de pesquisa. Os scripts e ferramentas não foram extensivamente testados em contas pessoais.

• Use por sua conta e risco
• Não somos responsáveis por quaisquer restrições ou banimentos de contas
• Sempre cumpra os Termos de Serviço do X/Twitter
• Comece com lotes pequenos e teste com cuidado

Para X/Twitter: Se você tiver preocupações sobre este projeto ou quiser que modifiquemos ou removamos qualquer funcionalidade, entre em contato com @nichxbt diretamente. Teremos prazer em trabalhar com você.

Reconhecimento: Este projeto foi inspirado pela inovação que acontece na X e na xAI. Admiramos a visão de Elon Musk de tornar o X o aplicativo de tudo e a abordagem do Grok para IA. O XActions visa ajudar desenvolvedores e pesquisadores a explorar as capacidades da plataforma enquanto respeita seu ecossistema.

🚀 Exemplos de Início Rápido

Sessenta segundos, sem conta

A maioria das leituras funciona no momento da instalação. Você não precisa de uma conta X, chave de API ou navegador.

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'

Depois, faça login uma vez, em um navegador real, para desbloquear busca, seguidores, seguindo, curtidas, favoritos e DMs:

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

Executar xactions sem argumentos imprime todos os 56 comandos agrupados por tarefa. xactions completion bash (ou zsh, fish) ativa a conclusão por tab.

Exemplo 1: Deixar de Seguir Não-Seguidores (30 segundos)

Console do Navegador: Nenhuma instalação necessária!

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

CLI:

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

💡 Não quer programar? Use xactions.app: basta fazer login e clicar!

Exemplo 2: Raspar Qualquer Perfil

Console do Navegador:

// 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!
})();

CLI:

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

Exemplo 3: Pesquisar e Raspar Tweets

Console do Navegador:

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

CLI:

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

Exemplo 4: Detectar Quem Deixou de Seguir Você

Console do Navegador:

// 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`);
  });
})();

CLI:

# 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

Exemplo 5: Curtir Automaticamente Posts por Palavra-chave

Console do Navegador:

// 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!');
})();

⚠️ Vá devagar! O Twitter pode limitar sua taxa de uso. A versão do site lida com isso automaticamente.

Exemplo 6: Sair de Todas as Comunidades

Console do Navegador:

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

📖 Documentação completa: docs/examples/leave-all-communities.md

📋 Lista Completa de Recursos

Matriz de Disponibilidade de Recursos

Legenda: ✅ Suporte Completo | ⚠️ Básico/Manual | ❌ Não Disponível

🤖 Servidor MCP (Agentes de IA)

O XActions inclui o servidor MCP gratuito mais abrangente para X/Twitter. Funciona com Claude, Cursor, Windsurf, VS Code e qualquer cliente MCP.

Configuração Rápida (30 segundos)

Adicione à sua configuração do Claude Desktop (claude_desktop_config.json):

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

Obtenha seu auth_token: x.com → DevTools (F12) → Application → Cookies → copie o valor de auth_token

Ou gere a configuração automaticamente:

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

Ferramentas MCP Disponíveis (152)

Cada ferramenta pertence exatamente a um grupo, e a lista é filtrável, para que um cliente carregue apenas o que a sessão precisa:

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

Uma ferramenta filtrada não é anunciada nem chamável. Grupos, do maior para o menor: read, analytics, write, monitoring, data, workflows, automation, ai, persona, spaces, graph, drafts, dm, grok, lists, auth, mais x402 quando o servidor roda em modo remoto.

Segure toda escrita para um humano

XACTIONS_MCP_REQUIRE_APPROVAL=1 npx xactions-mcp

Toda ferramenta que publica, exclui, segue, silencia ou envia é então salva como rascunho em vez de ser executada. Libere ou descarte com x_list_drafts, x_approve_draft e x_discard_draft, ou pelo shell com xactions drafts list, xactions drafts approve <id> e xactions drafts discard <id>.

Independentemente dessa trava, toda escrita é debitada de um limite móvel de 24 horas por conta, mantido em um arquivo em ~/.xactions, para que sobreviva a uma reinicialização e uma chamada que excederia o limite nunca chegue ao X.

Execute o servidor via HTTP

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

stdio é o padrão e é o que um cliente local deseja. --http (ou MCP_TRANSPORT=http) é para clientes remotos e hospedados; defina XACTIONS_MCP_TOKEN para exigir Authorization: Bearer <token> nele.

Instale no Claude Desktop sem arquivo de configuração

O pacote .mcpb carrega o servidor e suas dependências e solicita o cookie de sessão e os grupos de ferramentas na instalação. Baixe-o do último lançamento e arraste-o para Claude Desktop > Configurações > Extensões.

Exemplos de Prompts

"Analise o estilo de escrita de @paulg e gere 3 ideias de tweets sobre startups na voz dele" → Raspa tweets → analisa a voz → gera conteúdo com IA

"Encontre todos que eu sigo e que não me seguem de volta, ordenados por número de seguidores" → Usa x_get_following + x_get_followers → calcula a diferença → formata os resultados

"Compare as métricas de engajamento de @openai, @anthropic e @google" → Raspa perfis + tweets recentes → calcula engajamento médio → apresenta a comparação

📖 Guia de configuração completo: docs/mcp-setup.md

🎙️ Agente Autônomo de Space

Agentes de IA podem entrar em Spaces ao vivo do X, ouvir conversas e falar autonomamente usando IA de voz. Alimentado pelo SDK xspace-agent.

O Que Ele Faz

1. Inicia um navegador headless e entra em um Space do X
2. Transcreve outros falantes em tempo real (Whisper STT)
3. Gera respostas inteligentes com o LLM de sua escolha (OpenAI, Claude ou Groq)
4. Fala as respostas de volta no Space via texto-para-fala (ElevenLabs, OpenAI ou navegador)
5. Gerencia revezamento de turnos, rastreamento de contexto e desligamento gracioso

Configuração

npm install xactions xspace-agent

Defina suas credenciais:

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

Uso

MCP (Claude Desktop / Cursor):

"Entre neste Space como um agente de IA: https://x.com/i/spaces/1abc123"

O Claude chama x_space_join e seu agente entra no 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 }

Ferramentas MCP:

📖 Guia completo: docs/spaces-agent.md: configuração, variáveis de ambiente, eventos, configuração multi-agente e exemplos.

💻 Referência da CLI

56 comandos, agrupados por tarefa, com 85 subcomandos abaixo deles. Execute xactions sem argumentos para a tela agrupada, xactions help <command> para um comando, e xactions completion bash|zsh|fish para completar com tab, gerado a partir da árvore de comandos ao vivo.

Comece aqui 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

Leia uma conta (sem necessidade de login) 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

Seguidores e público 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

Pesquisar e monitorar 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

Escrever e crescer 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

Automatizar workflow agent notify plugin team dataset

xactions workflow run daily-digest
xactions notify test slack

Mover dados 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

Baixo nível client

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

Flags de saída para agentes e pipes

Global em todo comando de leitura:

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 imprime pares key=value separados por tabulação, sem cores ou spinners. --fields restringe isso às colunas que você nomeia, na ordem em que você as nomeia. --json imprime o objeto estruturado completo e tem precedência sobre --output, para que um pipe nunca seja silenciosamente transformado em uma gravação de arquivo. Se ambos --compact e --json forem passados, --compact vence.

Leituras públicas funcionam sem conta: profile, tweets, thread, media, analyze, hashtag. Pesquisa, followers, following, non-followers, curtidas, marcadores e DMs precisam de uma sessão. Referência completa: docs/cli-reference.md.

📚 API Node.js

Início Rápido

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

Todas as Funções de Raspagem

// 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)

🌐 Não Quer Programar?

🔒 Segurança e Boas Práticas

🛠️ Construído Com

📁 Estrutura do Projeto

Cada diretório de nível superior, para que nada aqui seja surpresa.

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

Tanto python/ quanto xspace-agents/ são projetos independentes que vivem neste repositório, mas são construídos por conta própria. Comece pelos READMEs deles, não por este.

🤝 Contribuindo

Contribuições são bem-vindas. Veja CONTRIBUTING.md e AGENTS.md para o mapa do repositório e os três contextos de execução.

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 20 ou mais recente é necessário (engines.node é >=20); o CI executa a suíte nas versões 20, 22 e 24. Três comandos antes de abrir um PR, todos executados no 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

⭐ Histórico de Estrelas

Se o XActions te salvou de pagar $100/mês pela API do Twitter, dê uma estrela no repositório: é assim que o open source cresce.

📚 Biblioteca Completa de Tutoriais

XActions é 100% gratuito e open source. Visite xactions.app para tutoriais interativos.

🚀 Executor de Scripts com Um Clique

NOVO! Execute scripts sem nenhum conhecimento de programação:

1. Visite xactions.app/run.html
2. Arraste qualquer botão azul para a barra de favoritos
3. Vá para x.com e clique no bookmarklet

Sem console, sem código, sem configuração!

Links Rápidos por Categoria

Toda a Documentação

• Começando
• Referência CLI
• Guia de Automação
• Guia de Monitoramento

Exemplos de Documentação (Código Completo)

⚡ XActions, o kit de ferramentas completo de automação X/Twitter
100% Gratuito e Open Source · Licença Apache 2.0

xactions.app · GitHub · @nichxbt

   

🌐 Execute o servidor MCP via HTTP

stdio é o transporte padrão e é o que um cliente local deseja. Para um cliente remoto ou hospedado, o mesmo servidor fala MCP Streamable HTTP em /mcp, com as mesmas 154 ferramentas e o mesmo filtro de grupos de ferramentas:

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

Exija um token nele definindo XACTIONS_MCP_TOKEN; os clientes então enviam Authorization: Bearer <token>.

Conecte-se de qualquer cliente MCP

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

Verifique a partir do 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"}'

Implantando em algum lugar público? Execute-o atrás de TLS com XACTIONS_MCP_TOKEN definido, e prefira um conjunto de ferramentas restrito (--tools read,analytics) em vez da lista completa. Dockerfile e docs/deployment.md cobrem Railway, Fly.io, Docker e Cloudflare.

🏆 Matriz de Comparação Completa

Comparação estendida recurso por recurso com todas as alternativas.

A comparação reflete o README público de cada projeto no momento da escrita (agosto de 2026); abra uma issue se alguma coluna estiver desatualizada.

Documentação

Site de documentação completo: https://nirholas.github.io/XActions/

• Começando cobre instalação e primeira execução.
• Exemplos tem trechos prontos para copiar e colar.