{"_id":"@socialapis/mcp","_rev":"15-324ffa202208c13238b4441b24ff1770","name":"@socialapis/mcp","dist-tags":{"latest":"2.2.0"},"versions":{"1.0.1":{"name":"@socialapis/mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","tiktok"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.0.1","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"f313e7f0f8c3e2063ac96ad1b958e99babe0fc24","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.0.1.tgz","fileCount":11,"integrity":"sha512-4e6VzZ1pmeR48PxmrBA5bB6UJyGN/XI8vBpuOQPKjXLEawWvT78f16J9z+grftVrZY/koquNx6vQMroTFOZ34A==","signatures":[{"sig":"MEUCIQC02PUfQ05DvECoZvkcMCT6YrO92HK4VVDMRROsXlRBBwIgYPKCGcPt6ZbVGVciDqmz7tXhY6d1yw0+idYDsyxlWho=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25044},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"b056cbcf4ad0097d87375ac8188a470376d064d3","mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server and client for SocialAPIs - Access social media data in Claude, Cursor, and any MCP-compatible tool","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.1_1766069167336_0.22811090710492787","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@socialapis/mcp","version":"1.0.2","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","tiktok"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.0.2","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"532ae2f238ed7e35d5d728538ade344eb9c7ab56","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.0.2.tgz","fileCount":12,"integrity":"sha512-CwwEzhcKE4T036KLxP/WS8yh0bZfOrq5qUkWP5ootkUIpH6aOSNsBEwRYkCM+9DfXUord9lZuZ5qTgt+Sp27rQ==","signatures":[{"sig":"MEYCIQCSdxA9yyE0usAIF3TSNZL5iPcDGMdqennWOpZXg0fJ8gIhALznxm4Dyo2Z+beajhgo3aEoQSH7p1VirF46v5ws2Sdc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48522},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server and client for SocialAPIs - Access social media data in Claude, Cursor, and any MCP-compatible tool","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.2_1782739920092_0.5699875890382178","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@socialapis/mcp","version":"1.0.3","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","tiktok"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.0.3","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"9c7bc3ac949d9db438c75782e66bd4f4c949b176","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.0.3.tgz","fileCount":12,"integrity":"sha512-0QJ7VQknLU4jGMZLU33h9pNKqcDp08dPHLHixFssYf92vqkJzfE+wT/oDrvYsfmr823v4pK0OdPyzD1IaiU4tQ==","signatures":[{"sig":"MEQCICOjLjfJLaEJWLAyc03LR4b6cFu/P8iEvsCOTjQh2hUYAiASFZUR4ip5z8xn1QZCDWFRRqBTy4mlHVnKO6KRk42cJg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54103},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server and client for SocialAPIs - Access social media data in Claude, Cursor, and any MCP-compatible tool","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.3_1782741840976_0.007452879706162152","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@socialapis/mcp","version":"1.0.4","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","tiktok"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.0.4","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"f7d8ed802329b8f7db54707e6154af3e85bb365d","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.0.4.tgz","fileCount":12,"integrity":"sha512-rMpmx9UEj7GnxBSuHMrTLybZuy85zWUatCbiIhe6N5pVp4Qs5U5GJZJK0essZJq0naQQGCSi4HYP8R3Ooh6tbw==","signatures":[{"sig":"MEQCIAoBpk7Xo9nOXLwLJcQ684VW8u2OxC/xK8YM49q6YhUIAiBfrqiq9w4P3gyy5xhIrKoFOwz383JWJaHDyo1P5oawGw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56005},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server and client for SocialAPIs - Access social media data in Claude, Cursor, and any MCP-compatible tool","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.4_1782745062239_0.49611940129120713","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@socialapis/mcp","version":"1.1.0","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.1.0","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"069b6714ac7a77f53179a62f2ed9daf7d69ff6b7","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.1.0.tgz","fileCount":12,"integrity":"sha512-M1lfAQ8S89Bgy0IoHVKKDl5S61ym0KvyW/ExHb0Z8WtXhAhiv+0Ia7q/psCTJMuP9GMlJ8liTN94M/A3YhbuuQ==","signatures":[{"sig":"MEQCIGjf9XjYbVEoOEPYLFiovtHiLr2/ky7uDmS8mEeOhuotAiANC3yL+oR8bzi0/wr+YViIaklIpoJyxXdiiQbdt/x4kw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIHBQwZ209WJeQad+1PUAbuRIqf54gZN0lPSIrwTa53DDAiEAyTFYHrh2Qbz3yrl8eOmEhouH90usUvJ7A8BRkxH86OU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63132},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1790922596590_0.6208201150416626","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@socialapis/mcp","version":"1.2.0","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.2.0","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"4d04e70de393eccd6f097b0bf0a2179b6caff7b1","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.2.0.tgz","fileCount":13,"integrity":"sha512-upFv7jGPJgOxYks3+nroE5pHGrHweoPygmYEsqXQL13p5EahR27pXanj8rA0AoMb4eBEsd9MUXkfglKVmw4muA==","signatures":[{"sig":"MEYCIQD9K3UfYNf6IDKwcFpvWGqBMmlmkxiIc4QNM1+BxA0eMwIhAM8dPrgjRBlq1kQUe1mgB5dM3FCaV0D5hM1kkvJCbAiU","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCpQl3GYwgyzXCQRG7W9+XBv6v+da6z3itJK2QXmRTvDwIgYwWkN3FzMWKuHLNuOraIcFIgf0VQ/76ZM8zB7fKEm1E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68822},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.0_1790924888206_0.20006227895853224","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@socialapis/mcp","version":"1.2.1","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@1.2.1","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"822c5bd8f8f3bbd3e031a981b10dcd1bf1c98d1b","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-1.2.1.tgz","fileCount":18,"integrity":"sha512-C6O2eFdmELE2cMoU9oV39xWJ3YR9erP+KLdBXM1X4mjNlrtnXIvTmxu9oCUK1egBriaFaMzuB6B6oAZw4WKx0g==","signatures":[{"sig":"MEQCIFjBEAsSTjUKckb8Hi2m969g55t62C2O6/59nq2GPPFMAiBykbpFNbhUVAVBfLS6Igs0lkl0voX6iTtMJ9Yz8CKTQA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCE8Jhy37trvKTUhkVTZO5083vR8bppK47wKXmKWcJXPwIgOX8jkrEZ27iu60dPwXbLXN3j0ZVwxtzrhxaOkJM/9kk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":198643},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.1_1791280140466_0.02652850197696166","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@socialapis/mcp","version":"2.0.0","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@2.0.0","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"c5374f13fb794e57a34d0bc0fd1606c941ea4091","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-2.0.0.tgz","fileCount":19,"integrity":"sha512-W7fWWq5w0m2hyHp40cQ61g4jgv8ytDjfMIpPIDIHoQ7aKOs9eFCxzaSCQNEIPDi6dlHLaiwtl+xALcZ/wU5SFA==","signatures":[{"sig":"MEQCIA47uFqfVH4prxdtrFs1L231UvzmJLI2i04ipIlH8cnvAiBF/2QoMA++epXu/EPIJdIhjP505E38BLTYPCly/bJadA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCrGEN341rz9cD7s0njA5j0VKt2EudMjYN2HCf55kPKqAIgGDI45zKmDd3LTTl99vv0OhhDzt0SYqYwx2IeYb+9BsA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":164605},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_2.0.0_1791284240597_0.5136513597221377","host":"s3://npm-registry-packages-npm-production"}},"2.0.1":{"name":"@socialapis/mcp","version":"2.0.1","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@2.0.1","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"3cb86be78b6028ee6fe9ca320ff58bed8a71ab9d","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-2.0.1.tgz","fileCount":19,"integrity":"sha512-aUJn27Ho86r8LphKIldednr+P9gVj7uwYOotoCiEbZD/T+GTQWvJCe5uUmSW9pdGeMSFuopsIFMvCtNzabPJKA==","signatures":[{"sig":"MEUCIQDh9slA3jiostXleZoBLFIzxN/eG68BB96/tTK6RJ76QAIgNCzk09CIlSw3xBJFKZmoXg6HtpvQHVg/dv7ekxemev0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDST0pa1nm8To0TMugMm1ZNQ+7m7gGr9pg8Oh4bKWiF0AIgMCAeW7nHMFTjvmTw25f5YggUs2N6lBPfeqLndFAi5uM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":169137},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"22.22.2","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_2.0.1_1791454678650_0.6149593733738015","host":"s3://npm-registry-packages-npm-production"}},"2.0.2":{"name":"@socialapis/mcp","version":"2.0.2","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@2.0.2","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"5788ce12dca2c71f1a76c4ca66318b18813bf3ea","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-2.0.2.tgz","fileCount":19,"integrity":"sha512-hRx53YgcLQERb+kOHqAn8lYEDeDDkPMr2sDnFT8P6J1VYHidXDPhJmhXPIpkNDEDeAbvRLeGuveFOdZoG1THlQ==","signatures":[{"sig":"MEQCID+XgOtnwgK0EvTJj1iSR/vaJb2jjEYImiUoVEd+NRewAiAF/AANu5036NopBPRSda+lwdSyZg2QqikTv1gWNkCl0A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQD0y3p/YtmMiSr4n5ws6p7daqf4jXsgPW9H9T3C3IVzGAIgSYM6r+6sOjwcWzLti08UXTLW6b+05IJ0z6B2FWySS6A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":176123},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"22.22.2","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_2.0.2_1791457945015_0.6564559501912177","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@socialapis/mcp","version":"2.1.0","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@2.1.0","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"6cb2d142935495252fb4b689469b9c6be428e251","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-2.1.0.tgz","fileCount":20,"integrity":"sha512-N+IG4xv1RNo7gitnWV1rS9IAX/J0BrGinpfTf2OiH7H9NfU9QQ8++fB79rbU5tuTKfGiCj0H7MaOv1Ej9Qubyg==","signatures":[{"sig":"MEUCIQCa+G3yFxfp7zo6Qa/ZDI+tRBlJotchufLLgtY4bCApFwIgNLWha/5sRVgUK/PEUyADYxvmkw25GgYesmmCjzRP25c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIByUkAcYjEIG4zoinNh4nPTO6bTXiZPQJc9zWiGUb1bDAiEAiXeboBVC4dgWcliPkvZHrgi90bfqE4YT+/0cuES/Mxg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":184988},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_2.1.0_1792075342521_0.4848966550630649","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@socialapis/mcp","version":"2.1.1","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"author":{"name":"SocialAPIs"},"license":"MIT","_id":"@socialapis/mcp@2.1.1","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"homepage":"https://socialapis.io","bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"bin":{"socialapis-mcp":"mcp-wrapper.js"},"dist":{"shasum":"7638a528aa930eac567e0dafbc24d01714208a61","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-2.1.1.tgz","fileCount":21,"integrity":"sha512-Plv2i9BCcIm0wYawkpd7Y16rAx9ro79scVISfirhVtkSIpMrqxXYLAHG1GvOZUMyLmCimmFXtBR1AOj9uY2Lrg==","signatures":[{"sig":"MEUCIQDr36PUemcXCEhpMHb1jVIsDmUCaUzbDpzIUHEN7jqUkQIgXN9pxwgtpsxBCiHh6rJnSzzpDzhQuyRQidM5NIBEttU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDEIwqhOsYhQc/DbKzBk8jZb7VuX8+GiVL7ZZt4BjFXDQIgb8+d1keUM/5mBfNaLzu6voNvcuCA4rSBDiqmH0G5v9E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":189348},"main":"mcp-wrapper.js","type":"module","engines":{"node":">=18.0.0"},"mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js"},"_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_2.1.1_1792135417190_0.8354493503229956","host":"s3://npm-registry-packages-npm-production"}},"2.2.0":{"_id":"@socialapis/mcp@2.2.0","bin":{"socialapis-mcp":"mcp-wrapper.js"},"bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"dist":{"shasum":"1bdefc8602638ff55370565d3d1631adba6ce71b","tarball":"https://registry.npmjs.org/@socialapis/mcp/-/mcp-2.2.0.tgz","fileCount":27,"integrity":"sha512-cVRpcL/xH2gp7cLsW98SNa4lkccnkXWekZgm5KSBrv7i8vNL9mi+wuaM5KoonL+vL+uzdFqNoYnVjjGeZbqNpg==","signatures":[{"sig":"MEUCIQCJgU1mjfdi5sXjvsbLX0N8snIhS3dzVSYUyWCVOLJaxgIgfw0mNWf91WL8kYCVaUq75rpug5ZEB7/ATyFPuvsZ2Lk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGYa6B2CMBhxt/U4/oRwlWbBuF7q8dyzmIPrPuUYZD7jAiEAs9oCOkksK/XvnsOMwOpDfwsxgjlAHqLqFO/EiXQM9mE="}],"unpackedSize":259755},"main":"mcp-wrapper.js","name":"@socialapis/mcp","type":"module","author":{"name":"SocialAPIs"},"engines":{"node":">=18.0.0"},"license":"MIT","mcpName":"io.github.SocialAPIsHub/social-media-api","scripts":{"test":"node mcp-wrapper.js test-key","serve":"node server.js","start":"node mcp-wrapper.js","test:unit":"node --test test/"},"version":"2.2.0","_npmUser":{"name":"socialapis","email":"oussemaa.frikha@gmail.com"},"homepage":"https://socialapis.io","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","directories":{},"maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"_nodeVersion":"20.19.0","dependencies":{"cors":"^2.8.5","express":"^4.18.2","@modelcontextprotocol/sdk":"^1.31.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_2.2.0_1793083659529_0.9689202722800887"}}},"time":{"created":"2025-12-18T14:46:07.163Z","modified":"2026-10-27T06:47:39.829Z","1.0.0":"2025-12-17T16:55:23.791Z","1.0.1":"2025-12-18T14:46:07.533Z","1.0.2":"2026-06-29T13:32:00.236Z","1.0.3":"2026-06-29T14:04:01.121Z","1.0.4":"2026-06-29T14:57:42.359Z","1.1.0":"2026-10-02T06:29:56.685Z","1.2.0":"2026-10-02T07:08:08.300Z","1.2.1":"2026-10-06T09:49:00.559Z","2.0.0":"2026-10-06T10:57:20.685Z","2.0.1":"2026-10-08T10:17:58.740Z","2.0.2":"2026-10-08T11:12:25.134Z","2.1.0":"2026-10-15T14:42:22.615Z","2.1.1":"2026-10-16T07:23:37.279Z","2.2.0":"2026-10-27T06:47:39.636Z"},"bugs":{"url":"https://github.com/SocialAPIsHub/mcp-server/issues"},"author":{"name":"SocialAPIs"},"license":"MIT","homepage":"https://socialapis.io","keywords":["mcp","model-context-protocol","social-media","api","ai-agents","claude","cursor","facebook","instagram","remote-mcp","streamable-http"],"repository":{"url":"git+https://github.com/SocialAPIsHub/mcp-server.git","type":"git"},"description":"MCP server for SocialAPIs — Facebook & Instagram data in Claude, Cursor and any MCP client. Run locally via npx or use the hosted endpoint at https://mcp.socialapis.io/mcp","maintainers":[{"name":"socialapis","email":"oussemaa.frikha@gmail.com"}],"readme":"# SocialAPIs MCP Server\n\n<div align=\"center\">\n\n![SocialAPIs Logo](https://socialapis.io/logo.png)\n\n**Facebook & Instagram data for AI agents — local (npx) or hosted (remote MCP)**\n\n[![npm version](https://badge.fury.io/js/%40socialapis%2Fmcp.svg)](https://www.npmjs.com/package/@socialapis/mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![GitHub stars](https://img.shields.io/github/stars/SocialAPIsHub/mcp-server.svg)](https://github.com/SocialAPIsHub/mcp-server/stargazers)\n[![SocialAPIs MCP Server MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/SocialAPIsHub/mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/SocialAPIsHub/mcp-server)\n\n[Website](https://socialapis.io) • [Documentation](https://docs.socialapis.io) • [Discord](https://discord.gg/D5bQskrwV) • [npm](https://www.npmjs.com/package/@socialapis/mcp)\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=socialapis&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzb2NpYWxhcGlzL21jcCJdLCJlbnYiOnsiU09DSUFMQVBJU19BUElfS0VZIjoiWU9VUl9BUElfS0VZIn19)\n\n**Official SDKs:** [Python](https://pypi.org/project/socialapis-sdk/) • [JavaScript / TypeScript](https://www.npmjs.com/package/socialapis-sdk) • [Go](https://github.com/SocialAPIsHub/socialapis-go)\n\n</div>\n\n---\n\n## 🚀 Quick Start\n\n> **AI agents (Cline, Claude Code, Cursor):** follow [`llms-install.md`](llms-install.md) for step-by-step install and verification.\n\n**One-click:** use the **Install in Cursor** button above — then replace `YOUR_API_KEY` in Cursor's MCP settings with your key. Also listed on [Smithery](https://smithery.ai), [cursor.directory](https://cursor.directory/plugins/socialapis-facebook-instagram-data), [mcp.so](https://mcp.so/servers/socialapis-facebook-instagram-data) and the [official MCP Registry](https://registry.modelcontextprotocol.io) (`io.github.SocialAPIsHub/social-media-api`).\n\n### Option A — Hosted (remote MCP, no install)\n\nPoint any client that supports remote MCP servers (Streamable HTTP) at:\n\n```\nhttps://mcp.socialapis.io/mcp\n```\n\nAuthenticate with your SocialAPIs API key in a header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n(`x-api-token: YOUR_API_KEY` also works.) Tool listing works without a key; tool calls need one. Example config for clients that take a URL + headers:\n\n```json\n{\n  \"mcpServers\": {\n    \"socialapis\": {\n      \"url\": \"https://mcp.socialapis.io/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n    }\n  }\n}\n```\n\n### Option B — Local (npx, stdio)\n\n### Installation\n```bash\nnpm install -g @socialapis/mcp\n```\n\n### Configuration\n\nAdd to your Claude Desktop config:\n\n**macOS:**\n```bash\nnano ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n```\n\n**Windows:**\n```powershell\nnotepad %APPDATA%\\Claude\\claude_desktop_config.json\n```\n\n## 🔧 Configuration\n\n### Method 1: Command Line Argument (Recommended for Claude Desktop)\n```json\n{\n  \"mcpServers\": {\n    \"socialapis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@socialapis/mcp\", \"YOUR_API_KEY\"]\n    }\n  }\n}\n```\n\n### Method 2: Environment Variable\n```bash\n# Set environment variable\nexport SOCIALAPIS_API_KEY=your_api_key_here\n\n# Run without argument\nnpx @socialapis/mcp\n```\n\n### Method 3: .env File (For Development)\n```bash\n# Copy example file\ncp .env.example .env\n\n# Edit with your values\nnano .env\n```\n\n**.env file:**\n```properties\nSOCIALAPIS_API_KEY=your_api_key_here\nMCP_PROXY_URL=https://mcp.socialapis.io\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `SOCIALAPIS_API_KEY` | Your SocialAPIs API key | None (required) |\n| `MCP_PROXY_URL` | MCP proxy server URL | `https://mcp.socialapis.io` |\n| `PORT` | HTTP server port | `3001` |\n| `API_BASE_URL` | Backend API URL | `https://api.socialapis.io` |\n| `SOCIALAPIS_CATALOG_URL` | Live endpoint catalog the server follows (server only) | `https://auth.socialapis.io/api/public/endpoints` |\n| `SOCIALAPIS_CATALOG_REFRESH_MS` | How often the catalog (server) or tool list (npm client) is re-read | `600000` (10 min) |\n| `SOCIALAPIS_LIVE_CATALOG` | `0` = always use the bundled definitions (server only) | on |\n\n### Live catalog\n\nPrices, descriptions and parameters follow the SocialAPIs API without a new release. The server reads the public endpoint catalog at startup (3 s timeout) and every 10 minutes, compares it with `src/catalogBaseline.json` (the catalog `src/tools.js` was written against) and applies only what changed since: a new price replaces the tool's `Pricing:` sentence, an edited description or parameter replaces ours, added and removed parameters are added and removed, and a disabled endpoint's action says \"Currently unavailable.\" Tool and action names never change, and new endpoints don't become tools until a release adds them. If the catalog can't be read, or a change would make two actions' parameters conflict, the last good definitions (at first the bundled ones) stay. `GET /health` shows `catalog: { source, version, fetchedAt, routes }`. The npm client re-reads the tool list every 10 minutes and sends `notifications/tools/list_changed` when it changes.\n\nAfter updating `tools.js` to match the API, refresh the baseline: `node scripts/snapshot-catalog.mjs --from https://auth.socialapis.io/api/public/endpoints` (public fields only).\n\n### Get API Key\n\n1. Sign up at [socialapis.io](https://socialapis.io)\n2. Go to [Dashboard](https://socialapis.io/dashboard)\n3. Copy your API key\n4. Replace `YOUR_API_KEY` in config\n\n### Test It\n\nRestart Claude Desktop and ask:\n```\nGet Nike's Facebook page details\n```\n\n---\n\n## 📋 Features\n\n- 🌐 **One API key** - Facebook and Instagram behind a single interface\n- 🤖 **AI-First** - Built for Claude, Cursor, and AI agents\n- 📊 **Rich Data** - Posts, comments, engagement metrics\n- 🔍 **Advanced Filtering** - Time ranges, pagination\n- 🎯 **Simple Auth** - No OAuth complexity\n- 🧩 **Structured output** - every tool declares an output schema and returns `{ result, creditsCharged, creditsRemaining }`, so agents can track credit spend directly\n- 🛡️ **Read-only annotations** - all tools are marked `readOnlyHint`, so clients can skip confirmation prompts\n- ⚡ **Fast** - Global edge network\n- 🔒 **Secure** - API keys stay local\n\n---\n\n## 🛠️ Available Tools\n\n12 tools covering 50 actions across Facebook and Instagram. Each tool groups one resource and takes an `action` argument; every action maps to one REST endpoint on `api.socialapis.io`. Tool descriptions list each action, the parameters it needs and its credit cost.\n\n| Tool | Actions |\n|---|---|\n| `facebook_page` | `details` (followers, contact info, category; `exact_followers_count=true` costs 5 credits), `id`, `posts` (`limit` 3-9, date filters), `videos` (`limit` 6-12), `reels`, `albums` (`profile_id` from `id`, `limit` 8-16), `album_items` (photos and videos in an album) |\n| `facebook_group` | `details`, `id`, `posts` (`limit` 3-9, date filters), `videos`, `albums` (`group_id` from `id`, `limit` 8-16), `album_items` |\n| `facebook_post` | `details`, `details_extended` (view counts, video URLs, audio metadata), `id`, `attachments` (5 credits), `video`, `comments`, `comment_replies` |\n| `facebook_search` | `pages`, `people`, `posts`, `videos`, `locations` (location UIDs for the other searches) |\n| `facebook_ads` | `search` (ads by keyword, page, country, status), `keywords` (advertisers for a keyword), `page_details`, `archive_details`, `countries` |\n| `facebook_marketplace` | `search` (price, location, category, condition filters), `vehicles`, `rentals`, `listing`, `seller`, `categories`, `city_coordinates` |\n| `facebook_media_download` | Download URLs for Facebook images and videos |\n| `instagram_profile` | `details`, `id`, `posts`, `reels`, `highlights`, `highlight_details` |\n| `instagram_post` | `details`, `id` (shortcode from a post URL) |\n| `instagram_reels` | `feed`, `by_audio` |\n| `instagram_search` | Popular users, hashtags and places for a keyword |\n| `instagram_location` | `posts` (recent or top), `nearby` |\n\nExample call: `facebook_page` with `{\"action\": \"posts\", \"link\": \"https://www.facebook.com/nike\", \"limit\": 9}`.\n\n**Upgrading from 1.x:** the earlier per-endpoint tool names (`facebook_get_page_details`, `instagram_get_profile_posts`, …) still work when called directly, so existing prompts and scripts keep running. They're no longer listed. If your client auto-approves tools by name, add the new names.\n\n### Not supported yet\nOnly Facebook and Instagram are live today. TikTok, X / Twitter, LinkedIn and YouTube are on the roadmap with no committed dates — tools for them will appear here only once they ship.\n\nTrack the platform roadmap at [socialapis.io/api-sources](https://socialapis.io/api-sources).\n\n---\n\n## 💡 Usage examples\n\nEach prompt below is a real Claude Desktop session. Some of these are single-tool-call patterns (\"get me X\"); some require Claude to chain multiple calls + aggregate the results (noted where).\n\n### Single-call patterns (fast, cheap)\n\n```\nWhat's Nike's follower count on Facebook?\n→ Uses facebook_page action=details (1 credit)\n\nGet the latest 9 posts from facebook.com/EngenSA\n→ Uses facebook_page action=posts with limit=9 (1-3 credits depending on actual returned count)\n\nShow me the Meta ads currently running for \"Apple Vision Pro\" in Germany\n→ Uses facebook_ads action=search (1 credit)\n```\n\n### Multi-call patterns (Claude orchestrates these — but it's slower + more expensive)\n\n```\nCompare engagement on Nike vs Adidas's last 9 Facebook posts\n→ Claude calls facebook_page action=posts twice (~2-6 credits total),\n  aggregates reactions/comments/shares per post, returns a comparison.\n\nWhat are people saying in the comments on Coca-Cola's last 3 posts?\n→ Claude calls facebook_page action=posts (1 credit) then\n  facebook_post action=comments 3 times (3 credits) and summarizes.\n\nShow me marketplace listings for \"PlayStation 5\" under $400 in Berlin\n→ Claude calls facebook_marketplace action=city_coordinates (1 credit) +\n  facebook_marketplace action=search with filters (1 credit).\n```\n\n### What this MCP server does NOT do\n\nSome queries look natural in a chat (\"compare engagement over the last month\") but require aggregations the API doesn't expose as a single tool yet. Claude can still answer them, but it'll fan out into many tool calls — which is slow + expensive.\n\n| Query shape | Why it's hard |\n|---|---|\n| \"Engagement rate over the last 30 days\" for a page | Requires fetching every post in the date range (paginated, `limit` capped at 9 per call) and computing engagement per post. Hits the LLM tool-call budget on busy pages. |\n| \"Compare engagement rates between Brand A, B, C over the last month\" | Same problem, 3× — one paginated fetch per brand, then comparison math. Works for small windows; slow for \"last month\" on high-volume pages. |\n| Historical archive older than what Facebook itself serves | We surface what Facebook makes publicly visible. Posts that scrolled off Facebook's visible feed aren't retrievable. |\n| Server-side time-series (daily engagement, weekly growth) | Not yet — on the roadmap as a future `engagement-stats` endpoint with built-in aggregation. |\n\nIf your use case maps to one of these patterns and you want the aggregation pre-computed instead of LLM-orchestrated, [contact support](https://socialapis.io/contact-us) with the specific query — we're prioritizing the aggregation endpoint based on customer demand.\n\n---\n\n## 🏗️ Architecture\n```\nClaude Desktop\n    ↓\n@socialapis/mcp (local MCP client)\n    ↓\nhttps://mcp.socialapis.io (global proxy)\n    ↓\nhttps://api.socialapis.io (data API)\n```\n\n**Why this architecture?**\n- ✅ Low latency (global edge network)\n- ✅ High reliability (99.9% uptime)\n- ✅ Auto rate limiting\n- ✅ Smart caching\n- ✅ Your API key stays local\n\n---\n\n## 🔧 Development\n\n### Local Setup\n```bash\n# Clone repository\ngit clone https://github.com/SocialAPIsHub/mcp-server.git\ncd mcp-server\n\n# Install dependencies\nnpm install\n\n# Run MCP client\nnpm start YOUR_API_KEY\n\n# Run HTTP proxy server\nnpm run serve\n```\n\n### Project Structure\n```\nmcp-server/\n├── src/\n│   ├── tools.js          # The 50 endpoint definitions (one per action)\n│   ├── groups.js         # Groups them into the 12 listed tools\n│   ├── catalogBaseline.json  # The API catalog tools.js was written against\n│   ├── catalogOverlay.js # Applies live catalog changes to the definitions\n│   └── liveCatalog.js    # Fetches the live catalog (startup + every 10 min)\n├── scripts/snapshot-catalog.mjs  # Rewrites catalogBaseline.json\n├── test/                 # node --test (npm run test:unit)\n├── mcp-wrapper.js        # MCP client (runs locally)\n├── server.js             # HTTP proxy server\n├── package.json\n├── Dockerfile\n└── README.md\n```\n\n### Testing\n```bash\n# Unit tests\nnpm run test:unit\n\n# Test MCP client locally\nnode mcp-wrapper.js YOUR_API_KEY\n\n# Test HTTP proxy\ncurl http://localhost:3001/health\ncurl http://localhost:3001/tools\n\n# Test specific tool\ncurl -X POST http://localhost:3001/proxy \\\n  -H \"x-api-key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"tool\":\"facebook_page\",\"arguments\":{\"action\":\"details\",\"link\":\"https://facebook.com/nike\"}}'\n```\n\n---\n\n## 📊 Pricing\n\n| Plan | Credits / month | Price |\n|------|-----------------|-------|\n| **Free** | 200 | $0 |\n| Pro | 1,500 | $4.99 |\n| Ultra | 30,000 | $49 |\n| Mega | 120,000 | $179 |\n| Enterprise | Custom | [Contact us](https://socialapis.io/contact-us) |\n\nMost tools cost 1 credit per call; each tool description states its exact price. Current plans: [socialapis.io/pricing](https://socialapis.io/pricing).\n\n[View detailed pricing →](https://socialapis.io/pricing)\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n### Quick Contribution Guide\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n---\n\n## 📖 Documentation\n\n- [Full Documentation](https://docs.socialapis.io)\n- [API Reference](https://docs.socialapis.io/api-reference/facebook)\n- [MCP Guide](https://docs.socialapis.io/mcp)\n- [Examples](https://github.com/SocialAPIsHub/examples)\n- [Agent skill](https://github.com/SocialAPIsHub/skills): teaches Claude Code, Cursor, Codex and other coding agents to use SocialAPIs (`npx skills add SocialAPIsHub/skills`)\n\n---\n\n## 💬 Support\n\n- 📧 **Email:** [support@socialapis.io](mailto:support@socialapis.io)\n- 💬 **Discord:** [discord.gg/D5bQskrwV](https://discord.gg/D5bQskrwV)\n- 🐛 **Issues:** [GitHub Issues](https://github.com/SocialAPIsHub/mcp-server/issues)\n- 📚 **Docs:** [docs.socialapis.io](https://docs.socialapis.io)\n\n---\n\n## 🗺️ Roadmap\n\n**Shipped:**\n\n- [x] Facebook API support — 7 tools, 37 actions (Pages, Groups, Posts, Search, Ads Library, Marketplace, Media)\n- [x] **Instagram support** — 5 tools, 13 actions (Profiles, Posts, Reels, Highlights, Discovery / Locations)\n- [x] MCP server implementation\n- [x] HTTP proxy server\n- [x] npm package published — [`@socialapis/mcp`](https://www.npmjs.com/package/@socialapis/mcp)\n- [x] **MCP Registry listing** — [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)\n- [x] **Python SDK** — [`socialapis-sdk`](https://pypi.org/project/socialapis-sdk/) on PyPI (50 endpoints, MIT)\n- [x] **JavaScript / TypeScript SDK** — [`socialapis-sdk`](https://www.npmjs.com/package/socialapis-sdk) on npm (Node 18+, Bun, Deno, browsers)\n- [x] **Go SDK** — [github.com/SocialAPIsHub/socialapis-go](https://github.com/SocialAPIsHub/socialapis-go) (idiomatic, zero deps)\n- [x] **Agent skill** — [github.com/SocialAPIsHub/skills](https://github.com/SocialAPIsHub/skills) for Claude Code, Cursor, Codex and other coding agents\n\n**Upcoming:**\n\n- [ ] TikTok support\n- [ ] X (Twitter) support\n- [ ] LinkedIn support\n- [ ] YouTube support\n- [ ] Advanced analytics — server-side aggregation endpoints (engagement-over-time, brand comparisons) so multi-call patterns become a single tool call\n- [ ] Real-time webhooks — push notifications on new posts / engagement thresholds\n- [ ] LangChain integration\n\nPlatform priorities shift based on customer demand. The fastest way to push something up the queue is to email [support@socialapis.io](mailto:support@socialapis.io) or DM [@socialapis on Telegram](https://t.me/socialapis) with the use case.\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- Built with [Model Context Protocol](https://modelcontextprotocol.io)\n- Powered by [Anthropic Claude](https://anthropic.com)\n- Inspired by the AI agent community\n\n---\n\n## 📇 Listed on\n\n[![SocialAPIs MCP Server MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/SocialAPIsHub/mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/SocialAPIsHub/mcp-server)\n\nAlso on the [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.SocialAPIsHub/social-media-api), [Smithery](https://smithery.ai/server/oussemaf/socialapis), [LobeHub](https://lobehub.com/mcp/socialapis-mcp-server), [mcp.so](https://mcp.so/servers/socialapis-facebook-instagram-data), [mcpservers.org](https://mcpservers.org/servers/socialapishub/mcp-server), [cursor.directory](https://cursor.directory/plugins/socialapis-facebook-instagram-data) and [awesome-remote-mcp-servers](https://github.com/punkpeye/awesome-remote-mcp-servers).\n\n---\n\n## 🌟 Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=SocialAPIsHub/mcp-server&type=Date)](https://star-history.com/#SocialAPIsHub/mcp-server&Date)\n\n---\n\n<div align=\"center\">\n\n**Made with ❤️ by the SocialAPIs Team**\n\n[Website](https://socialapis.io) • [Twitter](https://twitter.com/socialapis) • [Discord](https://discord.gg/D5bQskrwV)\n\n[Python SDK](https://pypi.org/project/socialapis-sdk/) • [JS SDK](https://www.npmjs.com/package/socialapis-sdk) • [Go SDK](https://github.com/SocialAPIsHub/socialapis-go)\n\n</div>","readmeFilename":"README.md"}