@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