home / skills / resciencelab / opc-skills / twitter

twitter skill

safe

This skill retrieves Twitter/X user profiles, tweets, spaces, trends, and interactions via twitterapi.io, enabling rapid social insights.

npx playbooks add skill resciencelab/opc-skills --skill twitter

Review the files below or copy the command above to add this skill to your agents.

Files (30)

SKILL.md

2.7 KB

---
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/

Overview

This skill connects to Twitter/X via twitterapi.io to search and retrieve profiles, tweets, replies, followers, communities, Spaces, and trends. It is built for quick access to public Twitter data and supports targeted searches, user lookups, and conversation threading. Use it whenever a user mentions Twitter, X, tweets, or requests social listening or profile data.

How this skill works

The skill calls twitterapi.io endpoints with an API key supplied in the environment to fetch user objects, timelines, tweet conversation trees, media, community and Space details, and trending topics. It supports search query modifiers (date ranges, media filters, min engagement, exclude retweets) and paginated results for large lists like followers or retweeters. Responses are returned as structured JSON that can be filtered, summarized, or used to build insights.

When to use it

Identify a user’s recent tweets, replies, and public profile data.
Search for tweets matching a keyword, date range, or engagement threshold.
Map conversations: get replies, quotes, and full tweet threads.
Compile followers, following, or verified follower lists for research.
Retrieve community posts, moderators, or Space details for moderation or engagement analysis.

Best practices

Set the twitterapi.io API key in your environment before using the skill.
Use query filters (from:, since:, until:, -filter:retweets, filter:media) to limit noise and reduce API usage.
Paginate results and set sensible limits to control cost; twitterapi.io charges per request volume.
Handle rate limits and errors gracefully, and cache frequently requested user or trend data.
Respect privacy and Twitter’s terms: avoid collecting or exposing private data and rate-limit scraping behavior.

Example use cases

Fetch a public user’s recent tweets and summarize their topical focus for outreach.
Track a brand campaign by searching tweets with campaign hashtags and min_faves to find high-engagement posts.
Reconstruct a tweet thread and collect replies and quotes for sentiment analysis or moderation.
List verified followers of a high-profile account to identify potential influencers or partners.
Pull worldwide or region-specific trends to inform content planning and SEO topics.

FAQ

How do I authenticate the skill?

Provide your twitterapi.io API key via an environment variable and send it as the X-API-Key header for requests.

Can I retrieve private tweets or protected accounts?

No. The skill only accesses public data available through twitterapi.io and respects account privacy settings.