twitter

resciencelab/opc-skills

Search and retrieve Twitter/X content including users, tweets, followers, communities, spaces, and trends.

What is twitter?

Access Twitter/X data via twitterapi.io to fetch user profiles, tweets, replies, followers, communities, spaces, and trending topics. Use this skill when you need to retrieve or analyze content from Twitter/X.

Fetch user profiles and account information
Search and retrieve tweets with advanced query syntax
Get tweet replies, quotes, retweets, and threads
Retrieve follower/following lists and relationships
Access community information, members, and tweets
Retrieve spaces and worldwide trends

How to install twitter

npx skills add https://github.com/resciencelab/opc-skills --skill twitter

Prerequisites

Set TWITTERAPI_API_KEY environment variable in ~/.zshrc with your twitterapi.io API key

Claude Code

Cursor

Windsurf

Cline

How to use twitter

1.Set your API key: export TWITTERAPI_API_KEY="your_api_key" in ~/.zshrc
2.Navigate to the skill directory
3.Use python3 scripts/get_user_info.py USERNAME to fetch user profiles
4.Use python3 scripts/search_tweets.py "query" to search tweets with optional filters
5.Use python3 scripts/get_tweet_replies.py TWEET_ID to get replies to a specific tweet
6.Use python3 scripts/get_trends.py --woeid 1 to retrieve worldwide trends
7.Combine search syntax (from:, since:, until:, filter:, min_faves:) for advanced queries

Use cases

Good for

Research what a specific Twitter user has posted recently
Find tweets matching a search query with date ranges and filters
Analyze engagement on a tweet by getting replies and retweets
Monitor trends and popular topics globally
Get community discussions and member information

Who it's for

Social media researchers
Content analysts
Community managers
Data journalists
Marketing professionals

twitter FAQ

What API does this skill use?

It uses twitterapi.io (https://api.twitterapi.io/twitter) with X-API-Key authentication. Pricing is approximately $0.15-0.18 per 1,000 requests.

How do I search tweets from a specific user?

Use the syntax: python3 scripts/search_tweets.py "from:username" to search tweets from that user.

Can I search tweets within a date range?

Yes, use the syntax: python3 scripts/search_tweets.py "query since:2024-01-01 until:2024-12-31" to filter by dates.

How do I get replies to a specific tweet?

Use python3 scripts/get_tweet_replies.py TWEET_ID --limit 20 to retrieve replies, adjusting the limit as needed.

What search filters are available?

Available filters include: from: (user), since:/until: (dates), -filter:retweets (exclude retweets), filter:media (with media), and min_faves: (minimum engagement).

Full instructions (SKILL.md)

Source of truth, from resciencelab/opc-skills.

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:

export TWITTERAPI_API_KEY="your_api_key"

Quick Check:

cd <skill_directory>
python3 scripts/get_user_info.py elonmusk

Commands

All commands run from the skill directory.

User Endpoints

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

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

python3 scripts/get_list_followers.py LIST_ID --limit 20
python3 scripts/get_list_members.py LIST_ID --limit 20

Community Endpoints

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

python3 scripts/get_space.py SPACE_ID
python3 scripts/get_trends.py --woeid 1  # Worldwide

Search Query Syntax

# 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"