Twitter Search

Fetches up to 1000 tweets via the twitterapi.io service and generates analysis reports with engagement metrics, top content, and influencer breakdowns. You'll need your own API key from twitterapi.io, which you can pass as an environment variable or command line argument. Works well for social listening, trend analysis, or competitor monitoring using Twitter's advanced search syntax (date ranges, specific users, language filters, minimum engagement thresholds). The wrapper script handles dependency checks and makes it easy to run queries without wrestling with Python directly. Output includes clickable tweet URLs and actionable recommendations based on the data patterns it finds.

skills.sh installs: 136
GitHub stars: 674
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sundial-org/awesome-openclaw-skills --skill twitter-search --agent claude-code

Installs into .claude/skills of the current project.

Files

Twitter Search and Analysis

Overview

Search Twitter for keywords using advanced search syntax, fetch up to 1000 relevant tweets, and analyze the data to produce professional reports with insights, statistics, and actionable recommendations.

Prerequisites

API Key Required: Users must configure their Twitter API key from https://twitterapi.io

The API key can be provided in three ways:

Environment variable (recommended): Set TWITTER_API_KEY in your ~/.bashrc or ~/.zshrc
```
echo 'export TWITTER_API_KEY="your_key_here"' >> ~/.bashrc
source ~/.bashrc
```
As an argument: Use --api-key YOUR_KEY with the wrapper script
Passed directly: As first argument to the Python script

Quick Start

Using the Wrapper Script (Recommended)

The wrapper script automatically handles environment variable loading and dependency checks:

# Basic search (uses TWITTER_API_KEY from shell config)
./scripts/run_search.sh "AI"

# With custom API key
./scripts/run_search.sh "AI" --api-key YOUR_KEY

# With options
./scripts/run_search.sh "\"Claude AI\"" --max-results 100 --format summary

SKILL.md on GitHub