| name | publish-threads |
| description | Publish a Threads post (text, image, or video) via Playwright. Threads identity = Instagram identity. |
Common rules: docs/OPERATING_RULES.md. Threads-specific quirks only.
Input
caption: post text (≤ 500 chars).hashtags: list of strings (Threads recommends ≤ 1, appended after a space).mode: post (text + optional image) | video.local_image_path / local_video_path: optional / required per mode.
Output
{ "post_url": "https://www.threads.net/@<handle>/post/...", "platform": "threads" }
Common steps
browser_navigate → https://www.threads.net/.- Verify you are signed in (Threads uses the Instagram session; if not signed in, the page redirects to a login wall — return
{ "error": "login expired, run /first-time-login" }).
- Click "What's new?" / 「有什麼新鮮事？」 to open the composer.
- Type
caption + " " + hashtags.join(" ") into the textarea.
- (If media) Click the attachment icon (paperclip), then
browser_file_upload.
- Wait for the upload thumbnail.
- Click "Post" / "發布".
- Wait for the success state (composer closes, feed shows new post).
- Extract the post URL.
Quirks
- The composer text area is a
contenteditable div, not an <input> — typing must go through browser_type with the element ref, not via evaluate('elem.value = ...').
- Threads sometimes shows an Instagram-permission interstitial on first publish from a new device ("Allow Threads to use your Instagram identity?") — accept it once. Subsequent runs skip it.
- The "Reply control" dropdown defaults to "Anyone" — leave alone unless
extra.reply_control is provided.
URL extraction
After publish, navigate to socials.threads.url (e.g. https://www.threads.net/@<handle>). Read the first post in the profile grid:
(handle) => {
const a = document.querySelector(`a[href*="/@${handle}/post/"]`);
return a ? new URL(a.getAttribute('href'), location.origin).href : null;
}
Wait up to 90 seconds for the profile to refresh. Two failures → { "post_url": null, "error": "url_extraction_failed" }.
Dry-run
- Stop after step 6 (media uploaded / preview shown). Do not click Post.
- Click the X to close the composer; accept any "Discard" prompt.
browser_close.- Return
{ "status": "dry_run_ok" } or the failure form.
