Threads User Posts

Threads — User Posts

username → list of public posts with engagement metrics (SSR + scroll pagination)

Language

All process output to user (progress updates, process notifications) follows the user's language.

Objective

Extract public posts from a given Threads user's profile page using SSR-embedded JSON data, with optional scroll-triggered pagination to load more posts.

Prerequisites

• A browser is open and connected via browser-act
• Login recommended: Threads enforces a login wall on profile pages in most regions as of mid-2026. A logged-in browser session is required for reliable access. Unauthenticated access via US-based proxies may work in some configurations but is not guaranteed.

Pre-execution Checks

1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke browser-act via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

2. Login Verification

If login status for Threads has been confirmed in the current session → skip this step.

Otherwise: navigate https://www.threads.com and check page state:

• User avatar or username visible at top → logged in, continue
• "Log in" / "Sign up" buttons visible → not logged in, inform the user that login is needed, assist completing the login flow via the Threads login page

If not logged in and user cannot log in → the capability may still work on some proxy/IP configurations; attempt navigate https://www.threads.com/@{username} and check if profile content loads. If the page redirects to /login/, terminate and inform the user that a logged-in session is required.

Capability Components

This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page. JS code is encapsulated in Python files under the scripts/ directory, invoked via eval "$(python scripts/xxx.py {params})". $(...) is bash syntax; it is recommended to use the bash tool for execution.

SSR: Extract posts from profile page (initial load)

Navigate to the user's profile page first, then extract all posts embedded in the initial page HTML:

1. navigate https://www.threads.com/@{username}
2. wait stable
3. eval "$(python scripts/extract-posts.py)"

Output example:

{
  "posts": [
    {
      "id": "3936653356768062022",          // post internal ID (pk)
      "code": "DKmzN8wJzFG",               // post short code for URL
      "url": "https://www.threads.com/@zuck/post/DKmzN8wJzFG",  // direct post link
      "text": "Excited to share...",        // post text content, null if no caption
      "taken_at": 1780953646,              // Unix timestamp of post creation
      "like_count": 3583,                  // number of likes
      "reply_count": 3039,                 // number of direct replies
      "repost_count": 232,                 // number of reposts
      "quote_count": 114,                  // number of quote posts
      "reshare_count": 460,                // number of reshares
      "is_reply": false,                   // true if this post is a reply to another
      "media_type": 19,                    // 1=photo, 2=video, 8=carousel, 19=text-only
      "has_media": false,                  // true if post contains image/video/carousel
      "user": {
        "pk": "63055343223",              // Threads-specific user ID
        "username": "zuck",
        "full_name": "Mark Zuckerberg",
        "is_verified": true
      }
    }
  ],
  "count": 4,                             // number of posts in this batch
  "page_info": {
    "end_cursor": "QVFES...",             // cursor for next page (null when no more)
    "has_next_page": true,                // whether more posts are available
    "has_previous_page": false,
    "start_cursor": null
  }
}

Error handling: If error: true is returned, check that the profile page was fully loaded (navigate and wait stable completed without timeout). If mediaData not found, the page may have redirected to a login wall or the username is invalid.

DOM: Scroll to trigger more posts

When page_info.has_next_page is true, scroll the page to trigger GraphQL auto-load:

eval "$(python scripts/scroll-load-more.py)"

Then wait stable and read the new batch from network traffic:

network requests --type xhr,fetch --filter threads.com

Find the POST https://www.threads.com/graphql/query request(s) that appeared after the scroll. Read the response:

network request <id>

The response body contains data.mediaData.edges[] with the same post structure as the SSR extraction output. Each edge has node.thread_items[0].post with the same field layout (id/pk, code, caption.text, taken_at, like_count, text_post_app_info.direct_reply_count, etc.).

Error handling: If no new graphql/query requests appear after scrolling, the user may have reached the login wall (~15 posts without authentication) or all posts have loaded. Check for a "Log in to see more" message on screen via screenshot.

Composite: Full profile post collection (SSR + scroll pagination)

To collect all available posts for a user:

1. navigate https://www.threads.com/@{username} → wait stable
2. eval "$(python scripts/extract-posts.py)" → collect initial posts, note page_info
3. While page_info.has_next_page == true: a. eval "$(python scripts/scroll-load-more.py)" b. wait stable c. network requests --type xhr,fetch --filter threads.com → locate new graphql/query POST d. network request <id> → extract data.mediaData.edges[] posts e. Check data.mediaData.page_info.has_next_page in response to decide whether to continue
4. Stop when has_next_page == false or login wall encountered (~15 posts without login)