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

# AIsa Twitter Post & Engage

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

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/aisa-twitter-post-engage)

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

## Install

First, install the AIsa CLI if you have not already:

```bash theme={null}
npm install -g @aisa-one/cli
```

Then install the skill:

```bash theme={null}
aisa skills install aisa-twitter-post-engage
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Post tweets" icon="pen">
    Publish new posts or replies with user authorization.
  </Card>

  <Card title="Like tweets" icon="heart">
    Like or unlike tweets from a linked account.
  </Card>

  <Card title="Follow users" icon="user-plus">
    Follow, unfollow, and check follow relationships.
  </Card>

  <Card title="Engagement workflows" icon="thumbs-up">
    Coordinate lightweight social actions safely.
  </Card>
</CardGroup>

## 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 theme={null}
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 theme={null}
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](https://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:
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install aisa-twitter-post-engage
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="Link an X Account" icon="key" href="/api-reference/twitter/auth_twitter">
    Start the OAuth flow for write actions.
  </Card>

  <Card title="Post a Tweet" icon="pen" href="/api-reference/twitter/post_twitter">
    Endpoint reference for posting.
  </Card>

  <Card title="AIsa Twitter Command Center" icon="terminal" href="/agent-skills/aisa-twitter-command-center">
    Search and engagement workflow hub.
  </Card>
</CardGroup>