X Twitter Automataion (Search + Post)

Searches and reads X (Twitter): profiles, timelines, mentions, followers, tweet search, trends, lists, communities, and Spaces. Publishes posts after the use...

Security Scan

The skill's code, instructions, and requested environment variable align with a Twitter (X) read-and-post relay client; nothing in the bundle requests unrelated secrets or installs unexpected tooling — but it depends on trusting the remote relay service (api.aisa.one) with your API key and uploaded media.

Purpose & Capability

Name/description (search + post on X/Twitter) match the included CLI scripts and SKILL.md. Required binaries (curl, python3) and the single required env var (AISA_API_KEY) are appropriate for a relay-based Twitter client. The included Python clients target a relay service (api.aisa.one), which is consistent with the skill's stated 'Powered by AIsa' design.

Instruction Scope

Runtime instructions constrain the agent to use the AISA_API_KEY and workspace file paths for media; posting uses an OAuth flow and uploads local media to the relay backend. The scripts will read provided workspace files and environment variables; they do not appear to read arbitrary system files. Note: the python scripts also consult optional env vars (TWITTER_RELAY_BASE_URL, TWITTER_RELAY_TIMEOUT) not listed in requires.env (these have sensible defaults), and the posting guide defaults to --type quote in some flows (a behavioral quirk, not a security incoherence).

Install Mechanism

No install spec is provided (instruction-only install), and the bundle only includes Python scripts. No external downloads or extract steps are present, so there is low additional installation risk.

Credentials

The skill only requires a single credential (AISA_API_KEY), consistent with a relay-based API. The clients will send that key in Authorization headers and sometimes include it in JSON bodies to the relay (the client adds 'aisa_api_key' to POST bodies). The scripts also use optional env vars (TWITTER_RELAY_BASE_URL, TWITTER_RELAY_TIMEOUT) which are not declared as required — this is not critical but worth noting. The main proportionality concern is trust: the AISA_API_KEY and any uploaded media are transmitted to api.aisa.one, so the user must trust that service with those assets.

Persistence & Privilege

The skill is not always-enabled and does not request elevated or persistent platform privileges. It does not modify other skills or system-wide configuration. Autonomous invocation is allowed but is the platform default and not a special privilege here.

Assessment

This skill appears coherent for reading/searching Twitter and posting via an AIsa relay. Before installing: (1) Understand that AISA_API_KEY is the only required secret and will be sent to the relay backend (api.aisa.one) in Authorization headers (and also added to some POST bodies) — only provide a key you trust to be used this way. (2) Posting uploads workspace media files to the relay service; do not pass sensitive local files as attachments. (3) The client accepts optional env vars (TWITTER_RELAY_BASE_URL, TWITTER_RELAY_TIMEOUT) not listed in metadata; you can override the relay URL if you run a private relay. (4) Review and test the OAuth posting flow in a safe account first (posting behavior includes a default '--type quote' in some flows which could change post semantics). If you need stronger isolation, consider issuing a scoped API key for AIsa or running your own relay before granting full access.

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"

Competitor Intel

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

Posting Workflows

This file does not define publishing logic.

If the user asks to send, publish, or reply, or quote on X/Twitter, handle that workflow with ./references/post_twitter.md.

Quick Start

export AISA_API_KEY="your-key"

Core Capabilities

Read Operations (No Login Required)

User Endpoints

# Get user info
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user profile about (account country, verification, username changes)
curl "https://api.aisa.one/apis/v1/twitter/user_about?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Batch get user info by IDs
curl "https://api.aisa.one/apis/v1/twitter/user/batch_info_by_ids?userIds=44196397,123456" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user's latest tweets
curl "https://api.aisa.one/apis/v1/twitter/user/last_tweets?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user mentions
curl "https://api.aisa.one/apis/v1/twitter/user/mentions?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user followers
curl "https://api.aisa.one/apis/v1/twitter/user/followers?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user followings
curl "https://api.aisa.one/apis/v1/twitter/user/followings?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user verified followers (requires user_id, not userName)
curl "https://api.aisa.one/apis/v1/twitter/user/verifiedFollowers?user_id=44196397" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Check follow relationship between two users
curl "https://api.aisa.one/apis/v1/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=BillGates" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Search users by keyword
curl "https://api.aisa.one/apis/v1/twitter/user/search?query=AI+researcher" \
  -H "Authorization: Bearer $AISA_API_KEY"

Tweet Endpoints

