AIsa Twitter Post & Engage

Post, like, follow, and check X/Twitter relationships after authorization.

View on GitHub →

OAuth-approved X/Twitter actions. Post, like, follow, and check relationships only after the user authorizes the workflow.

Install

npx skills

npx skills add AIsa-team/agent-skills --skill aisa-twitter-post-engage

Start a new agent session after installing so the skill loads.

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 and create an API key in the console.
2. Set it in your shell: export AISA_API_KEY="your-key".
3. Install the skill with one of the commands under Install, then start a new agent session.

Related

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.