Skip to content
Back to search

Custom-MCP-Server

MCP server for scraping LinkedIn, Facebook, Instagram profiles and Google search.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sharan-kumar-r--custom-mcp-server/badge.svg)](/listings/sharan-kumar-r--custom-mcp-server)

HTML

<a href="/listings/sharan-kumar-r--custom-mcp-server"><img src="/api/listings/sharan-kumar-r--custom-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Step 1: Adding MCP to your Python project

We recommend using [uv](https://docs.astral.sh/uv/) to manage your Python projects.

If you haven't created a uv-managed project yet, create one:

uv init custom-mcp-server
cd custom-mcp-server

Step 2: Install MCP Dependencies

Then add MCP to your project dependencies:

uv add "mcp[cli]"

This will auto-generate files and folders similar to the project structure mentioned below, also create a .env file to securely store the API keys.

Step 3: Add Project Code

In the files generated look for main.py and copy paste the code given in main.py (repo).

Step 4: Install Additional Dependencies

uv add httpx python-dotenv fastmcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 185 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">Social Media Scraper - Custom MCP Server</h1>
  2. <br>
  3. <p align="center">
  4. <img src="https://img.shields.io/badge/python-FFD43B?style=for-the-badge&logo=python&logoColor=306998" alt="Python">
  5. <img src="https://img.shields.io/badge/fastmcp-FF6B6B?style=for-the-badge&logo=python&logoColor=white" alt="FastMCP">
  6. <img src="https://img.shields.io/badge/rapidapi-7B68EE?style=for-the-badge&logo=rapidapi&logoColor=white" alt="RapidAPI">
  7. <img src="https://img.shields.io/badge/linkedin-20B2AA?style=for-the-badge&logo=linkedin&logoColor=white" alt="LinkedIn API">
  8. <img src="https://img.shields.io/badge/facebook-FF4500?style=for-the-badge&logo=facebook&logoColor=white" alt="Facebook API">
  9. <img src="https://img.shields.io/badge/instagram-FF1493?style=for-the-badge&logo=instagram&logoColor=white" alt="Instagram API">
  10. <img src="https://img.shields.io/badge/google_serper-32CD32?style=for-the-badge&logo=google&logoColor=white" alt="Google Serper API">
  11. </p>
  12. <br>
  13. A comprehensive Model Context Protocol (MCP) server that provides social media scraping capabilities for LinkedIn, Facebook, Instagram, and Google search functionality.
  14. ## What is MCP?
  15. **[Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction)** is an open standard that enables AI assistants to securely connect with external data sources and tools. MCP servers act as bridges between AI models and various services, allowing for enhanced capabilities like real-time data access, API integrations, and custom tool execution.
  16. ## Features
  17. This server exposes the following tools for an AI assistant to use:
  18. - **LinkedIn Profile Scraping**: Extract personal and company profile data
  19. - **Facebook Profile Scraping**: Fetch public profile information
  20. - **Instagram Profile Scraping**: Get profile data and basic information
  21. - **Google Search**: Perform web searches using Google Serper API
  22. ## Installation
  23. ### Step 1: Adding MCP to your Python project
  24. We recommend using [uv](https://docs.astral.sh/uv/) to manage your Python projects.
  25. If you haven't created a uv-managed project yet, create one:
  26. ```bash
  27. uv init custom-mcp-server
  28. cd custom-mcp-server
  29. ```
  30. ### Step 2: Install MCP Dependencies
  31. Then add MCP to your project dependencies:
  32. ```bash
  33. uv add "mcp[cli]"
  34. ```
  35. This will auto-generate files and folders similar to the project structure mentioned below, also create a .env file to securely store the API keys.
  36. ### Step 3: Add Project Code
  37. In the files generated look for main.py and copy paste the code given in main.py (repo).
  38. ### Step 4: Install Additional Dependencies
  39. ```bash
  40. uv add httpx python-dotenv fastmcp
  41. ```
  42. ## Environment Configuration
  43. ### Step 1: API Keys Setup
  44. 1. **RapidAPI Key**:
  45. - Sign up at [RapidAPI](https://rapidapi.com/)
  46. - Subscribe to the following APIs (Most Important):
  47. - Fresh LinkedIn Profile Data
  48. - Facebook Scraper3
  49. - Instagram Scraper Stable API
  50. 2. **Google Serper API Key**:
  51. - Sign up at [Serper.dev](https://serper.dev/)
  52. - Get your API key from the dashboard
  53. ### Step 2: Environment Variables
  54. Create `.env` file in your project root with the following variables:
  55. ```env
  56. RAPIDAPI_KEY=your_rapidapi_key_here
  57. SERPER_API_KEY=your_serper_api_key_here
  58. ```
  59. ## Usage
  60. ### Running with Claude Desktop
  61. #### Step 1: Install the Server
  62. You can install this server in [Claude Desktop](https://claude.ai/download) and interact with it right away by running:
  63. ```bash
  64. uv run mcp install main.py
  65. ```
  66. #### Step 2: Verify Installation
  67. Later, go to Claude AI (desktop version) and you will see changes in the platform similar to the [screenshot shown](https://github.com/Sharan-Kumar-R/Custom-MCP-Server/blob/main/Claude_View.png).
  68. #### Step 3: Start Using the Tools
  69. Paste the URLs of required platform and ask the AI to provide information of the mentioned URLs.
  70. ### Example Usage
  71. ```
  72. Please scrape this LinkedIn profile: https://linkedin.com/in/example-profile
  73. ```
  74. ```
  75. Get company information for: https://linkedin.com/company/example-company
  76. ```
  77. ## Troubleshooting
  78. If the MCP tools don't appear in Claude Desktop:
  79. ### Step 1: End Claude Processes
  80. - Windows: Open Task Manager (Ctrl+Shift+Esc)
  81. - Mac: Open Activity Monitor
  82. - End all Claude-related processes
  83. ### Step 2: Reinstall the Server
  84. ```bash
  85. uv run mcp install main.py
  86. ```
  87. ### Step 3: Restart Claude Desktop
  88. Paste the URLs of required platform and ask the AI to provide information of the mentioned URLs.
  89. ### Testing with MCP Inspector
  90. Alternatively, you can test it with the MCP Inspector:
  91. ```bash
  92. uv run mcp dev main.py
  93. ```
  94. ## Project Structure
  95. ```
  96. custom-mcp-server/
  97. ├── __pycache__/ # Python bytecode cache (auto-generated)
  98. ├── .venv/ # Virtual environment directory
  99. ├── .env # Environment variables (API keys)
  100. ├── .python-version # Python version specification
  101. ├── main.py # Main MCP server implementation
  102. ├── pyproject.toml # Project configuration and dependencies
  103. ├── README.md # Project documentation
  104. └── uv.lock # UV lock file for reproducible builds
  105. ```
  106. ## Response Format
  107. All tools return JSON-formatted strings containing the scraped data. Example response structure:
  108. ```json
  109. {
  110. "success": true,
  111. "data": {
  112. "profile": {
  113. "name": "John Doe",
  114. "title": "Software Engineer",
  115. "location": "San Francisco, CA",
  116. "bio": "Passionate about technology..."
  117. }
  118. },
  119. "timestamp": "2024-01-15T10:30:00Z"
  120. }
  121. ```
  122. But using these tools via Claudes makes it readable.
  123. ## Contributing
  124. 1. Fork the repository
  125. 2. Create a feature branch
  126. 3. Make your changes
  127. 4. Add tests if applicable
  128. 5. Submit a pull request
  129. In case of any queries, please leave a message or contact me via the email provided in my profile.
  130. <p align="center">
  131. ⭐ <strong>Star this repository if you found it helpful!</strong>
  132. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.