AGENT SKILL

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:

  1. Send your Twitter email, password, and proxy credentials to api.aisa.one
  2. Trust a third-party service with full account access
  3. 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

  1. Default to read-only - Most use cases don't need write access
  2. Separate accounts - Never mix automation with personal accounts
  3. Unique credentials - Use unique passwords for automation accounts
  4. Environment variables - Never hardcode credentials in scripts
  5. Monitor activity - Regularly check your AIsa dashboard
  6. Rotate keys - Periodically rotate API keys
  7. Minimal permissions - Only use write operations when absolutely necessary
  8. Test thoroughly - Always test with test accounts first
  9. Review ToS - Understand both Twitter and AIsa terms of service
  10. 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

javimosch
javimosch/open-claw-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.

★ 0
javimosch
javimosch/open-claw-skills

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).

★ 0
javimosch
javimosch/open-claw-skills

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.

★ 0
javimosch
javimosch/open-claw-skills

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).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

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/.

★ 0