{"id":"social-media-finder-skill","name":"social-media-finder-skill","summary":"このスキルは、BrowserAct APIを使ってFacebook、Twitter、Instagram、LinkedInなどのプラットフォームで自動的にソーシャルメディアのプロフィールを見つけるのに役立ちます。","body":"# Social Media Finder Skill\n\n## 📖 Brief\nThis 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.\n\n## ✨ Features\n1. **No Hallucinations**: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.\n2. **No Captcha Issues**: No need to handle reCAPTCHA or other verification challenges.\n3. **No IP Restrictions**: No need to handle regional IP restrictions or geofencing.\n4. **Faster Execution**: Tasks execute faster compared to pure AI-driven browser automation solutions.\n5. **Cost-Effective**: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.\n\n## 🔑 API Key Setup\nBefore 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.\n**Agent must inform the user**:\n> \"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.\"\n\n## 🛠️ Input Parameters\nThe agent should configure the following parameter based on user requirements:\n\n1. **People_Name**\n   - **Required**: Yes\n   - **Type**: `string`\n   - **Description**: The name of the person or brand to search for. Use `+` between words for better results.\n   - **Example**: `John+Smith`, `Tesla`, `Bill+Gates`\n   - **Default**: `Mike+Smith`\n\n## 🚀 Invocation Method\nAgent should execute the following command to invoke the skill:\n\n```bash\n# Example invocation\npython -u ./scripts/social_media_finder.py \"John+Smith\"\n```\n\n### ⏳ Execution Monitoring\nSince 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`).\n**Agent guidelines**:\n- Monitor the terminal output while waiting.\n- As long as new status logs appear, the task is running normally; do not misjudge it as frozen.\n- Only consider triggering retry if the status remains unchanged for a long time or output stops without a final result.\n\n## 📊 Data Output\nUpon 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:\n- `Platform name`: The social media platform (e.g., LinkedIn, Twitter).\n- `Followers count`: The number of followers.\n- `Page title`: The title of the profile page.\n- `Description snippet`: The bio or description snippet.\n- `Profile URL`: The direct link to the social media profile.\n\n## ⚠️ Error Handling & Retry\nIf an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:\n\n1. **Check Output Content**:\n   - 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.\n   - 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.\n     **Agent must inform the user**:\n     > \"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.\"\n   - 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**.\n\n2. **Retry Limit**:\n   - Automatic retry is limited to **one time**. If the second attempt fails, stop retrying and report the specific error to the user.\n\n## 🌟 Typical Use Cases\n1. **Background Research**: Find social media profiles of job candidates or new connections.\n2. **Lead Generation**: Gather contact information and social profiles for sales prospects.\n3. **Competitive Intelligence**: Discover the social media footprint of competitors.\n4. **Influencer Discovery**: Locate content creators across various platforms.\n5. **Brand Monitoring**: Check a brand's presence across different social networks.\n6. **Reconnecting**: Find old friends or colleagues online.\n7. **Identity Verification**: Cross-reference profiles of people met online.\n8. **Customer Support**: Find official brand accounts for reaching out.\n9. **Networking**: Research event attendees or potential business partners.\n10. **Digital Footprint Audit**: Monitor one's own public social media presence.","author":"@browser-act","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/browser-act/skills/tree/main/solutions/lead-generation/social-media-finder-skill","license":"MIT","category":"data","lang":"en","tokens":1071,"stars":0,"calls30d":1,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[{"path":"scripts/social_media_finder.py","size":4417,"sha256":"3899cafa81ae94d851c623e1b65c19dfd74dc3aa3e3cbe3198644e08a6032f4a"}],"requires":{"mcp":[],"tools":[]},"safety":{"flags":[{"code":"net.endpoints","kind":"exfiltration","excerpt":"api.browseract.com, www.browseract.com","message":"bundled scripts reach 2 external host(s)","severity":"warn"}],"scannedAt":"2026-08-22","hasScripts":true,"networkEndpoints":["api.browseract.com","www.browseract.com"]}}