x-twitter

Original：🇺🇸 English
Translated
66 scriptsChecked / no sensitive code detected

Interact with X (Twitter) API v2. Post tweets, search, engage, moderate, and analyze — all from your AI agent. Full 31-command skill for Twitter/X automation.

7installs
Sourcealberduris/skills
Added on

NPX Install

npx skill4agent add alberduris/skills x-twitter

Tags

Translated version includes tags in frontmatter
twitter-api-automationai-agent-skilloauth-1.0acommand-line-toolsocial-media-integration

SKILL.md Content

View Translation Comparison →
X (Twitter) API v2 skill using the authenticated user's own developer credentials (OAuth 1.0a, pay-per-use). All commands go through a single entry point: 
node <base_directory>/x.js <command> [flags]
. Each command has its own doc file with the full reference for flags and behavior.
[!SETUP] Before first use, check whether 
<base_directory>/node_modules
exists. If it does NOT exist, run 
npm install --prefix <base_directory>
. Then check whether 
<base_directory>/dist/x.js
exists. If it does NOT exist, run 
npm run build --prefix <base_directory>
. NEVER cd into the skill directory; use --prefix to target it without changing your working directory.
[!COMMANDS]
Core: a) 
me
— authenticated user's own account data (profile, metrics, verification). @docs/me.md. b) 
search
— search posts by query (last 7 days or full archive). @docs/search.md. c) 
get
— retrieve one or more posts by ID. @docs/get.md. d) 
post
— create a tweet, reply, or quote tweet. @docs/post.md. e) 
delete
— delete a post owned by the authenticated user. @docs/delete.md.
Engagement: f) 
like
— like a post by tweet ID. @docs/like.md. g) 
unlike
— remove a like from a post. @docs/like.md. h) 
repost
— repost (retweet) a post. @docs/repost.md. i) 
unrepost
— remove a repost. @docs/repost.md.
Social: j) 
user
— look up user(s) by username or ID. @docs/user.md. k) 
follow
— follow a user by username or ID. @docs/follow.md. l) 
unfollow
— unfollow a user. @docs/follow.md. m) 
followers
— list a user's followers. @docs/followers.md. n) 
following
— list accounts a user follows. @docs/followers.md.
Feed: o) 
timeline
— your home timeline (reverse chronological). @docs/timeline.md. p) 
mentions
— posts that mention you. @docs/mentions.md.
Bookmarks: q) 
bookmark
— bookmark a post. @docs/bookmark.md. r) 
unbookmark
— remove a bookmark. @docs/bookmark.md. s) 
bookmarks
— list your bookmarks. @docs/bookmark.md.
Moderation: t) 
mute
— mute a user. @docs/mute.md. u) 
unmute
— unmute a user. @docs/mute.md. v) 
muted
— list muted accounts. @docs/mute.md. w) 
blocked
— list blocked accounts. @docs/blocked.md. x) 
hide-reply
— hide a reply to your post. @docs/hide-reply.md.
Analytics: y) 
likers
— users who liked a post. @docs/likers.md. z) 
reposters
— users who reposted a post. @docs/reposters.md. aa) 
quotes
— quote tweets of a post. @docs/quotes.md. ab) 
count
— count posts matching a query over time. @docs/count.md. ac) 
reposts-of-me
— reposts of your posts by others. @docs/reposts-of-me.md.
Discovery: ad) 
search-users
— search users by query. @docs/search-users.md. ae) 
trending
— trending topics (worldwide or personalized). @docs/trending.md.
[!CREDENTIALS] Four OAuth 1.0a variables are REQUIRED: 
X_API_KEY
, 
X_API_SECRET
, 
X_ACCESS_TOKEN
, 
X_ACCESS_TOKEN_SECRET
. They resolve from the first source that provides them: a) 
.env.local
in cwd, b) 
.env
in cwd, c) 
.env.local
in the plugin directory, d) 
.env
in the plugin directory, e) environment variables. Obtain them from the X Developer Console (Apps > Keys and tokens).