SuperAPI AI Directory

x-operations

General & other

View repository

Updated 10-15 21:35

About this skill

Cross-Channel X (Twitter) Operations

QVerisBot has a built-in X (Twitter) plugin already configured with OAuth credentials. All X operations go through this plugin via the message tool's x-* actions. You do not need to call any external API, use browser automation, or search for third-party tools.

Critical: Understand How This Works

The X plugin is a platform-level service, not a channel-bound feature. It uses pre-configured OAuth credentials to execute X operations on behalf of the user.

Your current conversation channel is just where you receive instructions. X operations always execute through the X plugin regardless of whether you are talking to the user on Feishu, Telegram, CLI, Web UI, or X itself.

Conversation channel User says What you do
Feishu "Help me post a tweet" message({ action: "x-post", message: "..." })
Feishu "Search AI-related tweets" message({ action: "x-search", query: "AI" })
Telegram "Follow @elonmusk" message({ action: "x-follow", target: "@elonmusk" })
CLI "Look at @openai's tweets" message({ action: "x-timeline", target: "@openai" })
Web UI "Retweet this tweet" message({ action: "x-repost", target: "<tweet>" })
X (mention) "@bot follow @xxx" message({ action: "x-follow", target: "@xxx" })

There is no restriction preventing X operations from non-X channels. The X plugin handles everything internally.

Available Actions (15 total)

Write Actions (require actionsAllowFrom permission)

Action Description Required params
x-post Post a new standalone tweet message (text, max 280 chars)
x-reply Reply to / comment on a tweet target (tweet URL or ID), message (max 280 chars)
x-quote Quote tweet (retweet with comment) target (tweet URL or ID), message (max 280 chars)
x-like Like a tweet target (tweet URL or tweet ID)
x-unlike Unlike a tweet target (tweet URL or tweet ID)
x-repost Repost (retweet) target (tweet URL or tweet ID)
x-unrepost Undo repost (unretweet) target (tweet URL or tweet ID)
x-follow Follow a user target (username or user ID)
x-unfollow Unfollow a user target (username or user ID)
x-dm Send a direct message target (username or user ID), message (text)

Read Actions (no actionsAllowFrom permission needed)

Action Description Required params
x-search Search recent tweets by keyword query (search string), optional maxResults
x-timeline Get a user's recent tweets target (username or user ID), optional maxResults
x-tweet-info Get tweet details with metrics target (tweet URL or tweet ID)
x-user-info Look up a user's profile target (username)
x-me Get current authenticated account (no params needed)

Target formats

  • Username: @elonmusk or elonmusk
  • User ID: 44196397
  • Tweet URL: https://x.com/user/status/123456789 or https://twitter.com/user/status/123456789
  • Tweet ID: 123456789

Optional parameter

  • accountId: specify which X account to use (only for multi-account setups)

Usage Examples

Post a new tweet

message({ action: "x-post", message: "Hello world!" })

Reply to a tweet

message({
  action: "x-reply",
  target: "https://x.com/user/status/1234567890",
  message: "Great insight!"
})

Quote tweet (retweet with comment)

message({
  action: "x-quote",
  target: "https://x.com/user/status/1234567890",
  message: "This is spot on! Highly recommended read."
})

Search tweets

message({ action: "x-search", query: "AI agents", maxResults: 10 })

Returns a list of tweets with text, author info, and engagement metrics (likes, retweets, replies, etc.).

Get user timeline

message({ action: "x-timeline", target: "@openai", maxResults: 5 })

Get tweet details with metrics

message({ action: "x-tweet-info", target: "https://x.com/user/status/1234567890" })

Returns: text, author, creation time, like count, retweet count, reply count, quote count, impression count.

Look up user profile

message({ action: "x-user-info", target: "@elonmusk" })

Get current account info

message({ action: "x-me" })

Like + Repost a tweet

message({ action: "x-like", target: "https://x.com/user/status/1234567890" })
message({ action: "x-repost", target: "https://x.com/user/status/1234567890" })

