Socialscrape

dev.socialscrape由 socialscrape.dev 發布v0.1.2更新於 Nov 7, 2026

Social media data for agents: profiles, posts, comments, search, ads, transcripts.

概覽

AI 產生的概覽

本機 MCP 伺服器,讓助理透過 SocialScrape 取得社群媒體資料:跨平台的使用者檔案、貼文、留言、搜尋、廣告與逐字稿。

可以做什麼
  • 跨平台取得逐字稿、搜尋、使用者檔案、貼文與留言,平台以參數指定
  • 依平台呼叫工具,並選擇 user、profile.posts 等資源
  • 在不發出 API 呼叫的情況下查看任一端點的確切參數、允許值、價格與範例參數
  • 依 id 呼叫任一端點、一次批次最多 100 個請求、管理非同步工作與監控、查詢點數餘額
適用情境
當助理需要透過一個付費 API 從多個平台取得社群媒體內容或帳號資料,用於研究、監控或內容分析,而不想自行爬取各網站時適用。
執行需求
以本機 stdio 程序由 MCP 用戶端啟動,從 socialscrape-mcp 的 PyPI 套件安裝(例如透過 uvx)。需要 SocialScrape 帳號,並在 SOCIALSCRAPE_API_KEY 提供 API 金鑰;沒有金鑰仍可探索工具。選用設定可限定平台與工具集,並調整 API 位址、回應長度與逾時。
安裝前請注意
呼叫會消耗 SocialScrape 帳戶中的付費點數,批次呼叫一次最多可送出 100 個請求。API 金鑰是放在環境變數中的機密。結果會傳送到 SocialScrape 的 API。選用的自行架設 HTTP 模式須由你負責安全,包括允許來源與每請求金鑰。

安裝

在 SourceWeft 中

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

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

socialscrape-mcp

The SocialScrape MCP server: social media data (profiles, posts, comments, search, ads, transcripts) for Claude, Cursor and any other MCP client that starts a local server.

It is generated from SocialScrape's endpoint registry and grouped so an agent sees a usable number of tools instead of one per endpoint:

ToolsWhat
get_transcript, search, get_profile, get_post, get_commentsThe jobs agents do most, across platforms. The platform is an argument.
one per platform (github, facebook, twitter, ...)resource picks the data (user, profile.posts, ...); parameters follow.
describeExact parameters, allowed values, price, example arguments. Free, no API call.
call_endpoint, batch, get_job, monitors, get_creditsAny endpoint by id, up to 100 requests in one call, async jobs, webhooks, balance.

Only built endpoints appear as tools. A platform shows up in the next release after its endpoints are built.

Every result starts with ok | credits charged: 1 | credits remaining: 4999 (and the structured copy carries the numbers as fields). Failures are free and come back as isError with the API's error code, a retryable flag and what to do next.

Use it

The server runs on your own machine. Your MCP client (Claude Desktop, Claude Code, Cursor) starts it as a subprocess over stdio. SocialScrape does not run a hosted MCP server, so there is no MCP URL to connect to.

json
{ "mcpServers": { "socialscrape": {    "command": "uvx", "args": ["socialscrape-mcp"],    "env": { "SOCIALSCRAPE_API_KEY": "ss_live_..." } } } }

Get a key at https://socialscrape.dev/sign-up?utm_source=github&utm_medium=repo&utm_campaign=socialscrape-mcp. Tool discovery works without a key; a tool call without one explains how to add it.

Fewer tools. Some clients cap the number of tools (Cursor warns past 40). Narrow the list in the env block:

Setting
only some platformsSOCIALSCRAPE_PLATFORMS=github,threads
only the cross-platform and account toolsSOCIALSCRAPE_TOOLSETS=core
only the platform toolsSOCIALSCRAPE_TOOLSETS=platforms

With core alone an agent still reaches every endpoint through describe and call_endpoint.

Serve it over HTTP yourself. For a client that can only reach a URL, install the extra and run the server on a host you control: pip install 'socialscrape-mcp[http]', then socialscrape-mcp http --host 127.0.0.1 --port 8080. Each request carries its own key in the x-api-key header (or Authorization: Bearer ...), and ?platforms= and ?toolsets= narrow the tools. This is yours to run and secure; SocialScrape does not offer it as a service.

Settings (environment)

VariableDefault
SOCIALSCRAPE_API_KEYnonestdio only; the HTTP mode reads each request's key
SOCIALSCRAPE_API_URLhttps://api.socialscrape.dev
SOCIALSCRAPE_MCP_TRIM1ask for trim=true (no null fields, no extra) unless a call says otherwise; saves context
SOCIALSCRAPE_MCP_MAX_CHARS100000longest answer; longer lists are cut to whole items, transcripts come in windows (offset)
SOCIALSCRAPE_MCP_TIMEOUT70seconds to wait for the API
SOCIALSCRAPE_MCP_ALLOWED_ORIGINSanyHTTP mode only; comma list, set it to refuse browser calls from other origins
SOCIALSCRAPE_PLATFORMS, SOCIALSCRAPE_TOOLSETSallsee above

來源:README.md,提交 5c6fecd

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.2最新Nov 7, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分