X Twitter Api

What it does

This skill provides access to the X (formerly Twitter) API v2, allowing an AI agent to interact with the platform using your authenticated developer credentials (OAuth 1.0a). It enables actions such as retrieving user data, searching for posts, creating tweets, managing likes and reposts, following/unfollowing users, and more. All commands are executed through a central entry point: node x.js <command> [flags].

When to use it

• Automating social media tasks like liking or reposting content.
• Gathering data about your own X account (profile metrics, verification status).
• Searching for specific posts based on keywords or hashtags.
• Managing user relationships – following, unfollowing, muting, blocking.
• Retrieving and managing bookmarks.

Key capabilities

• User Data Retrieval: Access profile information and metrics.
• Search Functionality: Search tweets within the last 7 days or the full archive.
• Post Management: Create new posts (tweets, replies, quote tweets), and delete your own posts.
• Engagement Actions: Like, unlike, repost, and unrepost tweets.
• Social Interactions: Follow, unfollow, list followers/following accounts.
• Feed Access: Retrieve your home timeline and mentions.
• Bookmark Management: Bookmark, unbookmark, and list bookmarks.
• Moderation Tools: Mute, unmute, block users, and hide replies.
• Analytics: Identify users who liked or reposted a specific tweet.

Example prompts

• "Find the latest tweets mentioning 'AI'."
• "Repost the most recent tweet from user @example."
• "Retrieve my profile information."
• "Like this post with ID 1234567890."

Tips & gotchas

• Setup Required: Before first use, you must run npm install and then npm run build within the skill's directory.
• Authentication: This skill uses your authenticated developer credentials; ensure these are properly configured.
• Command Documentation: Each command has its own documentation file (e.g., @docs/me.md) for detailed flag options and behavior. Refer to these files for specific instructions.
• Working Directory: Avoid changing the skill's working directory when using it; use relative paths or the --prefix option instead.