{"_id":"@andrewlwn77/social-media-mcp","name":"@andrewlwn77/social-media-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@andrewlwn77/social-media-mcp","version":"1.0.0","description":"MCP server for downloading content from social media platforms","main":"dist/index.js","bin":{"social-media-mcp":"dist/index.js"},"scripts":{"build":"tsc","postbuild":"chmod +x dist/index.js","dev":"tsc --watch","start":"node dist/index.js"},"keywords":["mcp","model-context-protocol","social-media","download","tiktok","instagram","content-downloader"],"author":{"name":"andrewlwn77"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","axios":"^1.6.0","dotenv":"^16.0.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.0.0"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/andrewlwn77/social-media-mcp.git"},"bugs":{"url":"https://github.com/andrewlwn77/social-media-mcp/issues"},"homepage":"https://github.com/andrewlwn77/social-media-mcp#readme","_id":"@andrewlwn77/social-media-mcp@1.0.0","gitHead":"04e12ffa8c556ed49d8c7b04a193269c94d27187","types":"./dist/index.d.ts","_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-+uJSU01sd16BlaybdjwOHyzqDNUBZQnVnjESWjWHzXS/qBUSa/Qdprps8RBQ6Gpo9jFqV0GCsJn6EpXvJJEeAw==","shasum":"d9f526b52beb93753d37fb04b9bfee205d2545cb","tarball":"https://registry.npmjs.org/@andrewlwn77/social-media-mcp/-/social-media-mcp-1.0.0.tgz","fileCount":15,"unpackedSize":37413,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDbJo9skkS4c36P62jVId2Qi3PXplH2spHCCaNNgXAL1wIhANg5Is6oI0W2u7axJieb60IbD4YCuyOk7NNfVfXY1KNo"}]},"_npmUser":{"name":"andrewlwn77","email":"andrewlwn@gmail.com"},"directories":{},"maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/social-media-mcp_1.0.0_1756510305689_0.36114102855965124"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-29T23:31:45.607Z","1.0.0":"2025-08-29T23:31:45.890Z","modified":"2025-08-29T23:31:46.156Z"},"maintainers":[{"name":"andrewlwn77","email":"andrewlwn@gmail.com"}],"description":"MCP server for downloading content from social media platforms","homepage":"https://github.com/andrewlwn77/social-media-mcp#readme","keywords":["mcp","model-context-protocol","social-media","download","tiktok","instagram","content-downloader"],"repository":{"type":"git","url":"git+https://github.com/andrewlwn77/social-media-mcp.git"},"author":{"name":"andrewlwn77"},"bugs":{"url":"https://github.com/andrewlwn77/social-media-mcp/issues"},"license":"MIT","readme":"# Social Media MCP\n\nA Model Context Protocol (MCP) server for downloading content from social media platforms.\n\n## Features\n\n- Download videos, images, and audio from major social media platforms\n- Support for TikTok, Instagram, Facebook, Twitter, YouTube, Pinterest, and LinkedIn\n- In-memory caching to reduce API calls\n- Comprehensive error handling\n- URL validation for supported platforms\n\n## Installation\n\n```bash\nnpm install @andrewlwn77/social-media-mcp\n```\n\n## Configuration\n\nSet up your environment variables:\n\n```bash\nexport SOCIAL_DOWNLOAD_API_KEY=\"your-rapidapi-key-here\"\nexport CACHE_ENABLED=\"true\"                 # Optional, default: true\nexport CACHE_TTL_SECONDS=\"300\"             # Optional, default: 300 (5 minutes)\nexport CACHE_MAX_ENTRIES=\"100\"             # Optional, default: 100\n```\n\nGet your API key from [RapidAPI - Social Download All In One](https://rapidapi.com/nguyenmanhict-MuTUtGWD7K/api/social-download-all-in-one)\n\n## MCP Configuration\n\nAdd to your Claude Code `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"social-media-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@andrewlwn77/social-media-mcp\"],\n      \"transport\": {\n        \"type\": \"stdio\"\n      },\n      \"env\": {\n        \"SOCIAL_DOWNLOAD_API_KEY\": \"your-rapidapi-key-here\",\n        \"CACHE_ENABLED\": \"true\",\n        \"CACHE_TTL_SECONDS\": \"300\",\n        \"CACHE_MAX_ENTRIES\": \"100\"\n      }\n    }\n  }\n}\n```\n\n## Supported Platforms\n\n- **TikTok**: `https://www.tiktok.com/@username/video/123456789`\n- **Instagram**: `https://www.instagram.com/p/ABC123/`\n- **Facebook**: `https://www.facebook.com/user/posts/123456789`\n- **Twitter/X**: `https://twitter.com/user/status/123456789` or `https://x.com/user/status/123456789`\n- **YouTube**: `https://www.youtube.com/watch?v=ABC123` or `https://youtu.be/ABC123`\n- **Pinterest**: `https://www.pinterest.com/pin/123456789`\n- **LinkedIn**: `https://www.linkedin.com/posts/user-123456789`\n\n## Usage\n\nThe MCP server provides one tool:\n\n### `download_social_content`\n\nDownload content from social media URLs.\n\n**Parameters:**\n- `url` (string, required): Social media URL to download content from\n\n**Example:**\n```json\n{\n  \"url\": \"https://www.tiktok.com/@username/video/123456789\"\n}\n```\n\n**Response:**\nReturns formatted text with:\n- Platform information (TikTok, Instagram, etc.)\n- Content title and author\n- High-quality thumbnail URL\n- Multiple download options with quality levels:\n  - HD videos without watermarks\n  - Standard quality videos \n  - Audio-only versions\n- File sizes in MB\n- Content duration\n\n**Example Response:**\n```\n**Social Media Content Download**\n\n**Platform**: Tiktok\n**Source URL**: https://www.tiktok.com/@username/video/123456789\n\n**Title**: Amazing video title #hashtag\n**Thumbnail**: https://thumbnail-url.jpg\n\n**Available Downloads**:\n1. **VIDEO** (hd_no_watermark) (14.22MB): https://download-link-hd.mp4\n2. **VIDEO** (no_watermark) (10.09MB): https://download-link-standard.mp4\n3. **AUDIO** (audio): https://audio-download-link.mp3\n\n**Duration**: 88s\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run in development mode\nnpm run dev\n```\n\n## Error Handling\n\nThe server provides comprehensive error handling for:\n- Invalid URL formats\n- Unsupported platforms\n- Private or restricted content\n- API rate limits\n- Network errors\n- Authentication issues\n\n## Caching\n\nThe server includes an in-memory LRU cache with TTL support to:\n- Reduce API calls for duplicate requests\n- Improve response times\n- Respect rate limits\n- Store successful download results\n\n## License\n\nMIT\n\n## Support\n\nFor issues and questions, please visit the [GitHub repository](https://github.com/andrewlwn77/social-media-mcp).","readmeFilename":"README.md","_rev":"1-6b9849a0a24c0f7d642f40370007ff77"}