v1.0.3 to git:20260722.0693ae0

---

name: aisa-twitter-post-engage

description: Search X/Twitter profiles, tweets, trends, and approved engagement actions through the AIsa relay. Use when the user asks for Twitter/X research, posting, likes, follows, or related workflows without sharing passwords.

license: Apache-2.0

compatibility: Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one.

metadata:

aisa:

emoji: 🐦

requires:

bins:

- python3

env:

- AISA_API_KEY

primaryEnv: AISA_API_KEY

compatibility: Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one.

---

# AIsa Twitter Post Engage

Search X/Twitter profiles, tweets, trends, and approved engagement actions through the AIsa relay.

## 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

```bash

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

```bash

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.