social-media-finder-skill — Claude Code skill: what it does
social-media-finder-skill looks up public profiles of a person or a brand on Facebook, Twitter, Instagram, LinkedIn, TikTok and hands back a CSV with the links and follower counts.
MIT 1 installs ★ 6,409 updated 2026-08-24
npx skills add browser-act/skills --skill social-media-finder-skill -a claude-codeWhat social-media-finder-skill does
Give it a name and it sweeps the usual networks: Facebook, Twitter, Instagram, LinkedIn, TikTok. A single run returns a CSV download holding the platform, follower count, page title, a short bio excerpt and the profile URL.
The work happens in ./scripts/social_media_finder.py, called as python -u ./scripts/social_media_finder.py "John+Smith". Join the words of a name with +, otherwise matches get weaker. Browser automation takes minutes, so the script streams timestamped status lines; watch those before calling it frozen.
You need python on the machine and BROWSERACT_API_KEY in the environment. Without the key nothing starts: the agent asks for it and waits. An Invalid authorization reply or a message about too many concurrent tasks is not worth retrying, because only the user can fix the key or the plan. Other failures get one automatic re-run.
What it helps with
- check a job candidate's public profiles before an interview
- collect profile links and contact details for a sales list
- see which networks a competitor actually runs
- pull an influencer's follower counts and bio into a spreadsheet
- locate a brand's official support account
Example prompts for the agent
- Find social accounts for
John+Smithand give me the CSV. - Check which social profiles the
Teslabrand has. - Run the lookup for
Bill+Gatesand show me the follower counts.
How to install social-media-finder-skill
1Skills CLI (Vercel)
npx skills add browser-act/skills --skill social-media-finder-skill -a claude-code2Manually: put the files in place
~/.claude/skills/social-media-finder-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/social-media-finder-skill/
1Skills CLI (Vercel)
npx skills add browser-act/skills --skill social-media-finder-skill -a codex2Manually: put the files in place
.agents/skills/social-media-finder-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add browser-act/skills --skill social-media-finder-skill -a cursor2Manually: put the files in place
.cursor/skills/social-media-finder-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install browser-act/skills solutions/lead-generation/social-media-finder-skill2Manually: put the files in place
.github/skills/social-media-finder-skill/SKILL.md1Skills CLI (Vercel)
npx skills add browser-act/skills --skill social-media-finder-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/browser-act/skills --path solutions/lead-generation/social-media-finder-skillManually: put the files in place
.devin/skills/social-media-finder-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add browser-act/skills --skill social-media-finder-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about social-media-finder-skill
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. The skill file then sits at ~/.claude/skills/social-media-finder-skill/SKILL.md.
What does social-media-finder-skill do?
It searches Facebook, Twitter, Instagram, LinkedIn, TikTok and other networks for a person or brand, then returns a CSV with the platform, follower count, page title, bio excerpt and profile link.
What does it need to run?
python and the BROWSERACT_API_KEY environment variable. Grab the key from the BrowserAct console; without it the agent only asks for the key and stops.
Source text
SKILL.md · MIT
---
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."
metadata: {"openclaw":{"emoji":"🌐","requires":{"bins":["python"],"env":["BROWSERACT_API_KEY"]}}}
---
# 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](https://www.browseract.com/reception/integrations) 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.
## ⚠️ 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](https://www.browseract.com/reception/recharge) 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 · browser-act/skills