twitter

The twitter skill provides read-only access to Twitter/X data including tweets, user profiles, followers, replies, and trends via the twitterapi.io service. It operates in script-mode, requiring agents to execute Python code to interact with the provided functions.

7.6K
Installs
6
Use cases
5/10
Quality

Is twitter safe to install?

Review the source first

Review the source first: our audit of twitter's source files found 1 shell command, 0 external URLs, file reads and writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill requires executing shell commands and Python scripts to interact with the API. It involves network requests through a proxy service and incurs costs based on data returned from the upstream provider.

How we audit skills: our security review methodology.

Who is this skill for?

Developers and AI agents requiring programmatic access to Twitter/X data for analysis, monitoring, or information retrieval.

What can you do with it?

  • Summarizing specific tweets by ID
  • Retrieving recent posts from a specific user
  • Searching for tweets using advanced operators like cashtags or engagement filters
  • Fetching follower or following lists for a user
  • Monitoring trending topics
  • Extracting long-form X article content

How good is this skill?

Quality score: 5/10. The documentation is clear, provides specific usage examples, and includes critical information regarding cost management and error handling.

What does the skill file contain?

SKILL.md
# Twitter / X (script-mode)

Read-only access to twitterapi.io endpoints. 13 functions covering tweets,
users, followers, replies, threads, quotes, articles, and trends.

All requests go through sc-proxy via `core.http_client.proxied_get`. The
`TWITTER_API_KEY` env var is auto-injected server-side, no local key needed
on the agent machine.

## Script Usage

Standard invocation pattern:

```bash
python3 - <<'EOF'
import sys, json
sys.path.insert(0, "/data/workspace/skills/twitter")
from exports import twitter_user_info, twitter_user_tweets

profile = twitter_user_info(username="vitalikbuterin")...

Frequently asked questions

How do I authenticate with the Twitter API?

The TWITTER_API_KEY environment variable is injected server-side by the proxy, so no local key management is required.

How can I minimize costs when polling for new tweets?

Use the twitter_search_tweets function with time-based filters instead of twitter_user_tweets, as the latter always fetches a 20-tweet page regardless of new content.

What should I do if I receive a 402 error?

A 402 error indicates that upstream proxy credits are exhausted. You should inform the user to top up their account rather than retrying.

How do I handle tweet IDs in my scripts?

Pass tweet IDs as strings to avoid precision loss that occurs with Python integers.

Data sourced from starchild-ai-agent/official-skills on GitHub. Install counts from skills.sh. The summary and security audit are derived from the skill's source files: every command and URL listed appears verbatim in the source.

Related skills