{
  "markdown": "# socialcrawl-mcp\n\n[![npm version](https://img.shields.io/npm/v/socialcrawl-mcp.svg)](https://www.npmjs.com/package/socialcrawl-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP server for SocialCrawl — access 21+ social media platforms through one unified API.\n\n## What it does\n\nSocialCrawl MCP gives AI agents instant access to 21 social media platforms and 105 endpoints through a single, unified API. Retrieve profiles, posts, comments, search results, trending content, and analytics from TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, and more — no per-platform authentication required. Agents discover available endpoints dynamically, so they always work with the latest capabilities without any hardcoded platform logic.\n\n## Quick Setup\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"socialcrawl\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"socialcrawl-mcp\"],\n      \"env\": {\n        \"SOCIALCRAWL_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root or `~/.cursor/mcp.json` globally:\n\n```json\n{\n  \"mcpServers\": {\n    \"socialcrawl\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"socialcrawl-mcp\"],\n      \"env\": {\n        \"SOCIALCRAWL_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### VS Code (Claude Code)\n\nAdd to `.vscode/mcp.json` in your project or your user settings:\n\n```json\n{\n  \"servers\": {\n    \"socialcrawl\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"socialcrawl-mcp\"],\n      \"env\": {\n        \"SOCIALCRAWL_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Get Your API Key\n\n1. Sign up at [socialcrawl.com](https://socialcrawl.com) — no credit card required\n2. Receive 100 free credits instantly upon registration\n3. Copy your API key from the dashboard and paste it into your config\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `socialcrawl_list_platforms` | Discover all 21 supported platforms with their slugs and endpoint counts |\n| `socialcrawl_list_endpoints` | See all endpoints, required parameters, and credit costs for a specific platform |\n| `socialcrawl_request` | Make any SocialCrawl API call — fetch profiles, posts, comments, search results, and more |\n| `socialcrawl_get_docs` | Access detailed API documentation for a platform or specific endpoint |\n\n## Example\n\n**User prompt:** \"Get the TikTok profile for charlidamelio\"\n\n**Agent flow:**\n\n1. Calls `socialcrawl_list_endpoints` with `platform: \"tiktok\"` to discover available endpoints\n2. Finds `user/info` endpoint — takes a `username` parameter, costs 1 credit\n3. Calls `socialcrawl_request` with `platform: \"tiktok\"`, `endpoint: \"user/info\"`, `params: { username: \"charlidamelio\" }`\n4. Returns profile data: follower count, bio, video count, verification status, and more\n\n## Supported Platforms\n\n| Platform | Endpoints |\n|----------|-----------|\n| TikTok | 24 |\n| Instagram | 12 |\n| YouTube | 11 |\n| Facebook | 12 |\n| X (Twitter) | 6 |\n| LinkedIn | 6 |\n| Reddit | 7 |\n| Threads | 5 |\n| Pinterest | 4 |\n| Google | 4 |\n| Truth Social | 3 |\n| Twitch | 2 |\n| Snapchat | 1 |\n| Kick | 1 |\n| Amazon | 1 |\n| Linktree | 1 |\n| Linkbio | 1 |\n| Linkme | 1 |\n| Komi | 1 |\n| Pillar | 1 |\n| Utility | 1 |\n\n**Total: 105 endpoints across 21 platforms**\n\n## Credit System\n\n| Tier | Cost | Share of Endpoints |\n|------|------|--------------------|\n| Standard | 1 credit | ~90% |\n| Advanced | 5 credits | ~8% |\n| Premium | 10 credits | ~2% |\n\nNew accounts receive 100 free credits — enough to make 100 standard requests or explore multiple platforms before committing to a paid plan.\n\n## License\n\nMIT — see [LICENSE](LICENSE) for details.\n",
  "bytes": 3870,
  "sha": "ad82cf5c7caa78006e4392fc6c07ccb00751931776d2ad4021870ee827060995",
  "repo_slug": "ridiodevelopment/socialcrawl-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ridiodevelopment_socialcrawl_f0b3ec13/readme"
}