Agent skill

Social Media Finder Skill

by browser-act in browser-act/skills

This skill helps users automatically find social media profiles across platforms like Facebook, Twitter, Instagram, LinkedIn, etc.

MITAuto-check passedMarketing & SEO

Install Social Media Finder Skill

skills CLI
$ npx skills add browser-act/skills --skill social-media-finder-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install browser-act/skills social-media-finder-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/solutions/lead-generation/social-media-finder-skill .claude/skills/social-media-finder-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
social-media-finder-skill
GitHub stars
6.1k
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
649 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

This skill helps users automatically find social media profiles across platforms like Facebook, Twitter, Instagram, LinkedIn, etc.

  • Works in 5 steps: No Hallucinations: Pre-set workflows… → No Captcha Issues: No need to handle… → No IP Restrictions: No need to handle… → …
  • Tasks that involve Influencer and creator marketing
  • SKILL.md covers 📖 Brief, ✨ Features, 🔑 API Key Setup and 🛠️ Input Parameters, plus 4 more sections
  • Runs Python scripts from its folder; calls python; needs BROWSERACT_API_KEY

What it does

Social Media Finder Skill is an agent skill from browser-act/skills. This skill helps users automatically find social media profiles across platforms like Facebook, Twitter, Instagram, LinkedIn, etc. using the BrowserAct API. Agent should proactively apply this skill when users express needs like finding someone's social media accounts, discovering a brand's social media presence, tracking down social profiles of job candidates, finding contact info for sales prospects, researching a person's digital footprint, verifying the identity of someone met online, monitoring the social…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/social_media_finder.py`).

It sits in Marketing & SEO, covering Influencer and creator marketing, Customer support and Lead generation. It works with Instagram, LinkedIn and X (Twitter). The repository describes itself as: Browser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session… The licence is MIT.

When your agent uses it

  • Tasks that involve Influencer and creator marketing
  • Tasks that involve Customer support
  • Tasks that involve Lead generation

Example prompts

  • “s social media accounts, discovering a brand”
  • “/social-media-finder-skill”

Requirements

  • Python 3
  • A credential in BROWSERACT_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. No Hallucinations: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
  2. No Captcha Issues: No need to handle reCAPTCHA or other verification challenges.
  3. No IP Restrictions: No need to handle regional IP restrictions or geofencing.
  4. Faster Execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
  5. Cost-Effective: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.

What it can do on your machine

Read from SKILL.md and the folder at commit 11c057b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • browseract.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BROWSERACT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Social Media Finder Skill loads about 1.4k tokens when it runs. Until then it costs about 195 tokens; SKILL.md has 649 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~195
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from browser-act/skills at commit 11c057b, republished under its MIT licence (© browser-act). 649 words, ~1,441 tokens.

Download SKILL.mdSave it as .claude/skills/social-media-finder-skill/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
social-media-finder-skill
description
This skill helps users automatically find social media profiles across platforms like Facebook, Twitter, Instagram, LinkedIn, etc. using the BrowserAct API. Agent should proactively apply this skill when users express needs like finding someone's social media accounts, discovering a brand's social media presence, tracking down social profiles of job candidates, finding contact info for sales prospects, researching a person's digital footprint, verifying the identity of someone met online, monitoring the social media reach of influencers, checking social accounts of business competitors, gathering public profiles for background research, locating official customer service accounts across platforms, or compiling contact databases for networking.

Social Media Finder Skill

📖 Brief

This skill automates the discovery of social media accounts associated with individuals, brands, or businesses across multiple platforms. By providing a name, it searches across Facebook, Twitter, Instagram, LinkedIn, TikTok, and more — extracting profile URLs, usernames, follower counts, and bio snippets in one go. The results are returned as a downloadable CSV file.

✨ Features

  1. No Hallucinations: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
  2. No Captcha Issues: No need to handle reCAPTCHA or other verification challenges.
  3. No IP Restrictions: No need to handle regional IP restrictions or geofencing.
  4. Faster Execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
  5. Cost-Effective: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.

🔑 API Key Setup

Before running, check the BROWSERACT_API_KEY environment variable. If not set, do not take other measures; ask and wait for the user to provide it. Agent must inform the user:

