内容
# @talocode/x-agent
开源 X/Twitter 增长代理 — 命令行界面、软件开发工具包、MCP、REST API 和 AI 代理技能包。
```bash
npm install -g @talocode/x-agent
x-agent auth login --bearer 您的_X_BEARER_TOKEN
```
## 功能
- **搜索** — 推文、用户、趋势、对话
- **发布** — 推文、回复、线程，带有 AI 起草
- **分析** — Phoenix 算法评分（19 个参与度信号）
- **监控** — 关注关键词、账户、趋势
- **命令行界面** — 完整的终端界面
- **软件开发工具包** — `XAgentClient` 用于编程使用
- **MCP** — 19+ 适用于任何 MCP 兼容代理的工具
- **REST API** — 用于远程集成的 HTTP 服务器
- **技能** — 适用于 Claude Code、OpenCode、Cursor 的代理技能包
## 快速开始
```bash
# 安装
npm install -g @talocode/x-agent
# 配置 X API 凭证
x-agent auth login --bearer 您的_BEARER_TOKEN
# 搜索推文
x-agent search tweets "开源 AI"
# 起草内容
x-agent post draft --topic "使用 MCP 构建" --tone 教育
# 针对 Phoenix 算法评分
x-agent analyze score "您的推文文本"
# 启动 MCP 服务器
x-agent mcp
# 启动 REST API
x-agent serve
```
## 命令行界面参考
| 命令 | 描述 |
|---------|-------------|
| `auth login` | 配置 X API 凭证 |
| `auth status` | 检查身份验证状态 |
| `search tweets` | 按关键词搜索推文 |
| `search users` | 搜索 X 用户 |
| `search tweet <id>` | 按 ID 获取推文 |
| `profile get` | 获取用户资料 |
| `profile tweets` | 获取用户的近期推文 |
| `profile followers` | 获取用户的关注者 |
| `profile mentions` | 获取用户的提及 |
| `trends` | 查看热门话题 |
| `post tweet` | 发布推文 |
| `post draft` | 生成 AI 起草 |
| `post reply` | 回复推文 |
| `post improve` | 提高推文参与度 |
| `analyze score` | Phoenix 算法评分 |
| `analyze post` | 完整的 AI 分析 |
| `watch add` | 添加监视目标 |
| `watch list` | 列出监视目标 |
| `watch check` | 检查监视目标 |
| `mcp` | 启动 MCP 服务器 |
| `serve` | 启动 REST API 服务器 |
## 软件开发工具包用法
```typescript
import { XAgentClient } from '@talocode/x-agent'
const client = new XAgentClient({
tokens: { bearerToken: '您的_TOKEN' }
})
const user = await client.getUser('talocode')
const score = client.scoreTweet('您的推文文本')
const drafts = await client.generateDrafts({ topic: 'AI', tone: '教育' })
```
## MCP 工具
19 个适用于 AI 代理的工具：get_user、search_tweets、post_tweet、score_tweet、generate_drafts、improve_tweet、analyze_post 等。
## 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":"您的推文"}'
```
## Phoenix 算法
根据 X 的 19 个参与度信号（收藏、回复、转发、停留时间、点击等）对帖子进行评分，并提供加权预测和可行的建议。
## 许可证
MIT
