twitter

Search and retrieve tweets, user profiles, followers, communities, spaces, and trends from Twitter/X. Covers 30+ commands across user profiles, tweets, lists, communities, and spaces with configurable result limits Supports advanced tweet search with filters for date ranges, media, engagement thresholds, and user-specific queries Includes thread extraction, quote/retweet retrieval, relationship checking, and trend lookups by geographic region Requires API key from twitterapi.io (~$0.15-0.18 per 1,000 requests) set as an environment variable

INSTALLATION
npx skills add https://github.com/resciencelab/opc-skills --skill twitter
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

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"

API: twitterapi.io

  • Auth: X-API-Key header
  • Pricing: ~$0.15-0.18/1k requests
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card