tweet-summarizer-lite

# Tweet Summarizer Lite

Use this skill when the user asks to fetch, read, save, or summarize a single tweet from Twitter/X.

## When to Use

✅ **USE this skill when the user:**

- Pastes a Twitter/X URL and wants to read or save it
- Asks to "fetch", "grab", "get", "read", or "summarize" a tweet
- Wants to search their saved tweets by text, author, or date
- Asks what they've saved so far

❌ **DON'T use when:**
- The user wants threads, user timelines, collections, or tags → use **tweet-summarizer-pro**
- Posting or replying to tweets (this skill is read-only)

## How to Use

You run the scripts internally — the user never types `python3`. Respond naturally, then exec the appropriate script and present the output conversationally.

The skill root is at: `~/.openclaw/workspace/skills/tweet-summarizer-lite/`
Run scripts with: `python3 <skill-root>/scripts/<script>.py <args>`

---

## Fetching a Tweet

**Triggers:** "fetch this tweet", "what does this say", "grab this", paste of x.com/*/status/* URL

```bash
python3 scripts/tweet.py <url>
# Skip summary: python3 scripts/tweet.py <url> -ns
```

Auto-detects tweet URLs in the user's message. Shows the tweet text and a short summary.

---

## Searching Saved Tweets

**Triggers:** "search my saved tweets for...", "find tweets about...", "do I have anything saved about..."

```bash
# By text content
python3 scripts/search_tweets.py --text "artificial intelligence"

# By author
python3 scripts/search_tweets.py --source elonmusk

# By date
python3 scripts/search_tweets.py --since 2026-02-01

# List all saved authors
python3 scripts/search_tweets.py --list-sources

# Storage stats
python3 scripts/search_tweets.py --stats
```

---

## Summarizing a Saved Tweet

**Triggers:** "summarize tweet [id]", "give me a summary of that"

```bash
python3 scripts/summarize.py <tweet-id>
```

---

## Troubleshooting

If bird CLI fails or credentials are missing:
```bash
python3 scripts/config.py --check-credentials
```

Tell the user:
> S...

# Tweet Summarizer Lite

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

An **OpenClaw agent skill** — fetch, save, and summarize a single tweet from Twitter/X using natural language. Simple and lightweight: one command, one save folder, no setup.

## How to Use

Once installed, just talk to your agent naturally:

> *"What does this tweet say?"* → paste an x.com URL  
> *"Grab this tweet and save it"*  
> *"Summarize that tweet I saved earlier"*  
> *"Search my saved tweets for AI"*  
> *"Find tweets I saved from @elonmusk"*

Your agent handles everything — no commands needed.

## Features

- 🐦 **Single tweet fetching** — fetch any tweet by URL
- 📊 **Auto-summary** — key points extracted automatically after fetching
- 💾 **Simple storage** — all tweets saved to one flat folder
- 🔍 **Basic search** — find saved tweets by text, author, or date

## Prerequisites

Requires the [`bird`](https://github.com/steipete/bird) CLI and valid Twitter session cookies.

```bash
npm install -g @steipete/bird
```

Set your credentials (see [SECURITY.md](SECURITY.md) for how to get these):

```bash
export AUTH_TOKEN="your_auth_token"
export CT0="your_ct0_token"
```

## Installation

Install via [ClawHub](https://clawhub.ai) or clone manually:

```bash
git clone https://github.com/FranciscoBuiltDat/openclaw-tweet-summarizer-lite.git
```

## Scripts

| Script | Description |
|--------|-------------|
| `tweet.py` | Fetch a single tweet, save it, auto-summarize |
| `search_tweets.py` | Search saved tweets by text, author, or date |
| `summarize.py` | Re-summarize a previously saved tweet |
| `config.py` | Toggle auto-summary on/off |

## Storage

All tweets saved to `~/.openclaw/workspace/data/tweets/index.json` — one flat file, no folders or organization.

## Pro Version

Need threads, user timelines, collections, or folder organization? Upgrade to [tweet-summarizer-pro](https://github.com/FranciscoBuiltDat/openclaw-tweet-su...