Twitter Command Center (Search + Monitor)
Search X (Twitter) in real time, monitor trends, extract posts, and analyze social media data—perfect for social listening and intelligence gathering. Safe read-only operations by default.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- Twitter Command Center (Search + Monitor)
- homepage
- https://openclaw.ai
- metadata
- { "openclaw": { "emoji": "🐦", "requires": { "env": [ "AISA_API_KEY" ], "bins": [ "curl", "python3" ] }, "primaryEnv": "AISA_API_KEY" } }
- description
- Search X (Twitter) in real time, monitor trends, extract posts, and analyze social media data—perfect for social listening and intelligence gathering. Safe read-only operations by default.
03 SKILL.md 正文
OpenClaw Twitter 🐦
Twitter/X data access and automation for autonomous agents. Powered by AIsa.
One API key. Full Twitter intelligence.
⚠️ IMPORTANT SECURITY NOTICE
This skill provides two types of operations:
✅ Read Operations (SAFE - Recommended for Most Users)
- User profiles, tweets, search, trends, followers
- No authentication required
- No credentials transmitted
- Safe for production use
⚠️ Write Operations (HIGH RISK - Use Only with Dedicated Accounts)
- Posting, liking, retweeting
- Requires transmitting email + password + proxy to third-party API
- Security Risk: Full account access granted to
api.aisa.one
⚠️ CRITICAL: Never use write operations with your primary Twitter account. Create dedicated automation accounts only.
🔥 What Can You Do? (Safe Read Operations)
Monitor Influencers
"Get Elon Musk's latest tweets and notify me of any AI-related posts"
Track Trends
"What's trending on Twitter worldwide right now?"
Social Listening
"Search for tweets mentioning our product and analyze sentiment"
Competitor Intelligence
"Monitor @anthropic and @GoogleAI - alert me on new announcements"
User Research
"Find AI researchers in the Bay Area and show their recent work"
Quick Start
export AISA_API_KEY="your-key"
Get your API key at aisa.one
Core Capabilities
✅ Read Operations (No Login Required - Safe)
All read operations are safe and require only your AIsa API key. No Twitter credentials needed.
Get User Information
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"
Search Tweets (Advanced)
Important: queryType parameter is required (Latest or Top)
# Search latest tweets
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 trends (woeid=1)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
-H "Authorization: Bearer $AISA_API_KEY"
Search Users
curl "https://api.aisa.one/apis/v1/twitter/user/search_user?keyword=AI+researcher" \
-H "Authorization: Bearer $AISA_API_KEY"
Get Tweet Details 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"
⚠️ Write Operations (High Risk - Requires Authentication)
🚨 CRITICAL SECURITY WARNING
Write operations require you to:
- Send your Twitter email, password, and proxy credentials to
api.aisa.one - Trust a third-party service with full account access
- Accept responsibility for account security
NEVER use these operations with:
- ❌ Your primary Twitter account
- ❌ Accounts with sensitive data
- ❌ Verified or high-value accounts
- ❌ Accounts you cannot afford to lose
ONLY use with:
- ✅ Dedicated test/automation accounts
- ✅ Unique passwords not used elsewhere
- ✅ Accounts created specifically for this purpose
- ✅ After reviewing AIsa's security policies
You acknowledge and accept all risks by using write operations.
Write Operations API Reference
⚠️ Warning: All write operations require prior authentication via login endpoint.
Step 1: Account Login (Async Operation)
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": "test_automation_account",
"email": "test@example.com",
"password": "unique_password_here",
"proxy": "http://user:pass@proxy-ip:port"
}'
Login is asynchronous - check status after submission.
Step 2: Check Login Status
curl "https://api.aisa.one/apis/v1/twitter/get_my_x_account_detail_v3?user_name=test_automation_account" \
-H "Authorization: Bearer $AISA_API_KEY"
Post a 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": "test_automation_account",
"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": "test_automation_account",
"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": "test_automation_account",
"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": "test_automation_account",
"name": "New Name",
"bio": "New bio"
}'
Python Client
Safe Read Operations
# User operations (safe)
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 (safe)
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
⚠️ Write Operations (High Risk)
Only use with dedicated test accounts:
# Login (use test account only!)
python3 {baseDir}/scripts/twitter_client.py login \
--username test_automation_account \
--email test@example.com \
--password unique_password \
--proxy "http://user:pass@ip:port"
# Check account status
python3 {baseDir}/scripts/twitter_client.py account --username test_automation_account
# Post operations (after login)
python3 {baseDir}/scripts/twitter_client.py post \
--username test_automation_account \
--text "Test post"
python3 {baseDir}/scripts/twitter_client.py like \
--username test_automation_account \
--tweet-id 1234567890
python3 {baseDir}/scripts/twitter_client.py retweet \
--username test_automation_account \
--tweet-id 1234567890
API Endpoints Reference
Read Operations (Safe)
| Endpoint | Method | Description |
|---|---|---|
/twitter/user/info |
GET | Get user profile |
/twitter/user/user_last_tweet |
GET | Get user's recent tweets |
/twitter/user/user_followers |
GET | Get user followers |
/twitter/user/user_followings |
GET | Get user followings |
/twitter/user/search_user |
GET | Search users by keyword |
/twitter/tweet/advanced_search |
GET | Advanced tweet search |
/twitter/tweet/tweetById |
GET | Get tweets by IDs |
/twitter/trends |
GET | Get trending topics |
Write Operations (⚠️ High Risk)
| Endpoint | Method | Description |
|---|---|---|
/twitter/user_login_v3 |
POST | Login to account ⚠️ |
/twitter/send_tweet_v3 |
POST | Send a tweet ⚠️ |
/twitter/like_tweet_v3 |
POST | Like a tweet ⚠️ |
/twitter/retweet_v3 |
POST | Retweet ⚠️ |
Pricing
| Operation | Cost per Request |
|---|---|
| Read operations | ~$0.0004 |
| Write operations | ~$0.001 |
Every API response includes usage.cost and usage.credits_remaining fields.
Getting Started
Step 1: Get API Key
Sign up at aisa.one and obtain your API key.
Step 2: Add Credits
AIsa uses pay-as-you-go pricing. Add credits to your account.
Step 3: Set Environment Variable
export AISA_API_KEY="your-key-here"
Step 4: Start with Read Operations
Begin with safe read operations to familiarize yourself with the API.
Only proceed to write operations if you have a specific need and dedicated test account.
Security Best Practices
- Default to read-only - Most use cases don't need write access
- Separate accounts - Never mix automation with personal accounts
- Unique credentials - Use unique passwords for automation accounts
- Environment variables - Never hardcode credentials in scripts
- Monitor activity - Regularly check your AIsa dashboard
- Rotate keys - Periodically rotate API keys
- Minimal permissions - Only use write operations when absolutely necessary
- Test thoroughly - Always test with test accounts first
- Review ToS - Understand both Twitter and AIsa terms of service
- Have a backup plan - Be prepared for account suspension
Documentation
Support
- API Issues: Contact AIsa support at aisa.one
- Skill Issues: Open issue on GitHub
- Security Concerns: Review AIsa security documentation
Disclaimer
This skill facilitates access to Twitter data through AIsa's API. Write operations require transmitting credentials to a third-party service. Users assume all responsibility and risk. The authors and AIsa are not liable for account suspension, data loss, or security breaches. Use at your own risk.
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.