# 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 tweets by IDs (comma-separated)
curl "https://api.aisa.one/apis/v1/twitter/tweets?tweet_ids=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet replies
curl "https://api.aisa.one/apis/v1/twitter/tweet/replies?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet quotes
curl "https://api.aisa.one/apis/v1/twitter/tweet/quotes?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet retweeters
curl "https://api.aisa.one/apis/v1/twitter/tweet/retweeters?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet thread context (full conversation thread)
curl "https://api.aisa.one/apis/v1/twitter/tweet/thread_context?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get article by tweet ID
curl "https://api.aisa.one/apis/v1/twitter/article?tweet_id=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

Trends, Lists, Communities & Spaces

# Get trending topics (worldwide)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get list members
curl "https://api.aisa.one/apis/v1/twitter/list/members?list_id=1585430245762441216" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get list followers
curl "https://api.aisa.one/apis/v1/twitter/list/followers?list_id=1585430245762441216" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community info
curl "https://api.aisa.one/apis/v1/twitter/community/info?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community members
curl "https://api.aisa.one/apis/v1/twitter/community/members?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community moderators
curl "https://api.aisa.one/apis/v1/twitter/community/moderators?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community tweets
curl "https://api.aisa.one/apis/v1/twitter/community/tweets?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Search tweets from all communities
curl "https://api.aisa.one/apis/v1/twitter/community/get_tweets_from_all_community?query=AI" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get Space detail
curl "https://api.aisa.one/apis/v1/twitter/spaces/detail?space_id=1dRJZlbLkjexB" \
  -H "Authorization: Bearer $AISA_API_KEY"

Python Client

# User operations
python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk
python3 {baseDir}/scripts/twitter_client.py user-about --username elonmusk
python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk
python3 {baseDir}/scripts/twitter_client.py mentions --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk
python3 {baseDir}/scripts/twitter_client.py verified-followers --user-id 44196397
python3 {baseDir}/scripts/twitter_client.py check-follow --source elonmusk --target BillGates

# Search & discovery
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents"
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents" --type Top
python3 {baseDir}/scripts/twitter_client.py user-search --query "AI researcher"
python3 {baseDir}/scripts/twitter_client.py trends --woeid 1

# Tweet operations
python3 {baseDir}/scripts/twitter_client.py detail --tweet-ids 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py replies --tweet-id 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py quotes --tweet-id 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py retweeters --tweet-id 1895096451033985024
python3 {baseDir}/scripts/twitter_client.py thread --tweet-id 1895096451033985024

# List operations
python3 {baseDir}/scripts/twitter_client.py list-members --list-id 1585430245762441216
python3 {baseDir}/scripts/twitter_client.py list-followers --list-id 1585430245762441216

# Community operations
python3 {baseDir}/scripts/twitter_client.py community-info --community-id 1708485837274263614
python3 {baseDir}/scripts/twitter_client.py community-members --community-id 1708485837274263614
python3 {baseDir}/scripts/twitter_client.py community-tweets --community-id 1708485837274263614
python3 {baseDir}/scripts/twitter_client.py community-search --query "AI"

API Endpoints Reference

Read Endpoints (GET)

Endpoint	Description	Key Params
/twitter/user/info	Get user profile	userName
/twitter/user_about	Get user profile about	userName
/twitter/user/batch_info_by_ids	Batch get users by IDs	userIds
/twitter/user/last_tweets	Get user's recent tweets	userName, cursor
/twitter/user/mentions	Get user mentions	userName, cursor
/twitter/user/followers	Get user followers	userName, cursor
/twitter/user/followings	Get user followings	userName, cursor
/twitter/user/verifiedFollowers	Get verified followers	user_id, cursor
/twitter/user/check_follow_relationship	Check follow relationship	source_user_name, target_user_name
/twitter/user/search	Search users by keyword	query, cursor
/twitter/tweet/advanced_search	Advanced tweet search	query, queryType (Latest/Top), cursor
/twitter/tweets	Get tweets by IDs	tweet_ids (comma-separated)
/twitter/tweet/replies	Get tweet replies	tweetId, cursor
/twitter/tweet/quotes	Get tweet quotes	tweetId, cursor
/twitter/tweet/retweeters	Get tweet retweeters	tweetId, cursor
/twitter/tweet/thread_context	Get tweet thread context	tweetId, cursor
/twitter/article	Get article by tweet	tweet_id
/twitter/trends	Get trending topics	woeid (1=worldwide)
/twitter/list/members	Get list members	list_id, cursor
/twitter/list/followers	Get list followers	list_id, cursor
/twitter/community/info	Get community info	community_id
/twitter/community/members	Get community members	community_id, cursor
/twitter/community/moderators	Get community moderators	community_id, cursor
/twitter/community/tweets	Get community tweets	community_id, cursor
/twitter/community/get_tweets_from_all_community	Search all community tweets	query, cursor
/twitter/spaces/detail	Get Space detail	space_id

Pricing

API	Cost
Twitter read query	~$0.0004

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.