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 -> OAuth-approved X/Twitter actions. Post, like, follow, and check relationships only after the user authorizes the workflow.

​
Install

aisa skills install aisa-twitter-post-engage

​
What can agents do with it?

Post tweets

Publish new posts or replies with user authorization.

Like tweets

Like or unlike tweets from a linked account.

Follow users

Follow, unfollow, and check follow relationships.

Engagement workflows

Coordinate lightweight social actions safely.

​
When to use

  • The user wants Twitter/X research plus posting, liking, unliking, following, or unfollowing workflows.
  • The task can use a Python client with AISA_API_KEY and explicit OAuth approval.
  • The workflow needs a single package that covers read, post, and engagement actions.

​
When NOT to use

  • The user needs cookie extraction, password login, or a fully local Twitter client.
  • The workflow must avoid relay-based network calls or media upload through api.aisa.one.
  • The task needs undocumented secrets or browser-derived auth values.

​
Quick Reference

  • Required environment variable: AISA_API_KEY
  • Read client: scripts/twitter_client.py
  • Post client: scripts/twitter_oauth_client.py
  • Engage client: scripts/twitter_engagement_client.py
  • References: references/post_twitter.md, references/engage_twitter.md

​
Setup

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

​
Capabilities

  • Read user, tweet, trend, list, community, and Spaces data.
  • Publish text, image, and video posts after explicit OAuth approval.
  • Like, unlike, follow, and unfollow through the engagement client once authorization exists.

​
Common Commands

python3 scripts/twitter_client.py search --query "AI agents" --type Latest
python3 scripts/twitter_oauth_client.py authorize
python3 scripts/twitter_oauth_client.py post --text "Hello from AIsa"
python3 scripts/twitter_engagement_client.py like-latest --user "@elonmusk"
python3 scripts/twitter_engagement_client.py follow-user --user "@elonmusk"

​
Workflow

  • Use references/post_twitter.md for post, reply, quote, and media-upload actions.
  • Use references/engage_twitter.md for likes, unlikes, follows, and unfollows.
  • Obtain OAuth authorization before any write action.

​
Guardrails

  • Do not ask for passwords, browser cookies, or undocumented secrets.
  • Do not guess target accounts or tweet IDs when multiple candidates exist.
  • Do not claim engagement or posting succeeded unless the relay request returns success.

​
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-post-engage
  4. Start a new agent session so the runtime loads the updated skill instructions.

Link an X Account

Start the OAuth flow for write actions.

Post a Tweet

Endpoint reference for posting.

AIsa Twitter Command Center

Search and engagement workflow hub.