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

# Twitter Command Center Search + Post

> Search X/Twitter and prepare approved posting workflows.

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

**Twitter/X search and posting in one workflow.** Research profiles and tweets, then move into OAuth-approved posting when needed.

## 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 twitter-command-center-search-post
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Social listening" icon="ear-listen">
    Search users, tweets, trends, communities, and lists.
  </Card>

  <Card title="Post drafting" icon="pen-to-square">
    Draft and prepare posts from research context.
  </Card>

  <Card title="Engage safely" icon="shield-check">
    Use linked-account actions only after authorization.
  </Card>

  <Card title="DM-aware workflows" icon="message-circle">
    Include DM context when the workflow needs it.
  </Card>
</CardGroup>

## What Can You Do?

### Monitor Influencers

```text theme={null}
"Get Elon Musk's latest tweets and notify me of any AI-related posts"
```

### Track Trends

```text theme={null}
"What's trending on Twitter worldwide right now?"
```

### Social Listening

```text theme={null}
"Search for tweets mentioning our product and analyze sentiment"
```

### Competitor Intel

```text theme={null}
"Monitor @anthropic and @GoogleAI - alert me on new announcements"
```

## Posting Workflows

This file does not define publishing logic.

If the user asks to send, publish, or reply, or quote on X/Twitter, handle that workflow with `./references/post_twitter.md`.

## Quick Start

```bash theme={null}
export AISA_API_KEY="your-key"
```

## Core Capabilities

### Read Operations (No Login Required)

#### User Endpoints

```bash theme={null}
# Get user info
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user profile about (account country, verification, username changes)
curl "https://api.aisa.one/apis/v1/twitter/user_about?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Batch get user info by IDs
curl "https://api.aisa.one/apis/v1/twitter/user/batch_info_by_ids?userIds=44196397,123456" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user's latest tweets
curl "https://api.aisa.one/apis/v1/twitter/user/last_tweets?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user mentions
curl "https://api.aisa.one/apis/v1/twitter/user/mentions?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user followers
curl "https://api.aisa.one/apis/v1/twitter/user/followers?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user followings
curl "https://api.aisa.one/apis/v1/twitter/user/followings?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get user verified followers (requires user_id, not userName)
curl "https://api.aisa.one/apis/v1/twitter/user/verifiedFollowers?user_id=44196397" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Check follow relationship between two users
curl "https://api.aisa.one/apis/v1/twitter/user/check_follow_relationship?source_user_name=elonmusk&target_user_name=BillGates" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Search users by keyword
curl "https://api.aisa.one/apis/v1/twitter/user/search?query=AI+researcher" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

#### Tweet Endpoints

```bash theme={null}
# Advanced tweet search (queryType is required: Latest or Top)
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Search top tweets
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweets by IDs (comma-separated)
curl "https://api.aisa.one/apis/v1/twitter/tweets?tweet_ids=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet replies
curl "https://api.aisa.one/apis/v1/twitter/tweet/replies?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet quotes
curl "https://api.aisa.one/apis/v1/twitter/tweet/quotes?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet retweeters
curl "https://api.aisa.one/apis/v1/twitter/tweet/retweeters?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get tweet thread context (full conversation thread)
curl "https://api.aisa.one/apis/v1/twitter/tweet/thread_context?tweetId=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get article by tweet ID
curl "https://api.aisa.one/apis/v1/twitter/article?tweet_id=1895096451033985024" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

#### Trends, Lists, Communities & Spaces

```bash theme={null}
# Get trending topics (worldwide)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get list members
curl "https://api.aisa.one/apis/v1/twitter/list/members?list_id=1585430245762441216" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get list followers
curl "https://api.aisa.one/apis/v1/twitter/list/followers?list_id=1585430245762441216" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community info
curl "https://api.aisa.one/apis/v1/twitter/community/info?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community members
curl "https://api.aisa.one/apis/v1/twitter/community/members?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community moderators
curl "https://api.aisa.one/apis/v1/twitter/community/moderators?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get community tweets
curl "https://api.aisa.one/apis/v1/twitter/community/tweets?community_id=1708485837274263614" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Search tweets from all communities
curl "https://api.aisa.one/apis/v1/twitter/community/get_tweets_from_all_community?query=AI" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get Space detail
curl "https://api.aisa.one/apis/v1/twitter/spaces/detail?space_id=1dRJZlbLkjexB" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

## Python Client

```bash theme={null}
# User operations
python3 scripts/twitter_client.py user-info --username elonmusk
python3 scripts/twitter_client.py user-about --username elonmusk
python3 scripts/twitter_client.py tweets --username elonmusk
python3 scripts/twitter_client.py mentions --username elonmusk
python3 scripts/twitter_client.py followers --username elonmusk
python3 scripts/twitter_client.py followings --username elonmusk
python3 scripts/twitter_client.py verified-followers --user-id 44196397
python3 scripts/twitter_client.py check-follow --source elonmusk --target BillGates

