Skip to main content
skill CX Codex

twitter · resciencelab — Claude Code skill: what it does, how to install

Retrieves tweets, user profiles, threads, and trends from Twitter or X via twitterapi.io. Helps coding agents pull social data directly into a project.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ReScienceLab/opc-skills --skill twitter -a claude-code
Open on GitHub

What twitter does

This skill provides a set of Python scripts that connect to the third-party service twitterapi.io. It handles fetching user profiles, reading tweet threads, inspecting quotes, checking followers, or searching communities and Spaces. Search queries support filtering by username, date ranges, media presence, and engagement thresholds.

Running these scripts requires python3 and an active API key stored in TWITTERAPI_API_KEY. Without exporting that key in ~/.zshrc, requests fail immediately. The API uses an X-API-Key header, with pricing around 0.15–0.18 per 1k requests.

What it helps with

  • search tweets with engagement or date filters
  • retrieve user profile details and follower lists
  • read tweet replies and discussion threads
  • fetch worldwide trending topics

Example prompts for the agent

  • Search for tweets about AI agent without retweets
  • Get user profile info for elonmusk
  • Fetch worldwide Twitter trends

How to install twitter

1Skills CLI (Vercel)

npx skills add ReScienceLab/opc-skills --skill twitter -a claude-code

2Manually: put the files in place

~/.claude/skills/twitter/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/twitter/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about twitter

How to install twitter in Claude Code?

Run npx skills add ReScienceLab/opc-skills --skill twitter -a claude-code. The skill files will be downloaded and registered for Claude Code.

What does the twitter skill do?

It queries twitterapi.io to fetch profiles, tweets, reply threads, community members, and trends from Twitter and X.

What prerequisites are needed?

You need python3 and an API key from twitterapi.io. Add export TWITTERAPI_API_KEY="your_api_key" to ~/.zshrc.

Source text

SKILL.md · Apache-2.0
---
name: twitter
description: Search and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io. Use when user mentions Twitter, X, or tweets.
---

# Twitter/X Skill

Get user profiles, tweets, replies, followers/following, communities, spaces, and trends from Twitter/X via twitterapi.io.

## Prerequisites

Set API key in `~/.zshrc`:
```bash
export TWITTERAPI_API_KEY="your_api_key"
```

**Quick Check**:
```bash
cd <skill_directory>
python3 scripts/get_user_info.py elonmusk
```

## Commands

All commands run from the skill directory.

### User Endpoints
```bash
python3 scripts/get_user_info.py USERNAME
python3 scripts/get_user_about.py USERNAME
python3 scripts/batch_get_users.py USER_ID1,USER_ID2
python3 scripts/get_user_tweets.py USERNAME --limit 20
python3 scripts/get_user_mentions.py USERNAME --limit 20
python3 scripts/get_followers.py USERNAME --limit 100
python3 scripts/get_following.py USERNAME --limit 100
python3 scripts/get_verified_followers.py USERNAME --limit 20
python3 scripts/check_relationship.py USER1 USER2
python3 scripts/search_users.py "query" --limit 20
```

### Tweet Endpoints
```bash
python3 scripts/get_tweet.py TWEET_ID [TWEET_ID2...]
python3 scripts/search_tweets.py "query" --type Latest --limit 20
python3 scripts/get_tweet_replies.py TWEET_ID --limit 20
python3 scripts/get_tweet_quotes.py TWEET_ID --limit 20
python3 scripts/get_tweet_retweeters.py TWEET_ID --limit 50
python3 scripts/get_tweet_thread.py TWEET_ID
python3 scripts/get_article.py TWEET_ID
```

### List Endpoints
```bash
python3 scripts/get_list_followers.py LIST_ID --limit 20
python3 scripts/get_list_members.py LIST_ID --limit 20
```

### Community Endpoints
```bash
python3 scripts/get_community.py COMMUNITY_ID
python3 scripts/get_community_members.py COMMUNITY_ID --limit 20
python3 scripts/get_community_moderators.py COMMUNITY_ID
python3 scripts/get_community_tweets.py COMMUNITY_ID --limit 20
python3 scripts/search_community_tweets.py "query" --limit 20
```

### Other Endpoints
```bash
python3 scripts/get_space.py SPACE_ID
python3 scripts/get_trends.py --woeid 1  # Worldwide
```

## Search Query Syntax

```bash
# Basic search
python3 scripts/search_tweets.py "AI agent"

# From specific user
python3 scripts/search_tweets.py "from:elonmusk"

# Date range
python3 scripts/search_tweets.py "AI since:2024-01-01 until:2024-12-31"

# Exclude retweets
python3 scripts/search_tweets.py "AI -filter:retweets"

# With media
python3 scripts/search_tweets.py "AI filter:media"

# Minimum engagement
python3 scripts/search_tweets.py "AI min_faves:1000"
```

## API: twitterapi.io
- Base URL: https://api.twitterapi.io/twitter
- Auth: X-API-Key header
- Pricing: ~$0.15-0.18/1k requests
- Docs: https://docs.twitterapi.io/

© ReScienceLab · Apache-2.0 · ReScienceLab/opc-skills

Similar skills

All skills for Data and databases →

twitter by other authors comes first.

From the same set10

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor