X Alpha Scout

# X Alpha Scout

Your agent's X/Twitter alpha scanner. Two things: daily reports and on-demand analysis.

## Prerequisites

**Environment variables:**
```bash
export X_AUTH_TOKEN="your_twitter_auth_token"
export X_CT0="your_twitter_ct0_cookie"
```

**Verify:**
```bash
bird whoami --auth-token "$X_AUTH_TOKEN" --ct0 "$X_CT0"
```

---

## Feature 1: Daily Alpha Report (Auto at 00:00 UTC)

**User says:** "Run my daily alpha" or "Get today's report"

**What you do:**

```bash
# Scan for overnight alpha
bird search "(buying OR bought OR aping OR loading up) (ticker OR token OR \$)" -n 25
bird search "(minting OR mint OR free mint) NFT" -n 20
bird search "(just launched OR stealth launch) token" -n 15
bird search "(gem OR undervalued OR 100x) crypto" --min-likes 10 -n 15
```

**Generate report in this exact format:**

```markdown
# 🦅 Alpha Report — Feb 10, 2026

### 1. Good Morning
[Simple greeting]

### 2. Crypto Market Update
- BTC: $[price] ([+/-]% 24h)
- ETH: $[price] ([+/-]% 24h)
- SOL: $[price] ([+/-]% 24h)
- Fear & Greed Index: [value] ([Extreme Fear/Fear/Neutral/Greed/Extreme Greed])

### 3. News of the Day
- [Major Web3 announcement](https://x.com/...) — Brief summary
- [Regulation/news affecting market](https://x.com/...) — Brief summary
- [Any market-moving world news](https://x.com/...) — Brief summary

### 4. Crypto Twitter (CT)
- Main narrative: [What's the hot topic today?]
- Key trends: [New meta, drama, or shifts]
- Notable accounts: [Who's driving conversation]

### 5. NFTs Market Update
**ETH Eco:** [2-3 sentence paragraph on top ETH ecosystem updates — NFTs, tokens, protocols. Skip if nothing significant.]

**Bitcoin Eco:** [2-3 sentence paragraph on top Bitcoin/Ordinals market. Skip if nothing significant.]

**Sol Eco:** [2-3 sentence paragraph on top Solana ecosystem — NFTs, DeFi, memes. Skip if nothing significant.]

**Notable Mints:**
- Minting Today: [@account1](https://x.com/account1) [@account2](https://x.com/account2) [@account3](https://x.com/...

# X Alpha Scout

Turn your AI agent into an alpha-hunting machine. This skill enables agents to scan X/Twitter for crypto calls, NFT mints, and deliver daily intelligence reports.

## What It Does

- **Comprehensive Daily Alpha Reports** — Auto-generated at 00:00 UTC with market updates, news, CT sentiment, NFT ecosystem coverage (ETH/BTC/SOL), alpha from reputable figures, and warnings
- **On-Demand Analysis** — Ask about any token/NFT and get CT sentiment breakdown

## Perfect For

- Agents that need daily market intelligence
- Traders who want CT sentiment on specific plays
- Anyone wanting structured alpha without the noise

## Installation

1. **Install bird** — X/Twitter CLI tool (by founder of OpenClaw)
   ```bash
   # Via Homebrew (macOS/Linux)
   brew install steipete/tap/bird
   
   # Or download from releases (if brew doesn't work)
   # https://github.com/steipete/bird/releases
   ```
   
2. **Get X credentials:**
   - Auth token (`X_AUTH_TOKEN`)
   - CT0 cookie (`X_CT0`)
   
3. **Verify access:**
   ```bash
   bird whoami --auth-token "$X_AUTH_TOKEN" --ct0 "$X_CT0"
   ```

## Usage

**Daily Report:**
> "Run my daily alpha"

**On-Demand Analysis:**
> "What do you think of $PEPEAI?"
> "Analyze Pudgy Penguins"

## Example Daily Report

```markdown
# 🦅 Alpha Report — Feb 10, 2026

### 1. Good Morning
Rise and grind — market's showing some life.

### 2. Crypto Market Update
- BTC: ~$69,400 (+3% 24h)
- ETH: ~$2,318 (-3% 24h)
- SOL: ~$86 (stable)
- Fear & Greed Index: 9 (Extreme Fear)

### 3. News of the Day
- [Pudgy Penguins teases Visa credit card](https://x.com/coingecko/status/...)
- [Tether announces LayerZero investment](https://x.com/PeteyK/status/...)

### 4. Crypto Twitter (CT)
- Main narrative: AI agents running — $BANKR launchpad live
- @pudgypenguins dominating with Visa teaser

### 5. NFTs Market Update

**ETH Eco:** Pudgy Penguins holding at ~4.5 ETH floor. D3lMundos pumped 138% with whale buying.

**Bitcoin Eco:** Taproot Wizards quiet — no majo...