Quote a tweet on X (Twitter) from an AI agent

Your 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. Unless dry_run is set, 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) 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.

Full URL of the tweet to quote, e.g. https://x.com/handle/status/123. Confirm the exact URL with the user before running.

When true, everything runs up to and including the attachment landing in the composer, then the run stops and publishes nothing — tweet_id and url come back null and already_present/verified_on_page are false. Use it to prove media attaches, or to rehearse a quote, without a public irreversible write.

Optional link to one image (JPEG, PNG, GIF, WebP) or video (MP4) to attach. The browser fetches it, so any host it can reach works, including a file served from the machine running the browser (python3 -m http.server 8765 --bind 127.0.0.1 → http://127.0.0.1:8765/pic.jpg). No size ceiling. The link must point at the file itself — a page about the file is refused before anything is published. Media is part of the published, irreversible content, so confirm it with the user before running, the same as the text.

One image or video to attach, bound through the platform's own file channel and handed straight to the composer's file input. Carries the bytes outside the argument payload, so unlike media_base64 it is not limited by the request size, and it works on every device. Pass at most one of attachment / media_url / media_base64.

Optional image or video as base64 bytes. A data: prefix, line wrapping and base64url characters are all accepted. Suitable only for small files: arguments arriving over MCP are capped around 96KB of base64 by the transport itself. Prefer the `attachment` input, which has no such cap.

Optional filename to present the attachment under (e.g. chart.png). Defaults to the name in media_url, or 'media' plus the extension matching the detected file type. Not used with the `attachment` input, which carries its own name.

id of the quoted tweet

handle of the logged-in account that performed the action, read from the account switcher UI (not assumed from input).

true 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.

true if the script navigated to the new tweet's URL after publishing and confirmed the article is actually present.

true if this run stopped before publishing because dry_run was set. When true the attachment, if any, was confirmed present in the composer and then discarded.

The attachment's detected type (e.g. image/jpeg, video/mp4), or null on a text-only quote.

Size in bytes of the attached file as the browser decoded it, so a truncated payload is visible in the result. Null when no media was attached, or when it came from media_path.

Number of media attachments on the posted quote (0 if text-only).