# Twitter

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

Source: https://skillsagentes.com/skills/resciencelab/opc-skills/twitter
Repository: https://github.com/ReScienceLab/opc-skills
Author: resciencelab
License: Apache-2.0
Updated: hace 6 meses
Context cost: 46 tok installed, 702 tok once triggered, 8k tok with every bundled file
Bundle: 30 files, 31 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add ReScienceLab/opc-skills --skill twitter --agent claude-code
```

## What it does

- Consulta perfiles, tuits, respuestas, seguidores/seguidos, comunidades, espacios y tendencias de Twitter/X mediante la API de twitterapi.io
- Ejecuta scripts Python individuales para cada endpoint (usuarios, tuits, listas, comunidades, espacios, tendencias)
- Soporta búsqueda avanzada de tuits con sintaxis tipo from:, since:/until:, -filter:retweets, filter:media, min_faves:

## Use it when

- El usuario menciona Twitter, X, o tuits

## What triggers it

- "Dame la info del perfil de elonmusk en Twitter"
- "Busca tuits sobre AI agent desde 2024-01-01"
- "Muéstrame los seguidores de esta cuenta de X"
- "Consulta las tendencias mundiales en Twitter"

## Before you install

- Requiere una clave de API de twitterapi.io configurada como TWITTERAPI_API_KEY en ~/.zshrc.
- Needs on PATH: python3
- Environment: TWITTERAPI_API_KEY

## Files

- .claude-plugin/plugin.json — 547 B
- SKILL.md — 3 KB
- scripts/batch_get_users.py — 632 B
- scripts/check_relationship.py — 856 B
- scripts/credential.py — 364 B
- scripts/get_article.py — 992 B
- scripts/get_community.py — 962 B
- scripts/get_community_members.py — 889 B
- scripts/get_community_moderators.py — 798 B
- scripts/get_community_tweets.py — 855 B
- scripts/get_followers.py — 958 B
- scripts/get_following.py — 960 B
- scripts/get_list_followers.py — 849 B
- scripts/get_list_members.py — 835 B
- scripts/get_space.py — 1 KB
- scripts/get_trends.py — 1 KB
- scripts/get_tweet.py — 652 B
- scripts/get_tweet_quotes.py — 843 B
- scripts/get_tweet_replies.py — 850 B
- scripts/get_tweet_retweeters.py — 877 B
- scripts/get_tweet_thread.py — 760 B
- scripts/get_user_about.py — 1 KB
- scripts/get_user_info.py — 541 B
- scripts/get_user_mentions.py — 855 B
- scripts/get_user_tweets.py — 1 KB
- scripts/get_verified_followers.py — 1 KB
- scripts/search_community_tweets.py — 882 B
- scripts/search_tweets.py — 1 KB
- scripts/search_users.py — 810 B
- scripts/twitter_api.py — 5 KB

## SKILL.md

Reproduced verbatim from ReScienceLab/opc-skills under Apache-2.0. This section is the upstream document and is in English.

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

---

Skills Agentes — https://skillsagentes.com/skills/resciencelab/opc-skills/twitter