Follow users

message({ action: "x-follow", target: "@openai" })
message({ action: "x-follow", target: "@anthropic" })

Send a direct message

message({ action: "x-dm", target: "@username", message: "Hey!" })

Cross-Channel Workflow Examples

From Feishu: "Search popular AI tweets, like the top 3"

// 1. Search
message({ action: "x-search", query: "AI", maxResults: 10 })
// 2. Analyze results — pick top 3 by metrics.likeCount + metrics.retweetCount
// 3. Like top 3
message({ action: "x-like", target: "<tweet_id_1>" })
message({ action: "x-like", target: "<tweet_id_2>" })
message({ action: "x-like", target: "<tweet_id_3>" })

From Feishu: "Look at what @elonmusk recently posted, find the most popular one, and help me comment"

// 1. Get timeline
message({ action: "x-timeline", target: "@elonmusk", maxResults: 10 })
// 2. For each tweet, get details to see engagement metrics
message({ action: "x-tweet-info", target: "<tweet_id>" })
// 3. Pick the hottest one, compose a relevant reply
message({
  action: "x-reply",
  target: "<hottest_tweet_id>",
  message: "Your thoughtful comment (max 280 chars)"
})

From Telegram: "Quote this tweet with my thoughts"

message({
  action: "x-quote",
  target: "https://x.com/user/status/123",
  message: "Fascinating perspective on the future of AI!"
})

From CLI: "Help me check my X account information"

message({ action: "x-me" })

Natural Language Mapping

User says (Chinese) Action
Post a tweet / post a tweet / post tweet x-post
Reply to a tweet / comment on this tweet x-reply
Quote retweet / retweet with comment / quote tweet x-quote
Like / give this tweet a like x-like
Unlike x-unlike
Retweet / repost x-repost
Undo retweet x-unrepost
Follow / follow x-follow
Unfollow / unfollow x-unfollow
Direct message / DM x-dm
Search tweets / find tweets / search tweets x-search
Look at xxx's tweets / timeline / timeline x-timeline
This tweet's data / tweet details / engagement data x-tweet-info
Look up user / user info / user info x-user-info
My account / current account x-me

X Content Rules

  • 280-character limit per tweet / reply / quote comment
  • Plain text only — X does not render markdown. Never use **bold**, *italic*, `code`.

Permission Model

Write actions require allowlist permission. Read actions do not.

Read actions (x-search, x-timeline, x-tweet-info, x-user-info, x-me) — always allowed, no permission check needed.

Write actions permission cascade (checked in order):

  1. From X: sender must be in channels.x.actionsAllowFrom.
  2. From other channels (Feishu, Telegram, etc.): if channels.<channel>.xActionsAllowFrom is set, sender must be in it. Otherwise, if channels.<channel>.allowFrom is set, sender must be in it. Otherwise, if channels.x.actionsAllowFrom is configured (any value), the action is allowed (the owner explicitly enabled X actions and the sender is authenticated by the originating channel).
  3. From CLI/unattended: allowed if channels.x.actionsAllowFrom is configured.

In practice: if channels.x.actionsAllowFrom is configured during onboarding, cross-channel X write actions work from any channel without extra configuration. You do NOT need to set channels.feishu.xActionsAllowFrom separately.

Do NOT Do These

  1. Do NOT use the browser tool for X operations. The X plugin is already configured.
  2. Do NOT search for X/Twitter tools or external APIs. The message tool's x-* actions are the correct and only interface.
  3. Do NOT confuse the conversation channel with the action target. "Reply to this tweet" in Feishu means x-reply on X, NOT a Feishu reply.
  4. Do NOT say "I can't do X operations from this channel." You can — the X plugin works from any channel.
  5. Do NOT send tweet content as a regular message in the user's conversation when they ask to post/reply on X.
  6. Do NOT use markdown in X content. X renders plain text only.