# Search & discovery
python3 scripts/twitter_client.py search --query "AI agents"
python3 scripts/twitter_client.py search --query "AI agents" --type Top
python3 scripts/twitter_client.py user-search --query "AI researcher"
python3 scripts/twitter_client.py trends --woeid 1

# Tweet operations
python3 scripts/twitter_client.py detail --tweet-ids 1895096451033985024
python3 scripts/twitter_client.py replies --tweet-id 1895096451033985024
python3 scripts/twitter_client.py quotes --tweet-id 1895096451033985024
python3 scripts/twitter_client.py retweeters --tweet-id 1895096451033985024
python3 scripts/twitter_client.py thread --tweet-id 1895096451033985024

# List operations
python3 scripts/twitter_client.py list-members --list-id 1585430245762441216
python3 scripts/twitter_client.py list-followers --list-id 1585430245762441216

# Community operations
python3 scripts/twitter_client.py community-info --community-id 1708485837274263614
python3 scripts/twitter_client.py community-members --community-id 1708485837274263614
python3 scripts/twitter_client.py community-tweets --community-id 1708485837274263614
python3 scripts/twitter_client.py community-search --query "AI"
```

## API Endpoints Reference

### Read Endpoints (GET)

| Endpoint                                           | Description                 | Key Params                                  |
| -------------------------------------------------- | --------------------------- | ------------------------------------------- |
| `/twitter/user/info`                               | Get user profile            | `userName`                                  |
| `/twitter/user_about`                              | Get user profile about      | `userName`                                  |
| `/twitter/user/batch_info_by_ids`                  | Batch get users by IDs      | `userIds`                                   |
| `/twitter/user/last_tweets`                        | Get user's recent tweets    | `userName`, `cursor`                        |
| `/twitter/user/mentions`                           | Get user mentions           | `userName`, `cursor`                        |
| `/twitter/user/followers`                          | Get user followers          | `userName`, `cursor`                        |
| `/twitter/user/followings`                         | Get user followings         | `userName`, `cursor`                        |
| `/twitter/user/verifiedFollowers`                  | Get verified followers      | `user_id`, `cursor`                         |
| `/twitter/user/check_follow_relationship`          | Check follow relationship   | `source_user_name`, `target_user_name`      |
| `/twitter/user/search`                             | Search users by keyword     | `query`, `cursor`                           |
| `/twitter/tweet/advanced_search`                   | Advanced tweet search       | `query`, `queryType` (Latest/Top), `cursor` |
| `/twitter/tweets`                                  | Get tweets by IDs           | `tweet_ids` (comma-separated)               |
| `/twitter/tweet/replies`                           | Get tweet replies           | `tweetId`, `cursor`                         |
| `/twitter/tweet/quotes`                            | Get tweet quotes            | `tweetId`, `cursor`                         |
| `/twitter/tweet/retweeters`                        | Get tweet retweeters        | `tweetId`, `cursor`                         |
| `/twitter/tweet/thread_context`                    | Get tweet thread context    | `tweetId`, `cursor`                         |
| `/twitter/article`                                 | Get article by tweet        | `tweet_id`                                  |
| `/twitter/trends`                                  | Get trending topics         | `woeid` (1=worldwide)                       |
| `/twitter/list/members`                            | Get list members            | `list_id`, `cursor`                         |
| `/twitter/list/followers`                          | Get list followers          | `list_id`, `cursor`                         |
| `/twitter/community/info`                          | Get community info          | `community_id`                              |
| `/twitter/community/members`                       | Get community members       | `community_id`, `cursor`                    |
| `/twitter/community/moderators`                    | Get community moderators    | `community_id`, `cursor`                    |
| `/twitter/community/tweets`                        | Get community tweets        | `community_id`, `cursor`                    |
| `/twitter/community/get_tweets_from_all_community` | Search all community tweets | `query`, `cursor`                           |
| `/twitter/spaces/detail`                           | Get Space detail            | `space_id`                                  |

## Pricing

| API                | Cost       |
| ------------------ | ---------- |
| Twitter read query | \~\$0.0004 |

Every response includes `usage.cost` and `usage.credits_remaining`.

## Get Started

1. Sign up at [aisa.one](https://aisa.one)
2. Get your API key
3. Add credits (pay-as-you-go)
4. Set environment variable: `export AISA_API_KEY="your-key"`

## Full API Reference

See [API Reference](https://aisa.one/docs/api-reference) for complete endpoint documentation.

## 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 twitter-command-center-search-post
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="AIsa Twitter Command Center" icon="terminal" href="/agent-skills/aisa-twitter-command-center">
    Full command-center workflow.
  </Card>

  <Card title="AIsa Twitter API" icon="twitter" href="/agent-skills/aisa-twitter-api">
    X/Twitter data and intelligence access.
  </Card>

  <Card title="Twitter Autopilot" icon="twitter" href="/agent-skills/twitter-autopilot">
    Broad X/Twitter automation skill.
  </Card>
</CardGroup>