Skip to main content

Documentation Index

Fetch the complete documentation index at: https://aisa.one/docs/llms.txt

Use this file to discover all available pages before exploring further.

View on GitHub -> A command center for X/Twitter work. Search profiles, tweets, trends, lists, communities, and Spaces, then publish through OAuth when approved.

​
Install

aisa skills install aisa-twitter-command-center

​
What can agents do with it?

Search and monitor

Search users, tweets, trends, lists, and communities.

Publish posts

Draft and publish X posts after account authorization.

Engagement actions

Like, follow, reply, and manage social workflows.

DM context

Review and use direct-message context in workflows.

​
When to use

  • The user wants Twitter/X research, monitoring, or content discovery.
  • The user wants to inspect profiles, timelines, mentions, trends, replies, quotes, lists, communities, or Spaces.
  • The user wants to draft or publish posts after explicit OAuth approval without sharing passwords.

​
When NOT to use

  • The user needs password-based login, cookie extraction, or browser credential scraping.
  • The workflow must avoid relay-based calls to api.aisa.one.
  • The request is for unsupported engagement actions not covered by this package.

​
Quick Reference

  • Required environment variable: AISA_API_KEY
  • Read client: scripts/twitter_client.py
  • OAuth and posting client: scripts/twitter_oauth_client.py
  • Posting guide: references/post_twitter.md

​
Setup

export AISA_API_KEY="your-key"
All network calls go to https://api.aisa.one/apis/v1/....

​
Capabilities

  • Read user data, timelines, mentions, followers, followings, and related profile information.
  • Search tweets and users, inspect replies, quotes, retweeters, thread context, trends, lists, communities, and Spaces.
  • Publish text, image, and video posts after explicit OAuth approval.
  • Return an authorization link when posting access has not been approved yet.

​
Common Commands

python3 scripts/twitter_client.py user-info --username elonmusk
python3 scripts/twitter_client.py search --query "AI agents" --type Latest
python3 scripts/twitter_client.py trends --woeid 1
python3 scripts/twitter_oauth_client.py status
python3 scripts/twitter_oauth_client.py authorize
python3 scripts/twitter_oauth_client.py post --text "Hello from AIsa"

​
Posting Workflow

When the user asks to send, publish, reply, or quote on X/Twitter:
  1. Check whether AISA_API_KEY is configured.
  2. If the user intent is to publish, attempt the publish workflow.
  3. If authorization has not been completed, return the OAuth authorization link first.
  4. Use --media-file only for user-provided local workspace files.
  5. Do not claim the post succeeded until the publish command actually succeeds.

​
Guardrails

  • Do not ask for Twitter passwords or browser cookies.
  • Do not invent captions, tweet URLs, or attachment files.
  • Do not default to browser opening unless the user explicitly wants local browser launch.
  • Do not claim external posting succeeded until the API confirms success.

​
Security Notes

  • The workflow is relay-based and sends API requests, OAuth requests, and approved media uploads to api.aisa.one.
  • Required secret: AISA_API_KEY.
  • This workflow does not require passwords, browser cookie extraction, or direct account credential sharing.

​
References

  • See references/post_twitter.md for detailed posting examples and OAuth guidance.

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. Set your key and install the skill: 
    export AISA_API_KEY="your-key"
aisa skills install aisa-twitter-command-center
  4. Start a new agent session so the runtime loads the updated skill instructions.

AIsa Twitter API

X/Twitter data access and social intelligence.

AIsa Twitter Post & Engage

Focused post, like, follow, and reply actions.

Link an X Account

OAuth setup for write actions.