Quote tweet
Input
text requiredYour commentary on the quoted tweet (≤280 chars, as X weighs it — a URL counts as 23 regardless of length). If X's composer rejects the text, the script throws before publishing instead of hanging. Any @handle in the text is validated against a real, non-suspended X account before anything is posted — the run throws naming the bad handle if one doesn't resolve. Every call posts immediately and irreversibly in public, with no preview or confirmation step inside the script, so show the exact tweet_url being quoted and this exact text (and any media_path) to the user and get their explicit approval for this specific content before running — approval from an earlier or unrelated message does not carry over.
tweet_url requiredFull URL of the tweet to quote, e.g. https://x.com/handle/status/123. Confirm the exact URL with the user before running.
media_path optionalOptional absolute path to an image or video to attach to the quote (e.g. /Users/me/pic.png), read from the machine running the browser. Attaching a local file is only supported on a local (reduck local / CLI) device: a browser paired through the extension refuses it, and no run on any device kind has attached media successfully yet, so treat this field as unproven. To attach a file from an extension-paired browser, serve it over http://127.0.0.1:<port>/ on that same machine and pass the URL instead. Media is part of the published, irreversible content, so confirm the exact file with the user before running, the same as the text field.
Output
url requiredtext requiredhandle requiredquoted requiredid of the quoted tweet
tweet_id requiredaccount_used requiredhandle of the logged-in account that performed the action, read from the account switcher UI (not assumed from input).
already_present requiredtrue if this text already appears on the most recent page of the account's own posts (~20, read from X's own profile-timeline payload), so publishing was skipped and tweet_id/url are null. Comparison strips URLs and emoji from both sides, since the submitted text carries the original link while X stores a shortened t.co one. A duplicate older than that first page is not detected here and surfaces instead as X's own "Status is a duplicate. (187)" refusal.
verified_on_page requiredtrue if the script navigated to the new tweet's URL after publishing and confirmed the article is actually present.
media_count optionalNumber of media attachments on the posted quote (0 if text-only).
Get X tweet
Fetch a tweet by URL — the focal post plus the surrounding conversation. Returns `tweet` (the focal post; null if deleted/tombstoned) and `replies[]`, which holds every other tweet on the conversation page: both the focal's ancestors (the thread above it, present when the focal is itself a reply; each has `in_reply_to` null or pointing above the focal) and the replies below it (`in_reply_to` points at the focal or a sibling reply). Use `in_reply_to` to tell ancestors from replies and rebuild the thread — the array is not filtered to descendants of the focal. Each entry is a canonical tweet record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, in_reply_to {id, author_handle}. Scrolls the main thread until `count` is met (then complete=false — more may exist) or it drains (complete=true). Replies behind a "Show more replies"/hidden/probable-spam cursor are not expanded, so even complete=true is a floor, not a guarantee every nested reply was seen.
Delete tweet
Delete one of your own tweets given its URL. Returns the deleted tweet id and a deleted flag.
Search X tweets
Search X for tweets, supporting all X search operators; the tab arg picks 'top' (ranked sample, default) or 'latest' (chronological). Returns per tweet a canonical record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, plus followers (the author's follower count, a search-only enrichment), and the top-level query and count. Top is a ranked sample, not exhaustive.