@talocode/x-agent

Open-source X/Twitter growth agent — CLI, SDK, MCP, REST API, and AI agent skill packs.

npm install -g @talocode/x-agent
x-agent auth login --bearer YOUR_X_BEARER_TOKEN

Features

• Search — tweets, users, trends, conversations
• Post — tweets, replies, threads with AI drafting
• Analyze — Phoenix algorithm scoring (19 engagement signals)
• Monitor — watch keywords, accounts, trends
• CLI — full terminal interface
• SDK — XAgentClient for programmatic use
• MCP — 19+ tools for any MCP-compatible agent
• REST API — HTTP server for remote integrations
• Skills — agent skill packs for Claude Code, OpenCode, Cursor

Quick Start

# Install
npm install -g @talocode/x-agent

# Configure X API credentials
x-agent auth login --bearer YOUR_BEARER_TOKEN

# Search tweets
x-agent search tweets "open source AI"

# Draft content
x-agent post draft --topic "building with MCP" --tone educational

# Score against Phoenix algorithm
x-agent analyze score "Your tweet text here"

# Start MCP server
x-agent mcp

# Start REST API
x-agent serve

CLI Reference

| Command | Description | |---------|-------------| | auth login | Configure X API credentials | | auth status | Check auth status | | search tweets | Search tweets by keyword | | search users | Search X users | | search tweet <id> | Get tweet by ID | | profile get | Get user profile | | profile tweets | Get user's recent tweets | | profile followers | Get user's followers | | profile mentions | Get user's mentions | | trends | View trending topics | | post tweet | Post a tweet | | post draft | Generate AI drafts | | post reply | Reply to a tweet | | post improve | Improve tweet engagement | | analyze score | Phoenix algorithm scoring | | analyze post | Full AI analysis | | watch add | Add a watch target | | watch list | List watch targets | | watch check | Check watch targets | | mcp | Start MCP server | | serve | Start REST API server |

SDK Usage

import { XAgentClient } from '@talocode/x-agent'

const client = new XAgentClient({
  tokens: { bearerToken: 'YOUR_TOKEN' }
})

const user = await client.getUser('talocode')
const score = client.scoreTweet('Your tweet text')
const drafts = await client.generateDrafts({ topic: 'AI', tone: 'educational' })

MCP Tools

19 tools for AI agents: get_user, search_tweets, post_tweet, score_tweet, generate_drafts, improve_tweet, analyze_post, and more.

REST API

x-agent serve --port 4173
curl http://localhost:4173/v1/health
curl http://localhost:4173/v1/trends
curl -X POST http://localhost:4173/v1/analyze/score -H 'Content-Type: application/json' -d '{"text":"your tweet"}'

Phoenix Algorithm

Scores posts against X's 19 engagement signals (favorite, reply, retweet, dwell, click, etc.) with weighted predictions and actionable recommendations.

License

MIT