Content
# @talocode/x-agent
Open-source X/Twitter growth agent — CLI, SDK, MCP, REST API, and AI agent skill packs.
```bash
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
```bash
# 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
```typescript
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
```bash
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
