X Research Skill

# X/Twitter Research Skill

Research trending topics, ideas, and conversations on X (Twitter) using twitterapi.io.

## Authentication

API key stored at: `~/.openclaw/secrets/twitterapi.env`

Load before any request:
```bash
source ~/.openclaw/secrets/twitterapi.env
```

Base URL: `https://api.twitterapi.io`

All requests need header: `X-API-Key: $TWITTERAPI_KEY`

## Core Endpoints

### 1. Advanced Tweet Search

Search for tweets matching a query.

```bash
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=solana&queryType=Latest" \
  -H "X-API-Key: $TWITTERAPI_KEY" | jq '.tweets[:5]'
```

**Parameters:**
- `query` — search query (supports operators like `from:`, `to:`, `#hashtag`)
- `queryType` — `Latest` or `Top`
- `cursor` — pagination cursor

**Query operators:**
- `solana defi` — both words
- `"solana defi"` — exact phrase
- `from:solaborada` — from specific user
- `#solana` — hashtag
- `solana -pump` — exclude word
- `solana min_faves:100` — minimum likes

### 2. Get Trends

Get current trending topics.

```bash
curl -s "https://api.twitterapi.io/twitter/trends" \
  -H "X-API-Key: $TWITTERAPI_KEY" | jq '.trends[:10]'
```

### 3. Get User's Recent Tweets

Get latest tweets from a specific account.

```bash
curl -s "https://api.twitterapi.io/twitter/user/last_tweets?userName=solana" \
  -H "X-API-Key: $TWITTERAPI_KEY" | jq '.tweets[:5]'
```

### 4. Get User Info

Get profile info for a user.

```bash
curl -s "https://api.twitterapi.io/twitter/user/info?userName=solana" \
  -H "X-API-Key: $TWITTERAPI_KEY" | jq '.user'
```

## Research Workflow

### Daily Solana Trend Report

Run this workflow every 4-6 hours to generate a trend report.

#### Step 1: Search hot Solana topics

```bash
# General Solana buzz
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=solana&queryType=Top" \
  -H "X-API-Key: $TWITTERAPI_KEY" | jq '.tweets[:20]'

# Solana + AI intersection
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?q...