How do I authenticate the X API skill?

You must provide an X API Bearer Token. This should be stored in an environment variable named X_TOKEN, which the skill uses to authorize its curl requests.

Do I need a user's ID or their username to look them up?

While some endpoints require a numeric User ID, the skill includes a specific lookup tool to convert a username (handle) into a User ID first.

Does this support searching older tweets?

The current implementation uses the Recent Search endpoint, which is limited to tweets posted within the last 7 days.

What happens if I hit X API rate limits?

X API has strict rate limits. If reached, the API will return a 429 error. It is recommended to avoid rapid successive calls and monitor your usage via the X Developer Portal.

Can I post tweets using this skill?

No, this skill provides read-only access to the X API. It is designed for data retrieval, such as reading tweets and profiles, and does not support posting, liking, or retweeting.

X (Twitter) API

Name: X (Twitter) API
Author: vm0-ai

byvm0-ai

•

Social Media Management

Access X (Twitter) data including user profiles, tweets, timelines, and social graphs directly through Claude Code.

This skill integrates the X (Twitter) API v2 into your development workflow, allowing Claude to retrieve and analyze social media data without leaving the terminal. It provides a comprehensive suite of read-only tools to search recent tweets, look up detailed user profiles, and explore social relationships like followers and mentions. Whether you are conducting market research, monitoring brand sentiment, or debugging social integrations, this skill streamlines the process of fetching structured data from the X platform using standard curl commands.

Key Features

01Explore social graphs by listing followers and following accounts

02Retrieve user timelines, mentions, and reverse chronological home feeds

03Fetch detailed tweet metadata including conversation IDs and engagement statistics

04Search recent tweets from the last 7 days using advanced query operators

05Look up user profiles by username or numeric ID with detailed public metrics

0651 GitHub stars

Use Cases

01Gathering user profile data and social metrics for application development

02Conducting real-time research on public sentiment or trending topics

03Analyzing conversation threads and mentions for brand monitoring

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vm0-ai/vm0-skills x

For use in Claude.ai and ChatGPT