SocialCrawl

io.github.RidioDevelopment由 GitHub 帳號 RidioDevelopment 發布v1.10.0更新於 Oct 24, 2026

One API for 65 platforms and 572 endpoints: social, commerce, retail, jobs, finance, web scraping.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取溝通與協作資料與分析

概覽

AI 產生的概覽

SocialCrawl 讓助理透過單一統一 API 探索並呼叫社群媒體、電商與網頁擷取端點,並在花費額度前先估算費用。

可以做什麼
  • 探索端點:把自然語言任務轉成符合的端點,附上參數、缺少項目與額度成本,或列出平台及其端點
  • 檢視與計價:讀取端點的參數、回傳欄位、分頁與計費規則,並估算單次呼叫或多次呼叫方案的確切額度
  • 取得資料:呼叫單一端點取得個人檔案、貼文、留言、搜尋結果、熱門內容與分析資料,呼叫前先在本機驗證
  • 分頁蒐集:依目標不重複列數或額度上限走訪分頁端點,並以結果 ID 讀取已儲存的結果
  • 查看帳戶:查看額度餘額、交易明細、平台健康狀態與目錄新舊程度
  • 管理具狀態工作:含 webhook 與警示的監控、帳號群組、網頁擷取/搜尋/爬取工作與背景工作
適用情境
適合需要用一組憑證從多個平台取得社群媒體或網頁資料的情境,例如查詢個人檔案、取得貼文與留言、關鍵字搜尋或趨勢監控。免費的探索與估算工具可先確認可行性與成本,再決定是否花費額度。
執行需求
可作為遠端端點使用,也可作為本機 npm 套件 socialcrawl-mcp 透過 stdio 執行,通常以 npx 啟動。付費呼叫需要 SocialCrawl 帳號與 API 金鑰,透過 SOCIALCRAWL_API_KEY 環境變數或 Authorization bearer 標頭提供;探索類工具不需金鑰。需要能連線至 SocialCrawl API 的網路。
安裝前請注意
socialcrawl_request 與 socialcrawl_collect 會消耗付費帳戶的額度,應設定額度上限與確認門檻。API 金鑰是可計費的機密,請勿放入共用設定。管理類工具會建立與變更監控、webhook、背景工作等具狀態資源。查詢內容與目標網址會傳送給第三方服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SocialCrawl,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.RidioDevelopment%2Fsocialcrawl/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp"
    }
  }
}

README

socialcrawl-mcp

[npm version] [License: MIT]

MCP server for SocialCrawl — access 21+ social media platforms through one unified API.

What it does

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.

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "socialcrawl": {      "command": "npx",      "args": ["-y", "socialcrawl-mcp"],      "env": {        "SOCIALCRAWL_API_KEY": "your_api_key_here"      }    }  }}

Cursor

Add to .cursor/mcp.json in your project root or ~/.cursor/mcp.json globally:

json
{  "mcpServers": {    "socialcrawl": {      "command": "npx",      "args": ["-y", "socialcrawl-mcp"],      "env": {        "SOCIALCRAWL_API_KEY": "your_api_key_here"      }    }  }}

VS Code (Claude Code)

Add to .vscode/mcp.json in your project or your user settings:

json
{  "servers": {    "socialcrawl": {      "type": "stdio",      "command": "npx",      "args": ["-y", "socialcrawl-mcp"],      "env": {        "SOCIALCRAWL_API_KEY": "your_api_key_here"      }    }  }}

Get Your API Key

  1. Sign up at socialcrawl.com — no credit card required
  2. Receive 100 free credits instantly upon registration
  3. Copy your API key from the dashboard and paste it into your config

Available Tools

ToolDescription
socialcrawl_list_platformsDiscover all 21 supported platforms with their slugs and endpoint counts
socialcrawl_list_endpointsSee all endpoints, required parameters, and credit costs for a specific platform
socialcrawl_requestMake any SocialCrawl API call — fetch profiles, posts, comments, search results, and more
socialcrawl_get_docsAccess detailed API documentation for a platform or specific endpoint

Example

User prompt: "Get the TikTok profile for charlidamelio"

Agent flow:

  1. Calls socialcrawl_list_endpoints with platform: "tiktok" to discover available endpoints
  2. Finds user/info endpoint — takes a username parameter, costs 1 credit
  3. Calls socialcrawl_request with platform: "tiktok", endpoint: "user/info", params: { username: "charlidamelio" }
  4. Returns profile data: follower count, bio, video count, verification status, and more

Supported Platforms

PlatformEndpoints
TikTok24
Instagram12
YouTube11
Facebook12
X (Twitter)6
LinkedIn6
Reddit7
Threads5
Pinterest4
Google4
Truth Social3
Twitch2
Snapchat1
Kick1
Amazon1
Linktree1
Linkbio1
Linkme1
Komi1
Pillar1
Utility1

Total: 105 endpoints across 21 platforms

Credit System

TierCostShare of Endpoints
Standard1 credit~90%
Advanced5 credits~8%
Premium10 credits~2%

New accounts receive 100 free credits — enough to make 100 standard requests or explore multiple platforms before committing to a paid plan.

License

MIT — see LICENSE for details.

來源:README.md,提交 0a6edbb

工具

7

socialcrawl_find

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.

輸入參數tasklimitplatform

socialcrawl_endpoint

Endpoint 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.

輸入參數id必填pagemethod

socialcrawl_estimate

Estimate 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.

輸入參數idbodyplancallsitemsmethodparams

socialcrawl_request

Call 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.

輸入參數bodyfieldsformatmethodparamsconfirmplatform必填resource必填max_itemsmax_creditsidempotencyKey

socialcrawl_collect

Collect 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_credits

socialcrawl_account

Account 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_id

socialcrawl_manage

Manage 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).

輸入參數idarea必填inputaction必填dry_runidempotencyKey

版本歷史

1
  1. v1.10.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分