"Since you haven't configured the BrowserAct API Key yet, please visit the BrowserAct Console to get your Key."

🛠️ Input Parameters

The agent should configure the following parameter based on user requirements:

  1. People_Name
    • Required: Yes
    • Type: string
    • Description: The name of the person or brand to search for. Use + between words for better results.
    • Example: John+Smith, Tesla, Bill+Gates
    • Default: Mike+Smith

🚀 Invocation Method

Agent should execute the following command to invoke the skill:

bash
# Example invocation
python -u ./scripts/social_media_finder.py "John+Smith"
⏳ Execution Monitoring

Since this task involves automated browser operations, it may take several minutes. The script outputs timestamped status logs continuously (e.g., [14:30:05] Task Status: running). Agent guidelines:

  • Monitor the terminal output while waiting.
  • As long as new status logs appear, the task is running normally; do not misjudge it as frozen.
  • Only consider triggering retry if the status remains unchanged for a long time or output stops without a final result.

📊 Data Output

Upon successful execution, the script retrieves a JSON object containing a files array with a download link to a CSV file. The CSV includes the following structured profile data:

  • Platform name: The social media platform (e.g., LinkedIn, Twitter).
  • Followers count: The number of followers.
  • Page title: The title of the profile page.
  • Description snippet: The bio or description snippet.
  • Profile URL: The direct link to the social media profile.
Show full SKILL.md (277 more words)Show less

⚠️ Error Handling & Retry

If an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:

  1. Check Output Content:

    • If the output contains "Invalid authorization", it means the API Key is invalid or expired. Do not retry; guide the user to re-check and provide the correct API Key.
    • If the output contains "concurrent" or "too many running tasks", it means the concurrent task limit has been reached. Do not retry; guide the user to upgrade their plan. Agent must inform the user:

      "The current task cannot be executed because your BrowserAct account has reached the concurrent task limit. Please visit the BrowserAct Plan Upgrade Page to upgrade your plan."

    • If the output does not contain the above error keywords but the task failed (e.g., output starts with Error: or returns empty results), the Agent should automatically re-execute the script once.
  2. Retry Limit:

    • Automatic retry is limited to one time. If the second attempt fails, stop retrying and report the specific error to the user.

🌟 Typical Use Cases

  1. Background Research: Find social media profiles of job candidates or new connections.
  2. Lead Generation: Gather contact information and social profiles for sales prospects.
  3. Competitive Intelligence: Discover the social media footprint of competitors.
  4. Influencer Discovery: Locate content creators across various platforms.
  5. Brand Monitoring: Check a brand's presence across different social networks.
  6. Reconnecting: Find old friends or colleagues online.
  7. Identity Verification: Cross-reference profiles of people met online.
  8. Customer Support: Find official brand accounts for reaching out.
  9. Networking: Research event attendees or potential business partners.
  10. Digital Footprint Audit: Monitor one's own public social media presence.

© browser-act, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in solutions/lead-generation/social-media-finder-skill of browser-act/skills.

  • SKILL.md
  • scripts/social_media_finder.py

Open the folder on GitHubat commit 11c057b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in browser-act/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Social Media Finder Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Social Media Finder Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Media Finder Skill this skillbrowser-act/skills6.1k1 repos~1.4kAutomated safety check: PassMIT
AdsCesarjoquin/Marketing-Skills2021 repos~3.5kAutomated safety check: PassMIT
Adscoreyhaines31/marketingskills54k1 repos~7kAutomated safety check: PassMIT
Influencer Discoverytigerless-labs/influencer-discovery212—~2.5kAutomated safety check: NotesNone
Paid Adsfreekmurze/dotfiles1k14 repos~2.4kAutomated safety check: PassNone
Meta Ads for B2Bivangfalco/ads-skills279—~2.4kAutomated safety check: PassCustom licence

