io.github.RidioDevelopmentPublished by GitHub account RidioDevelopmentv1.10.0Updated Oct 24, 2026
One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.
SocialCrawl gives an assistant one API to discover and call social media, commerce and web-scraping endpoints, with credit estimates before spending.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.RidioDevelopment%2Fsocialcrawl/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"socialcrawl": {
"type": "http",
"url": "https://mcp.socialcrawl.dev/mcp"
}
}
}MCP server for SocialCrawl — access 21+ social media platforms through one unified API.
SocialCrawl 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.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Add to .cursor/mcp.json in your project root or ~/.cursor/mcp.json globally:
Add to .vscode/mcp.json in your project or your user settings:
User prompt: "Get the TikTok profile for charlidamelio"
Agent flow:
socialcrawl_list_endpoints with platform: "tiktok" to discover available endpointsuser/info endpoint — takes a username parameter, costs 1 creditsocialcrawl_request with platform: "tiktok", endpoint: "user/info", params: { username: "charlidamelio" }Total: 105 endpoints across 21 platforms
New accounts receive 100 free credits — enough to make 100 standard requests or explore multiple platforms before committing to a paid plan.
MIT — see LICENSE for details.
Source: README.md at commit 0a6edbb
Find the Endpoint for a Task
Start here: a task in plain words -> the best endpoints (3 by default) of 646, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free; no key needed.
tasklimitplatformEndpoint Contract
Read before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. id (or platform+resource, path), a platform slug (its endpoints) or a guide topic. Free.
idrequiredpagemethodEstimate Credit Cost
Exact credits before you spend: one call (id, platform+resource or path, plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table; no id gives the pricing overview. Free.
idbodyplancallsitemsmethodparamsCall an Endpoint
Call one endpoint (platform+resource, or id, or path). Validated locally first (a bad call is free), quoted, refused above max_credits and confirmed above the threshold. A large page is cut at row boundaries; socialcrawl_collect result_id reads the rest. Spends credits; needs SOCIALCRAWL_API_KEY.
bodyfieldsformatmethodparamsconfirmplatformrequiredresourcerequiredmax_itemsmax_creditsidempotencyKeyCollect Rows Across Pages
Walk a paged endpoint (id, platform+resource or path) to `items` unique rows, the last page or max_credits: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Small results come back whole. result_id (+offset, limit, format) reads a stored result, free. Spends credits.
iditemslimitfieldsformatoffsetparamsconfirmresult_idmax_creditsAccount and Service Status
Free checks: balance (with this session's spend), transactions (itemised ledger; the receipts for one request_id), status (platform health; read it before retrying a 502/503) and freshness (whether this server's bundled catalogue is behind the API).
viewlimitcursorrequest_idManage Monitors, Cohorts, Web and Jobs
Stateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused free with the rules. Managing is free; scrapes, jobs, queries and monitor runs bill credits. dry_run: true validates and quotes a create/update and never creates it. rows_new alerts need track (id=monitors).
idarearequiredinputactionrequireddry_runidempotencyKey100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
{ "mcpServers": { "socialcrawl": { "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "your_api_key_here" } } }}{ "mcpServers": { "socialcrawl": { "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "your_api_key_here" } } }}{ "servers": { "socialcrawl": { "type": "stdio", "command": "npx", "args": ["-y", "socialcrawl-mcp"], "env": { "SOCIALCRAWL_API_KEY": "your_api_key_here" } } }}