threads-profile-search
Discovers Threads user accounts by keyword, extracting profile data including username, display name, verification status, biography, and follower count
Install / Use
npx skills add browser-act/skills --skill threads-profile-searchInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
MarketingSupported Platforms
Tags
Our assessment of threads-profile-search
threads-profile-search scores 93/100 on our quality scale, 128th of 642 Marketing skills we index (top 20%).
Its SKILL.md is 7.0 KB long, well organised into 15 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 6,001 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so threads-profile-search is actively maintained.
- Our last check on 2026-10-26 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
threads-profile-search compared with similar skills
All 4 of these similar skills score higher than threads-profile-search; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| threads-profile-search (this skill)by browser-act | 93 | 6.0k | 3mo ago | SKILL.md |
| x402by browser-use | 100 | 121.0k | 3d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 55d ago | SKILL.md |
| designby nextlevelbuilder | 100 | 149.0k | 6d ago | SKILL.md |
Frequently asked questions
- How do I install threads-profile-search?
- Run
npx skills add browser-act/skills --skill threads-profile-search. The install tabs above show the steps for each supported agent. - Which AI agents does threads-profile-search work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is threads-profile-search safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is threads-profile-search still maintained?
- The repository was last updated about 3 months ago, so threads-profile-search is actively maintained.
Skill content
View source on GitHubname: threads-profile-search description: "Discovers Threads user accounts by keyword, extracting profile data including username, display name, verification status, biography, and follower count. Use when user asks to find Threads accounts, search Threads profiles, discover Threads users by keyword, look up Threads creators, find influencers on Threads, search for people on Threads, get Threads user details, collect Threads profile information, find accounts related to a topic on Threads, search Threads for accounts by name or keyword, or enumerate Threads users matching a search term."
Threads — Profile Search
keyword → list of matching user profiles with optional enrichment (bio, follower count)
Language
All process output to user (progress updates, process notifications) follows the user's language.
Objective
Search Threads for user accounts matching a keyword and extract profile information, with optional per-user enrichment to retrieve biography and follower count via the profile API.
Prerequisites
- A browser is open and connected via browser-act
- No login required for profile search (unauthenticated: up to 16 profiles per query, no pagination)
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.
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 viaeval "$(python scripts/xxx.py {params})".$(...)is bash syntax; it is recommended to use the bash tool for execution.
SSR: Extract profile search results (basic info)
Navigate to the profile search page, then extract user accounts from the SSR-embedded JSON:
navigate https://www.threads.com/search/?q={keyword}&type=profileswait stableeval "$(python scripts/extract-profile-search.py '{keyword}')"
Output example:
{
"keyword": "zuck",
"profiles": [
{
"pk": "14803522782", // Instagram-based user ID
"username": "ceozuck162", // Threads username (without @)
"full_name": "ceo,zuck", // display name
"is_verified": false, // blue checkmark verification status
"is_private": false, // true if account is private
"profile_pic_url": "https://...", // profile picture URL
"profile_url": "https://www.threads.com/@ceozuck162"
}
],
"count": 16,
"page_info": {
"end_cursor": null,
"has_next_page": false,
"has_previous_page": false,
"start_cursor": null
}
}
Error handling: If error: true is returned, verify the page URL ends with &type=profiles. If searchResults not found, retry navigate and wait stable once. If count: 0, no accounts matched the keyword.
API: Get full profile details (biography + follower count)
Enrich a single username with full profile data including biography and follower count. The browser must be on any Threads page (authentication state is shared across the session):
eval "$(python scripts/get-profile-details.py '{username}')"
Parameters:
username: Threads username without@(e.g.,zuck)
Output example:
{
"pk": "314216", // Instagram user ID
"username": "zuck",
"full_name": "Mark Zuckerberg",
"biography": "I build stuff", // profile bio text, null if empty
"follower_count": 16944740, // number of followers, null if unavailable
"following_count": 464, // number of accounts followed
"is_verified": true,
"is_private": false,
"profile_pic_url": "https://...",
"profile_url": "https://www.threads.com/@zuck",
"external_url": null // website URL from profile, null if not set
}
Error handling: If error: true with a 429 status, the profile API is rate-limited — wait 10-30 seconds before retrying. If User not found, the username may be invalid or the account may be deleted.
Composite: Search profiles + enrich each with full details
To collect profiles with biography and follower count for all results:
navigate https://www.threads.com/search/?q={keyword}&type=profiles→wait stableeval "$(python scripts/extract-profile-search.py '{keyword}')"→ collect profiles list- For each
usernamein profiles: a.eval "$(python scripts/get-profile-details.py '{username}')"→ merge biography, follower_count, following_count, external_url into profile record - Output merged list with all fields
Note: Profile API calls are made in the browser context and share the same session cookies. Add 1-2 second intervals between per-user calls to avoid rate limiting.
Pagination
Pagination is not available for unauthenticated access on profile search (has_next_page: false). Results are limited to approximately 16 profiles per keyword without login.
Success Criteria
result.count >= 1 and result.profiles[0].username != null
For enriched flow: profiles[0].follower_count != null and profiles[0].biography != null
Known Limitations
- Unauthenticated access: no pagination; approximately 16 profiles per query
- Basic profile search does not include biography or follower count — enrichment step required
- Profile API (
get-profile-details.py) may be rate-limited; add intervals in batch loops - Private accounts appear in search results but their post data is inaccessible
pkfrom SSR profile search is the Instagram-based ID, which differs from the Threads-specific ID in post data
Execution Efficiency
- Batch orchestration: Run
extract-profile-search.pyonce per keyword, then loop through the returned usernames for enrichment. Do not callget-profile-details.pyin parallel within the same session — rate limit applies. - Test before batch execution: Test with 1-2 keywords first before running full enrichment batch.
- Reduce redundant pre-operations: After the search page load, all subsequent
get-profile-details.pycalls usefetch()in the current browser context — no additional navigation needed. - Error resumption: Save results per username; on failure, resume enrichment from the breakpoint.
Experience Notes
Path: {working-directory}/browser-act-skill-forge-memories/threads-scraper-threads-profile-search.memory.md
Before execution: If the file exists, read it first — it records unexpected situations encountered during past executions; adjust strategy order accordingly.
After execution: If an unexpected situation is encountered (strategy became ineffective, page redesigned, anti-scraping upgraded, better path discovered), append a line:
{YYYY-MM-DD}: {what happened} → {conclusion}
Normal execution does not write to the file. Do not record what keywords were used or how many results were returned — those are task outputs, not experience.
Related Skills
x402
121.0kSet up Browser Use Cloud payments with x402 — pay per request from a crypto wallet (USDC on Base mainnet), no signup or API key.
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
design
149.0kComprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini, Atlas Cloud, or MuAPI AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG…
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
