twitter-aisa

AIsa Twitter API Command Center

Run Twitter/X research, monitoring, trend discovery, and approved posting from one AIsa-backed command center.

When to use

• The user wants one Twitter/X skill for 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 centers on likes, follows, replies, or growth actions better handled by aisa-twitter-engagement-suite.

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"

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.

High-Intent Workflows

• Research a creator, competitor, or narrative before writing.
• Monitor a keyword, launch, or watchlist and pull supporting tweets fast.
• Draft and publish a post only after the user explicitly approves OAuth.

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"

Guardrails

• Do not ask for Twitter passwords or browser cookies.
• Do not invent captions, tweet URLs, or attachment files.
• Do not claim external posting succeeded until the API confirms success.

Example Requests

• Research what builders on X are saying about AI agents this week.
• Track reactions to our product launch and pull representative tweets.
• Build a small watchlist of competitor accounts and summarize what changed today.
• Authorize and publish a short Twitter post with an attached image.

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 or browser cookie extraction.