Twitter/X Skill — Search and Retrieve Twitter Data

Skill Overview

The Twitter/X skill allows you to search and retrieve Twitter data directly in Claude, including user profiles, tweets, replies, follower lists, communities, Spaces, and trending topics. All data is returned through the twitterapi.io API.

Applicable Scenarios

1. Topic and Public Opinion Monitoring: Search tweets by keyword, with optional restrictions on authors, date ranges, and minimum engagement, to track the spread and discussion surrounding specific content.
2. Account Research and Competitor Analysis: Query any user's profile, followers/following lists, verified followers, and mentions to understand the account's profile and interactions.
3. Content and Community Research: Read complete tweet threads, quotes, and retweeters; research Twitter community members; and track global trending topics.

Core Features

1. User Data Queries: Retrieve user profiles, About information, tweets, and mentions; fetch follower/following lists and verified followers; support batch queries for multiple users; and check the follow relationship between two users.
2. Tweet Search and Retrieval: Support keyword searches in Latest mode, with filtering syntax such as from:username, since:/until: date ranges, -filter:retweets to exclude retweets, filter:media for tweets containing media, and min_faves for minimum likes. Tweets can also be retrieved by ID, including details, replies, quotes, retweeters, complete threads, and long-form Article content.
3. Communities, Spaces, and Trends: Query community details, members, moderators, and community tweets; retrieve Spaces information; and view global trending topics by WOEID.

Frequently Asked Questions

What needs to be prepared before use?

Simply configure the twitterapi.io API key in ~/.zshrc (export TWITTERAPI_API_KEY="your_api_key"). You can then run scripts directly from the skill directory to retrieve data.

Is there a charge for using it?

The skill itself is free, but the underlying twitterapi.io API is a paid service, costing approximately $0.15–$0.18 per 1,000 requests. Actual costs depend on your request volume.

What data can be retrieved, and which filters are supported?

The data covers six major categories: users, tweets, lists, communities, Spaces, and trends. Tweet searches support combined filters based on user (from:), date ranges, excluding retweets, whether tweets contain media, minimum engagement, and other criteria.