X User Timeline

What it does

The X User Timeline skill allows an AI agent to retrieve recent tweets from a specified Twitter (X) user. It fetches data using the X API, providing details like tweet content, timestamp, public metrics (likes, retweets, replies, views), and author information. This enables agents to analyze user activity on X for research, monitoring, or personalized experiences.

When to use it

• Social Media Research: Gather recent tweets from a specific individual to understand their current interests or activities.
• Brand Monitoring: Track mentions and engagement related to a particular brand or influencer.
• Sentiment Analysis: Collect tweet data for further analysis of public opinion towards a topic or person.
• Personalized Content Recommendations: Inform content suggestions based on a user's X activity (though this is not explicitly supported by the skill itself).

Key capabilities

• Retrieves recent tweets from a specified Twitter username.
• Provides tweet content (text).
• Returns timestamps for each post (created_at).
• Includes public engagement metrics like likes, retweets, and views (public_metrics).
• Offers user information associated with the author of the tweets (author).
• Supports specifying a maximum number of results to retrieve.

Example prompts

• "Get me the 10 most recent tweets from kurtwuckertjr."
• "Retrieve 25 tweets from @elonmusk."
• "Show me the latest activity on X for user @nasa."

Tips & gotchas

• X Bearer Token Required: You must set the X_BEARER_TOKEN environment variable with a valid token obtained from the X developer portal. See the skill's setup instructions for details.
• Rate Limits Apply: The free tier has limitations: 1,500 tweets per month and 10 requests every 15 minutes. Exceeding these limits may result in errors.
• Command Execution: This skill is accessed via a command line script (timeline.sh) which must be executed from within the agent's environment.