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

# X Intelligence Automation

> Monitor X/Twitter competitors, influencers, trends, and conversations.

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/x-intelligence-automation)

**X intelligence for agents.** Monitor profiles, tweets, trends, and engagement signals through the AIsa relay.

## 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 x-intelligence-automation
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Competitor tracking" icon="eye">
    Track competitor accounts and market reactions.
  </Card>

  <Card title="Influencer monitoring" icon="user-magnifying-glass">
    Follow what key people are posting and discussing.
  </Card>

  <Card title="Trend detection" icon="arrow-trend-up">
    Spot emerging narratives in X/Twitter activity.
  </Card>

  <Card title="Mention analysis" icon="at">
    Summarize mentions, replies, and conversation themes.
  </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"
```

## 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_engagement_client.py follow-user --user "@elonmusk"
```

## Capabilities

* Research Twitter/X accounts, tweets, trends, lists, communities, and Spaces.
* Publish text, image, and video posts after explicit OAuth approval.
* Like, unlike, follow, and unfollow after authorization exists.

## 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 x-intelligence-automation
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="AIsa Twitter API" icon="twitter" href="/agent-skills/aisa-twitter-api">
    X/Twitter data access for intelligence tasks.
  </Card>

  <Card title="Last 30 Days" icon="calendar-days" href="/agent-skills/last30days">
    Multi-source recent evidence research.
  </Card>

  <Card title="Trend Forecast" icon="chart-line" href="/agent-skills/trend-forecast">
    Combine social signal with market and news data.
  </Card>
</CardGroup>