Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add browser-act/skills --skill social-media-finder-skill -a claude-code
Open on GitHub

What 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+Smith and give me the CSV.
  • Check which social profiles the Tesla brand has.
  • Run the lookup for Bill+Gates and 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-code

2Manually: put the files in place

~/.claude/skills/social-media-finder-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/social-media-finder-skill/

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

Similar skills

All skills for Browser and scraping →

From the same set11

The whole set →
amazon-competitor-analyzer amazon-competitor-analyzer pulls product data from Amazon by ASIN and compares pricing, specs, and reviews across competitors. Identifies weak points in rival strategies and uncovers market gaps for your own product. CX Codex +1 133installs youtube-channel-api-skill youtube-channel-api-skill is a skill that searches YouTube channels through BrowserAct API. Find creators by topic or gather competitor channel data. CX Codex +1 5installs taobao-shop-catalog taobao-shop-catalog pulls a Taobao or Tmall store's product list by shopId, page by page: itemId, title, image link and item link. CX Codex +1 1installs ecommerce-listing ecommerce-listing extracts structured product listings from e-commerce search results and category pages with filters and pagination. CX Codex +1 1installs facebook-page-profile-posts facebook-page-profile-posts reads posts from a public Facebook Page or profile and returns reactions, media, links, and author details. Use it for exports or timeline monitoring. CX Codex +1 1installs facebook-page-posts facebook-page-posts extracts posts from public Facebook pages with engagement counts, external links, and reactions using an active browser session. CX Codex +1 1installs facebook-groups-scrape-posts facebook-groups-scrape-posts collects posts from a Facebook group and returns JSON with authors, text, media, reactions, comments, and shares. CX Codex +1 1installs xiaohongshu-auto-posting xiaohongshu-auto-posting runs the whole Xiaohongshu posting cycle: finds topics people complain about, drafts a note in the style of strong posts, publishes, then reports metrics. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open