{"data":{"name":"io.github.RidioDevelopment/socialcrawl","title":"SocialCrawl","description":"One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.","version":"1.10.0","websiteUrl":null,"repositoryUrl":"https://github.com/RidioDevelopment/socialcrawl-mcp","remotes":[{"url":"https://mcp.socialcrawl.dev/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"description":"Bearer <SOCIALCRAWL_API_KEY>. Optional — discovery tools work without it. Get a free key at socialcrawl.dev (100 credits, no credit card required)."}]}],"packages":[{"version":"1.10.0","identifier":"socialcrawl-mcp","runtimeHint":"stdio","registryType":"npm","runtimeArguments":null,"environmentVariables":null}],"status":"active","isLatest":true,"publishedAt":"2026-09-08T10:22:53.236Z","updatedAt":"2026-09-08T10:22:53.236Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"SocialCrawl","source":"official-registry","sourceId":"io.github.RidioDevelopment/socialcrawl","updatedAt":"2026-09-08T10:22:53.236Z","confidence":100,"websiteUrl":null,"description":"One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.","verification":"official","repositoryUrl":"https://github.com/RidioDevelopment/socialcrawl-mcp"}],"toolIndex":{"tools":[{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_account","title":"Account and Service Status","description":"Free: balance (default, with this session's spend), transactions (ledger), usage (per key per day; from/to YYYY-MM-DD, ≤92 days), status (health; check before retrying a 502/503), freshness (vs live catalogue), notifications (inbox).","inputSchema":{"type":"object","properties":{"view":{"type":"string","enum":["balance","transactions","usage","status","freshness","notifications"]},"unread":{"type":"boolean"},"kind":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Page size."},"cursor":{"type":"string","description":"next_cursor of the last page."},"request_id":{"type":"string","description":"One request's receipts."},"from":{"type":"string"},"to":{"type":"string"},"group_by":{"type":"string","enum":["api_key","day","api_key,day"]},"api_key_id":{"type":"string"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"e45cd168245b3cc75bf9fb7f3e8d06262c78a177e01fbe5e8c4a3a95845f78b8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"},{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_collect","title":"Collect Rows Across Pages","description":"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.","inputSchema":{"type":"object","properties":{"id":{"type":"string","minLength":3,"description":"platform/resource of a paged endpoint, e.g. 'tiktok/post/comments'."},"params":{"type":"object","additionalProperties":{"anyOf":[{"type":["string","number","boolean"]},{"type":"array","items":{"$ref":"#/properties/params/additionalProperties/anyOf/0"}}]},"description":"Params for every page, as in socialcrawl_request. No cursor."},"items":{"type":"integer","minimum":1,"maximum":10000,"description":"Stop once this many unique rows are collected."},"max_credits":{"type":"integer","minimum":1,"description":"Spend cap: refused free when the quoted hold exceeds it (collect: the walk's budget)."},"format":{"type":"string","enum":["jsonl","json","csv"],"description":"jsonl (default), json or csv."},"fields":{"type":"string","description":"Row paths as socialcrawl_endpoint lists them, e.g. 'comment.text,comment.engagement.likes'."},"confirm":{"type":"boolean","description":"true only once the user approved spending above the threshold (default 100 credits)."},"result_id":{"type":"string","description":"Read a stored result instead of walking. Free."},"offset":{"type":"integer","description":"result_id: first row."},"limit":{"type":"integer","description":"result_id: rows (200)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"c34d62c1df84dcf5961b54aa102adc64148daf14bb5c40d31fe528b4a1dda41d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"},{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_endpoint","title":"Endpoint Contract","description":"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.","inputSchema":{"type":"object","properties":{"id":{"type":"string","minLength":1,"description":"'platform/resource' for its contract; a platform slug for its endpoint table; or a guide topic (errors, pricing, pagination, judgments, hydration, overview)."},"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"],"description":"Only for an id served by several methods."},"page":{"type":"integer","minimum":1,"description":"Page of a long guide (default 1)."}},"required":["id"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"ca60892143d002bdc1cadab491e3e8d04ac122cc2aa1a83f541a73a705dd8259","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"},{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_estimate","title":"Estimate Credit Cost","description":"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.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"'platform/resource'; a platform slug for its price table; none for the overview."},"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"]},"params":{"type":"object","additionalProperties":{"anyOf":[{"type":["string","number","boolean"]},{"type":"array","items":{"$ref":"#/properties/params/additionalProperties/anyOf/0"}}]},"description":"The exact params you will send."},"body":{"type":"object","additionalProperties":{},"description":"POST body, for batch endpoints."},"calls":{"type":"integer","minimum":1,"maximum":1000000,"description":"Number of such calls (an array is read as plan)."},"items":{"type":"integer","minimum":1,"description":"Rows wanted (prices a walk)."},"plan":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":3},"method":{"$ref":"#/properties/method"},"params":{"type":"object","additionalProperties":{}},"body":{"type":"object","additionalProperties":{}},"repeat":{"type":"integer","minimum":1}},"required":["id"],"additionalProperties":false},"maxItems":50,"description":"Several calls to total, instead of id."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"e4209802eca8636aaad05f564f0b504930ecf8e62953ba4aec323a61775b7a9b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"},{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_find","title":"Find the Endpoint for a Task","description":"Start here: a task in plain words -> the best endpoints (3 by default) of 733, 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.","inputSchema":{"type":"object","properties":{"task":{"type":"string","maxLength":500,"description":"The job in plain words; URLs and @handles in it are resolved and filled. Omit to list platforms."},"platform":{"type":"string","description":"Only this platform's endpoints (slug, e.g. 'tiktok'); alone, lists them."},"limit":{"type":"integer","minimum":1,"maximum":10,"description":"Endpoints to return (default 3)."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"66dd626b9ef42e01c4f474a4c599b94a8118bce56be131ab53776791b42289fe","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"},{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_manage","title":"Manage Stateful and Background Work","description":"By area + action: monitors, cohorts, web (scrape, crawl, agents, page monitors, sessions), jobs, discover, search_runs (search lists, watches), creator_runs, review_history, events (feed, webhooks). Wrong fields refused free. Managing is free; scrapes, jobs, queries, run_more/include, monitor runs bill.\ndry_run: true quotes, creating nothing. rows_new alerts need track. Docs: discover-runs, search-runs.","inputSchema":{"type":"object","properties":{"area":{"type":"string","enum":["monitors","cohorts","web","jobs","discover","review_history","events","search_runs","creator_runs"]},"action":{"type":"string","minLength":1,"description":"monitors: create|list|get|runs|timeseries|export|pause|resume|delete. cohorts: create|add_members|estimate_cost|query|query_*|get|delete. web: scrape|search|map|extract|crawl|batch_scrape|agent|crawl_preview|job_*|monitor_*|session_*. jobs: submit|list|get. run_* = list|get|export|legs|cancel|resume|more. discover: run_*|schedule_*|follow. search_runs: run_*|run_include|watch_*|follow. creator_runs: run_*|run_save|follow. review_history: get. events: feed|ack|endpoint_*."},"id":{"type":"string","description":"Resource id (events: consumer name)."},"input":{"type":"object","additionalProperties":{},"description":"The action's fields (a job body may add max_credits, confirm). rows_new alert rules: socialcrawl_endpoint id=monitors."},"idempotencyKey":{"type":"string","minLength":16,"description":"Makes a write retry-safe."},"dry_run":{"type":"boolean"}},"required":["area","action"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"70b876549c23f8820df587bc5ca0e4482831dda38296ec34db645ec1b90f1d83","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"},{"serverName":"io.github.RidioDevelopment/socialcrawl","endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","name":"socialcrawl_request","title":"Call an Endpoint","description":"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.","inputSchema":{"type":"object","properties":{"platform":{"type":"string","minLength":1,"description":"Platform slug, e.g. 'tiktok'. An unknown slug gets a did-you-mean."},"resource":{"type":"string","minLength":1,"description":"Resource path, e.g. 'post/comments'; path params as 'jobs/{job_id}' + params.job_id, or the concrete path."},"method":{"type":"string","enum":["GET","POST","PATCH","DELETE"],"description":"Only for a resource served by several methods (prism/jobs). Inferred: a body selects POST."},"params":{"type":"object","additionalProperties":{"anyOf":[{"type":["string","number","boolean"]},{"type":"array","items":{"$ref":"#/properties/params/additionalProperties/anyOf/0"}}]},"description":"Query params, e.g. { handle: 'x', limit: 10 }. Arrays join with commas (label). Sent as strings."},"body":{"type":"object","additionalProperties":{},"description":"JSON body for POST batch endpoints, e.g. { ids: [...] }."},"idempotencyKey":{"type":"string","minLength":16,"description":"Makes a retry safe: a replay returns the original response for 0 credits (24h)."},"fields":{"type":"string","description":"Row paths as socialcrawl_endpoint lists them, e.g. 'post.id,post.engagement.*' (or an array). Cuts tokens."},"max_items":{"type":"integer","minimum":1,"description":"Show at most this many rows; the full page stays behind the result link."},"format":{"type":"string","enum":["json","csv","summary"],"description":"json (default), csv (canonical columns) or summary."},"max_credits":{"type":"integer","minimum":1,"description":"Spend cap: refused free when the quoted hold exceeds it (collect: the walk's budget)."},"confirm":{"type":"boolean","description":"true only once the user approved spending above the threshold (default 100 credits)."}},"required":["platform","resource"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"fd19df2bf6f75f4c350c0b307fef8ad6a7151a6fae73c62aaf843bb4bbbd4b76","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-20T00:46:33.800Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"816c998c6a325492ba918f4d8c12bf0cfdea34d75ff1fc168548ed9d21b33d7a","protocol":"streamable-http","status":"indexed","toolCount":7,"observedAt":"2026-11-20T00:46:33.800Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.RidioDevelopment/socialcrawl":{"url":"https://mcp.socialcrawl.dev/mcp"}}},"Cursor":{"mcpServers":{"io.github.RidioDevelopment/socialcrawl":{"url":"https://mcp.socialcrawl.dev/mcp"}}},"VS Code":{"servers":{"io.github.RidioDevelopment/socialcrawl":{"type":"http","url":"https://mcp.socialcrawl.dev/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.socialcrawl.dev/mcp"},{"protocol":"mcp","package":"socialcrawl-mcp","registryType":"npm","version":"1.10.0"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.RidioDevelopment%2Fsocialcrawl","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.RidioDevelopment%2Fsocialcrawl","name":"io.github.RidioDevelopment/socialcrawl","description":"One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.socialcrawl.dev/mcp"},{"protocol":"mcp","package":"socialcrawl-mcp","registryType":"npm","version":"1.10.0"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/RidioDevelopment/socialcrawl-mcp","version":"1.10.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.RidioDevelopment/socialcrawl","status":"online","lastCheckedAt":"2026-11-20T04:17:47.504Z","lastSuccessfulCheck":"2026-11-20T04:17:47.504Z","latencyMs":125,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T04:17:47.504Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T04:17:47.504Z"},"security":null,"timestamps":{"createdAt":"2026-09-08T10:22:53.236Z","updatedAt":"2026-09-08T10:22:53.236Z","observedAt":"2026-11-20T04:17:47.504Z"},"compatibility":{"serverVersion":"1.10.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}