介绍
# OpenClaw Twitter 🐦
**面向智能体的 Twitter/X 数据访问与自动化功能。由 AIsa 提供支持。**
只需一个 API 密钥。获取完整的 Twitter 情报。
## 🔥 你能做什么？
### 监控影响者 ``` "Get Elon Musk's latest tweets and notify me of any AI-related posts" ```
### 追踪趋势 ``` "What's trending on Twitter worldwide right now?" ```
### 社交聆听 ``` "Search for tweets mentioning our product and analyze sentiment" ```
### 自动互动 ``` "Like and retweet posts from @OpenAI that mention GPT-5" ```
### 竞争对手情报 ``` "Monitor @anthropic and @GoogleAI - alert me on new announcements" ```
## 快速开始
```bash export AISA_API_KEY="your-key" ```
## 核心功能
### 读取操作（无需登录）
```bash # Get user info curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \ -H "Authorization: Bearer $AISA_API_KEY" # Get user's latest tweets curl "https://api.aisa.one/apis/v1/twitter/user/user_last_tweet?userName=elonmusk" \ -H "Authorization: Bearer $AISA_API_KEY" # Advanced tweet search (queryType is required: Latest or Top) curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \ -H "Authorization: Bearer $AISA_API_KEY" # Search top tweets curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \ -H "Authorization: Bearer $AISA_API_KEY" # Get trending topics (worldwide) curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \ -H "Authorization: Bearer $AISA_API_KEY" # Search users by keyword curl "https://api.aisa.one/apis/v1/twitter/user/search_user?keyword=AI+researcher" \ -H "Authorization: Bearer $AISA_API_KEY" # Get tweets by ID curl "https://api.aisa.one/apis/v1/twitter/tweet/tweetById?tweet_ids=123456789" \ -H "Authorization: Bearer $AISA_API_KEY" # Get user followers curl "https://api.aisa.one/apis/v1/twitter/user/user_followers?userName=elonmusk" \ -H "Authorization: Bearer $AISA_API_KEY" # Get user followings curl "https://api.aisa.one/apis/v1/twitter/user/user_followings?userName=elonmusk" \ -H "Authorization: Bearer $AISA_API_KEY" ```
### 写入操作（需要登录）
> ⚠️ **警告**：发布推文需要账号登录。请负责任地使用，以避免触发速率限制或账号被封禁。
```bash # Step 1: Login first (async, check status after) curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \ -H "Authorization: Bearer $AISA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"user_name":"myaccount","email":"[email protected]","password":"xxx","proxy":"http://user:pass@ip:port"}' # Step 2: Check login status curl "https://api.aisa.one/apis/v1/twitter/get_my_x_account_detail_v3?user_name=myaccount" \ -H "Authorization: Bearer $AISA_API_KEY" # Send tweet curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \ -H "Authorization: Bearer $AISA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"user_name":"myaccount","text":"Hello from OpenClaw!"}' # Like a tweet curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \ -H "Authorization: Bearer $AISA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"user_name":"myaccount","tweet_id":"1234567890"}' # Retweet curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_v3" \ -H "Authorization: Bearer $AISA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"user_name":"myaccount","tweet_id":"1234567890"}' # Update profile curl -X POST "https://api.aisa.one/apis/v1/twitter/update_profile_v3" \ -H "Authorization: Bearer $AISA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"user_name":"myaccount","name":"New Name","bio":"New bio"}' ```
## Python 客户端
```bash # User operations python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk # Search & Discovery python3 {baseDir}/scripts/twitter_client.py search --query "AI agents" python3 {baseDir}/scripts/twitter_client.py user-search --keyword "AI researcher" python3 {baseDir}/scripts/twitter_client.py trends --woeid 1 # Post operations (requires login) python3 {baseDir}/scripts/twitter_client.py login --username myaccount --email [email protected] --password xxx --proxy "http://user:pass@ip:port" python3 {baseDir}/scripts/twitter_client.py post --username myaccount --text "Hello!" python3 {baseDir}/scripts/twitter_client.py like --username myaccount --tweet-id 1234567890 python3 {baseDir}/scripts/twitter_client.py retweet --username myaccount --tweet-id 1234567890 ```
## API 端点参考
| 端点 | 方法 | 描述 | |----------|--------|-------------| | `/twitter/user/info` | GET | 获取用户资料 | | `/twitter/user/user_last_tweet` | GET | 获取用户的最新推文 | | `/twitter/user/user_followers` | GET | 获取用户关注者 | | `/twitter/user/user_followings` | GET | 获取用户关注列表 | | `/twitter/user/search_user` | GET | 通过关键词搜索用户 | | `/twitter/tweet/advanced_search` | GET | 高级推文搜索 | | `/twitter/tweet/tweetById` | GET | 根据 ID 获取推文 | | `/twitter/trends` | GET | 获取热门话题 | | `/twitter/user_login_v3` | POST | 登录账号 | | `/twitter/send_tweet_v3` | POST | 发送推文 | | `/twitter/like_tweet_v3` | POST | 点赞推文 | | `/twitter/retweet_v3` | POST | 转发推文 |
## 定价
| API | 成本 | |-----|------| | Twitter 读取查询 | ~$0.0004 | | Twitter 发布/点赞/转发 | ~$0.001 |
每次响应均包含 `usage.cost` 和 `usage.credits_remaining`。
## 开始使用
1. 在 [aisa.one](https://aisa.one) 注册 2. 获取您的 API 密钥 3. 添加额度（按需付费） 4. 设置环境变量：`export AISA_API_KEY="your-key"`
## 完整 API 参考
有关完整的端点文档，请参阅 [API Reference](https://aisa.mintlify.app/api-reference/introduction)。