mcpField
T
twitter

twitter

github.com/resciencelabOther1.9k2.1k installsUpdated 1d ago
Repository

About twitter

twitter is a command-line skill for retrieving Twitter/X data through twitterapi.io, aimed at users and agents working with social data. Its scripts cover accounts, posts, lists, communities, Spaces, and trends.

Key features

  1. 01Retrieve user profiles and activity
  2. 02Search and fetch tweets and replies
  3. 03Inspect followers, following, and lists
  4. 04Access community and Space data
  5. 05Fetch worldwide trends

Use cases

  1. 01Review an account's posts and mentions
  2. 02Search tweets with query syntax
  3. 03Inspect community membership and posts
  4. 04Check trends and Twitter Spaces

Install

Copy the command and run it in a terminal.

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

After installing, type/twitterin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.claude-plugin/
plugin.json
scripts/
batch_get_users.py
check_relationship.py
credential.py
get_article.py
get_community_members.py
get_community_moderators.py
get_community_tweets.py
get_community.py
get_followers.py
get_following.py
get_list_followers.py
get_list_members.py
get_space.py
get_trends.py
get_tweet_quotes.py
get_tweet_replies.py
get_tweet_retweeters.py
get_tweet_thread.py
get_tweet.py
get_user_about.py
get_user_info.py
get_user_mentions.py
get_user_tweets.py
get_verified_followers.py
search_community_tweets.py
search_tweets.py
search_users.py
twitter_api.py

Details

From the project README

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

Comments

Markdown supported