AIsa Twitter API

Search X (Twitter) in real time, extract relevant posts, and publish tweets/replies instantly—perfect for social listening, engagement, and rapid content ops.

Security Scan

The skill's capabilities match a Twitter-proxy service, but it asks you to send account credentials and proxy credentials to a third-party API (api.aisa.one) while the source is unknown — that mismatch and privacy risk warrant caution.

Purpose & Capability

Name/description, the included Python client, and the curl examples consistently target a third‑party Twitter proxy API (api.aisa.one). Requiring curl/python3 and an AISA_API_KEY is coherent for a proxy service. Minor mismatch: the declared homepage (openclaw.ai) and the API host (api.aisa.one) are different domains and the skill source is 'unknown', which makes provenance unclear.

Instruction Scope

SKILL.md and the client instruct users to perform a 'login' operation that sends plain Twitter credentials (username/email/password) and optional proxy credentials (including user:pass@host) to api.aisa.one. Those instructions effectively transmit sensitive account and proxy credentials to a third party — behavior beyond simple read-only social listening. The instructions do not require or describe OAuth flows or explicit user consent handling.

Install Mechanism

No install spec; this is instruction-only plus a small Python client included. Required binaries (curl, python3) are proportionate to the provided examples and client. No remote downloads or extract steps are present.

Credentials

The skill only declares a single required env var (AISA_API_KEY), which is coherent for a proxy API. However, the runtime instructions and client require supplying Twitter account credentials and proxy credentials as parameters — sensitive secrets that are not declared in requires.env. The skill therefore encourages users to expose account passwords and proxy auth to an external service, which is disproportionate to typical safe integrations that use OAuth tokens or direct API keys.

Persistence & Privilege

always is false and the skill does not request system-wide changes or access to other skills' configs. It does allow autonomous invocation (default), which increases blast radius if the skill were malicious, but autonomous invocation alone is platform default and not flagged here.

What to consider before installing

This skill routes Twitter operations through a third-party API (api.aisa.one) and asks you to supply your Twitter account credentials (and possibly proxy credentials) to that service. Before installing: 1) Verify the maintainer and the API operator (are aisa.one and openclaw.ai the same, trustworthy organization?), 2) Ask whether the service supports OAuth instead of collecting passwords, and request a privacy/security policy describing credential handling and retention, 3) Never reuse primary account credentials — if you must test, use a throwaway account, and avoid sharing proxy credentials with embedded user:pass if possible, 4) Consider preferring integrations that use official Twitter/X OAuth tokens or well-known vetted providers. If you cannot verify the operator and credential handling, treat this skill as high-risk and do not provide real account credentials.

OpenClaw Twitter 🐦

Twitter/X data access and automation for autonomous agents. Powered by AIsa.

One API key. Full Twitter intelligence.

🔥 What Can You Do?

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"

Automated Engagement

"Like and retweet posts from @OpenAI that mention GPT-5"

Competitor Intel

"Monitor @anthropic and @GoogleAI - alert me on new announcements"

Quick Start

export AISA_API_KEY="your-key"

Core Capabilities

Read Operations (No Login Required)

# 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"

Write Operations (Requires Login)

⚠️ Warning: Posting requires account login. Use responsibly to avoid rate limits or account suspension.

# 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":"[e-mail]","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 Client

# 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 [e-mail] --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 Endpoints Reference

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

API	Cost
Twitter read query	~$0.0004
Twitter post/like/retweet	~$0.001

Every response includes usage.cost and usage.credits_remaining.

Get Started

1. Sign up at aisa.one
2. Get your API key
3. Add credits (pay-as-you-go)
4. Set environment variable: export AISA_API_KEY="your-key"

Full API Reference

See API Reference for complete endpoint documentation.