Similar skills

  • Ads

    Cesarjoquin/Marketing-Skills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    202 GitHub starsUsed in 1 repo~3.5k tokens
    Marketing & SEOAuto-check passed
  • Ads

    coreyhaines31/marketingskills

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    54k GitHub starsUsed in 1 repo~7k tokens
    Marketing & SEOAuto-check passed
  • Influencer Discovery

    tigerless-labs/influencer-discovery

    Find the bloggers/creators who can help promote your work, capture their contact info, and append them to the target sheet in Google Sheets.

    212 GitHub stars~2.5k tokensUpdated 19 days ago
    Marketing & SEOAuto-check: notes
  • Paid Ads

    freekmurze/dotfiles

    When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.

    1k GitHub starsUsed in 14 repos~2.4k tokens
    Marketing & SEOAuto-check passed
  • Meta Ads for B2B

    ivangfalco/ads-skills

    Guides B2B campaigns on Meta (Facebook and Instagram): audience data, campaign structure, creative testing, lead forms and account audits for SaaS lead generation.

    279 GitHub stars~2.4k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Transcript Intelligence

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to summarize, analyze, or repurpose transcripts from TikTok, Instagram, YouTube, Facebook, X/Twitter, LinkedIn, Rumble, or Reddit video posts.

    3.4k GitHub stars~943 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes

More from browser-act/skills

All 87 skills in this repo
  • Amazon ASIN Lookup

    browser-act/skills

    Fetches structured Amazon product details such as title, price, ratings and availability for a given ASIN through BrowserAct's lookup API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Best Sellers Finder

    browser-act/skills

    Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Analyzes a competitor's Amazon listing by ASIN with BrowserAct data extraction, then reports what it does well, where the market has gaps and opportunity points for your own listing.

    6.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Pulls structured Amazon search results (titles, ASINs, prices, ratings, specifications) for a keyword and brand through BrowserAct's Amazon Product API template.

    6.1k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Collects structured product data from Amazon search results for a keyword and optional brand, using a BrowserAct script, for market and competitor research.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed

Categories

Questions about Social Media Finder Skill

What does Social Media Finder Skill do?

This skill helps users automatically find social media profiles across platforms like Facebook, Twitter, Instagram, LinkedIn, etc. Social Media Finder Skill is an agent skill from browser-act/skills. This skill helps users automatically find social media profiles across platforms like Facebook, Twitter, Instagram, LinkedIn, etc.

When should I use Social Media Finder Skill?

Social Media Finder Skill fits situations like: tasks that involve Influencer and creator marketing; tasks that involve Customer support; tasks that involve Lead generation.

How do I install Social Media Finder Skill in Claude Code?

Run `npx skills add browser-act/skills --skill social-media-finder-skill -a claude-code`. Or copy the skill folder (solutions/lead-generation/social-media-finder-skill in browser-act/skills) into .claude/skills/social-media-finder-skill in your project. Claude Code loads it when a task matches its description.

How do I install Social Media Finder Skill in Codex?

Run `npx skills add browser-act/skills --skill social-media-finder-skill -a codex`. Or copy the skill folder (solutions/lead-generation/social-media-finder-skill in browser-act/skills) into .agents/skills/social-media-finder-skill in your project. Codex loads it when a task matches its description.

Can I use Social Media Finder Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add browser-act/skills --skill social-media-finder-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/social-media-finder-skill, .gemini/skills/social-media-finder-skill, .github/skills/social-media-finder-skill and .opencode/skills/social-media-finder-skill in your project.

What does Social Media Finder Skill need to run?

Going by SKILL.md and its folder, Social Media Finder Skill needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named BROWSERACT_API_KEY. Our summary lists: Python 3; A credential in BROWSERACT_API_KEY.

Does Social Media Finder Skill access the network?

SKILL.md names 1 domain. As links in the text: browseract.com. This is read from the text; nothing was executed.

Is Social Media Finder Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Social Media Finder Skill use?

Social Media Finder Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Social Media Finder Skill use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Social Media Finder Skill?

Skills that share tags, products or a category with Social Media Finder Skill: Ads (Cesarjoquin/Marketing-Skills, 202 stars), Ads (coreyhaines31/marketingskills, 54k stars), Influencer Discovery (tigerless-labs/influencer-discovery, 212 stars) and Paid Ads (freekmurze/dotfiles, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Media Finder Skill?

browser-act (a GitHub organization) maintains it in browser-act/skills, which has 6,126 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on August 24, 2026.

Source: browser-act/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.