SocialAnalytics is an MCP server that aggregates and exposes social media analytics capabilities across LinkedIn, Facebook, Instagram, and Google search via RapidAPI and Serper APIs. The server provides a collection of analytic tools for each platform, including profile and content analytics, engagement metrics, audience insights, and cross-platform web intelligence. To use it, first install the server in your environment, then start it with the MCP runtime. Once running, you can prompt your AI agent to query the exposed endpoints and tools, such as retrieving profile analytics for a LinkedIn company page, analyzing engagement metrics for an Instagram profile, or performing a Google search that surfaces competitive intelligence data. The server is designed to be invoked through the MCP tooling and responds with structured data streams suitable for AI assistants to synthesize insights.

Prerequisites:

• Python 3.9+ installed on your system
• Access to RapidAPI and Serper APIs with valid keys
• Git (optional, for cloning the repo)
• MCP runtime tooling (uv) installed

Step-by-step installation:

1. Clone the repository (if applicable) git clone <repository-url> cd SocialAnalytics-MCP-rapidapi

2. Create and activate a Python virtual environment (optional but recommended) python -m venv venv source venv/bin/activate # macOS/Linux .\venv\Scripts\activate # Windows

3. Install MCP dependencies via uv (per project docs) uv sync

   This installs: fastmcp, httpx, mcp[cli], python-dotenv, etc.

4. Create and populate environment variables

   • Create a .env file in the project root
   • Add your API keys: RAPIDAPI_KEY=your_rapidapi_key_here SERPER_API_KEY=your_serper_api_key_here

5. Run the MCP server installation and startup uv run mcp install main.py uv run mcp dev main.py # for development/debugging

6. Verify the server is running and accessible via your MCP tooling

   • Use MCP inspector or client tools to call available endpoints and tools

Note: Do not commit the .env file to version control. It should be kept secret.

Tips and common issues:

• Ensure your RapidAPI and Serper API keys are valid and not rate-limited; set them in .env as RAPIDAPI_KEY and SERPER_API_KEY.
• If you encounter MCP installation or runtime issues, restart the MCP runtime and re-run uv run mcp install main.py, then uv run mcp dev main.py for development mode.
• Rate limits: spread requests across the different APIs and consider upgrading RapidAPI subscriptions if you plan to perform high-volume scraping.
• Some data may require public access or specific account permissions on LinkedIn, Facebook, or Instagram; ensure the target profiles/pages are accessible.
• Keep .env out of version control and back it up securely.