Socialcrawl Mcp

---

安装

远程服务（托管 — 无需安装）

直接连接到托管的 Streamable HTTP 端点 — 无需安装或运行任何内容：

Claude Code（适用于命令行 以及 Web / 云端沙箱中的 Claude Code）

claude mcp add --scope user --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \
  --header "Authorization: Bearer sc_your_key_here"

任何读取 .mcp.json 的客户端

{
  "mcpServers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp",
      "headers": { "Authorization": "Bearer ${SOCIALCRAWL_API_KEY}" }
    }
  }
}

Cursor / Windsurf / VS Code — 选择 HTTP（"streamable-http"）服务器类型，并使用相同的 URL 和请求头。x-api-key: sc_your_key_here 可作为替代请求头使用。

发现工具（socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate）无需密钥即可使用，因此你可以在注册前先行探索。claude.ai 自定义连接器（设置 → 连接器）需要 OAuth。OAuth 2.1 资源服务器模式处于预览阶段，默认关闭（SOCIALCRAWL_OAUTH=1；参见 docs/REMOTE-STREAMABLE-HTTP.md）；在托管服务器上启用之前，请使用上述基于请求头的设置。

更倾向于在本地运行？下面所有 stdio 选项均与之前完全一致。

npm

npm install -g socialcrawl-mcp

可在 npm 上获取。大多数用户无需此项 — 下面的 MCP 客户端配置使用 npx，并会在首次运行时自动安装。

Claude Code（最快捷）

claude mcp add --scope user socialcrawl -e SOCIALCRAWL_API_KEY=sc_your_key_here -- npx -y socialcrawl-mcp

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

Cursor

添加到项目根目录下的 .cursor/mcp.json 或全局的 ~/.cursor/mcp.json：

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

VS Code（Claude Code）

添加到项目中的 .vscode/mcp.json 或你的用户设置中：

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

Windsurf

添加到你的 Windsurf MCP 配置中：

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

其他兼容 MCP 的客户端

任何支持 stdio 传输的 MCP 客户端都可以使用此服务。通用模式如下：

• Command： npx
• Args： ["-y", "socialcrawl-mcp"]
• Environment： SOCIALCRAWL_API_KEY 设置为你的 API 密钥

保存配置后，重启你的 AI 客户端。

概述

socialcrawl-mcp 是一个 MCP (Model Context Protocol) 服务，将 AI Agent 连接到 SocialCrawl API —— 一个覆盖社交、电商、招聘、金融、研究与网络数据的统一数据 API。不带任务调用 socialcrawl_find 会列出所有平台；socialcrawl_account 视图 freshness 会显示实时计数。

从 TikTok、Instagram、YouTube、Twitter/X、LinkedIn、Reddit、Threads、抖音、小红书、Telegram、Quora、Bluesky、Apple Music、GitHub、Hacker News、Product Hunt、Polymarket 等众多平台获取个人资料、帖子、评论、搜索结果、热门内容和分析数据。从 Amazon、Walmart、Target、Home Depot、eBay、Klarna、AliExpress、Etsy、Sephora、H&M、Kohl's、Wayfair、Gumtree 和 Google Shopping 拉取商品、优惠、价格历史、评价和卖家信息；从 Google Play 和 Apple App Store 获取应用、排行榜和评价；从 Tripadvisor 获取酒店、餐厅、景点、邮轮和旅行者评价，以及来自 Yelp 和 Google Business 的本地商户数据；来自 Trustpilot 的品牌声誉和来自 G2 的软件评价；来自 LinkedIn、Indeed、Bing 和 Xing 的职位列表与薪资区间；市场行情、价格历史、财务报表和期权链；美国国会交易披露；来自 Naver 的韩语搜索和 Data Lab 趋势序列；通过 Content Analysis 获取跨网络的品牌提及及情感分析；Google News 头条和 Google Trends 关注度曲线 —— 此外还有通过 Tavily 和 Perplexity 进行的网络研究、通过 Grok 实现的 AI 驱动 X 搜索、页面内 SEO 审计，以及一个 /search/everywhere 端点，可在一次调用中扇出至 14 个来源。

v2.0.0 新增：七个工具取代十一个（socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate、socialcrawl_request、socialcrawl_collect、socialcrawl_account、socialcrawl_manage）。有关 1.x → 2.0 的映射，请参阅可用工具；有关每个版本的详细信息，请参阅 CHANGELOG.md。

MCP 服务的作用：

• 用通俗语言为任务找到正确的端点（跨所有端点的排序搜索，并解析 URL 和 handle），并告知 Agent 每个端点返回什么数据
• 代表你在所有平台、方法和组合上获取实时数据
• 为每次调用预先定价 —— 阶梯、固定或计量区间 —— 以便 Agent 在花费前做好预算
• 在调用 API 之前在本地验证请求：必需参数、oneOf 分组、枚举值、整数范围、参数耦合和 CSV 限制。错误的调用会免费失败，而不是消耗额度
• 提供内置 API 文档，Agent 可按需查询，分页展示而非截断

安装

1. 获取 API 密钥

在 socialcrawl.dev 注册，并从仪表板获取你的 API 密钥。每个账户都从 100 个免费额度开始 —— 无需信用卡。

2. 将密钥添加到配置中

将上方安装配置中的 sc_your_key_here 替换为你的实际 API 密钥（以 sc_ 开头）。

提示

你也可以将 SOCIALCRAWL_API_KEY 设置为系统环境变量，而不是放在 MCP 配置中。即使没有密钥，发现和文档工具也能工作 —— 只有实际的 API 请求才需要密钥。

使用

用自然语言向你的 AI Agent 提问。MCP 服务会处理其余部分。

获取个人资料

Get the TikTok profile for @charlidamelio

Agent 会调用 socialcrawl_request，参数为 platform: "tiktok"、resource: "profile"、params: { handle: "charlidamelio" }，并返回结构化个人资料数据，包括粉丝数、简介、认证状态和互动指标。

跨平台搜索

Search YouTube for "machine learning tutorials"

获取帖子评论

Get the comments on this Instagram post: https://instagram.com/p/CwA1234abcd

跨平台研究

Compare the follower counts of @mkbhd on TikTok, Instagram, YouTube, and Twitter

Agent 会依次发起 4 次 API 调用 —— 每个平台一次 —— 并将结果汇总为对比。

跨零售商购物

Find the cheapest 65-inch OLED TV across Amazon, Walmart, Target, and eBay

探索可用端点

What social media platforms can you access?

Show me all the TikTok endpoints

Which endpoints can give me video transcripts?

每次都是一次 socialcrawl_find 调用：用自然语言描述任务，在所有端点中排序，无需指定平台。

从 API 中学习 API

How do I get started with SocialCrawl?

Show me exactly how to call the Prism comments endpoint

Is this MCP server's endpoint list up to date?

这些会调用 socialcrawl_endpoint 和 socialcrawl_account，不产生任何费用。

运行前先查看费用

What would it cost to run a Prism brand-mentions report?

Show me everything I can call for 1 credit

Why did that last call charge me 7 credits instead of 2?

前两个调用 socialcrawl_estimate；第三个通过 socialcrawl_account 以 view: "transactions" 读取额度账本，并显示该 request_id 的扣款和退款记录。

访问文档

How does the SocialCrawl credit system work?

How do I page through a list endpoint?

响应示例

每个响应都遵循统一信封格式：

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile",
  "data": {
    "content": { "text": "...", "media_urls": ["..."] },
    "author": { "username": "charlidamelio", "followers": 156000000 },
    "engagement": { "likes": 5200, "engagement_rate": 0.045 },
    "metadata": { "language": "en", "content_category": "entertainment" }
  },
  "credits_used": 1,
  "credits_remaining": 99
}

说明

所有平台返回的响应结构都相同 — 无需针对每个平台编写解析逻辑。

可用工具

2.0.0 版本提供 7 个工具（tools/list 约 4.7k tokens，相比 1.x 的 11 个工具约 12.8k 有所下降）：

工具	功能	需要 API key？
socialcrawl_find	从这里开始。 用自然语言描述任务，即可获得最合适的端点（默认 3 个），每个端点附带任务已提供的参数（URL 和 @handles 会被解析）、仍缺失的参数、积分消耗以及应发起的精确调用。platform 可缩小范围。不提供任务时，会列出平台，或某个平台的端点。部署时由实时的 /v1/utility/find 排序，否则由内置排序器排序（基于 id、summary、returns、use_when 和 tags 的 BM25，并带平台加权）	否
socialcrawl_endpoint	单个端点的契约（id: "tiktok/post/comments"）：用途、必需和可选参数、数据行位置（rows_at）以及最多 25 个响应字段、成本和计费规则、分页、实测延迟和超时、后续端点，以及示例响应链接。传入平台 slug 会返回其端点表；传入主题（errors、pricing、pagination、judgments、hydration、overview……）会返回对应指南。设置 key 后通过 /v1/utility/endpoint 实时获取	否
socialcrawl_estimate	在消耗前精确计算成本：一次调用（id + 你将发送的 params，calls 用于任务总计，items 用于遍历），或一组调用的 plan。部署时使用 /v1/utility/estimate，否则使用内置定价。传入平台 slug 会返回其价格表；不传 id 会返回定价概览	否
socialcrawl_request	调用一个端点：platform、resource、params（POST 批量端点使用 body）。先在本地校验、报价，超过 max_credits 时拒绝，超过 SOCIALCRAWL_CONFIRM_ABOVE 时确认，并返回 structuredContent（数据行、积分、分页）。fields / max_items / format 用于塑造结果；较大的分页会在行边界处截断，并通过 socialcrawl://results/<request_id> 链接提供。未知的平台或资源会返回 did-you-mean	是
socialcrawl_collect	在一次调用中遍历分页端点，直到达到 items 个唯一数据行、最后一页或 max_credits，并提供指向每一行的资源链接，格式为 JSONL、JSON 或 CSV	是
socialcrawl_account	免费检查：balance（含本次会话的支出）、transactions（明细账本，或某个 request_id 的收据）、status（平台健康状态）和 freshness（本服务的目录是否落后于 API）	是（status 除外）
socialcrawl_manage	按 area + action 执行有状态工作：monitors（定时配方）、cohorts（在你自己的面板上进行提及搜索）、web（抓取、搜索、映射、提取、爬取/批量/Agent 任务、变更监控、浏览器会话）和 jobs（Prism 后台任务：提交、列出、获取）。action 的字段放在 input 中，资源 id 放在 id 中；错误的字段会依据规则免费拒绝	是

从 1.x 升级。 设置 SOCIALCRAWL_LEGACY_TOOLS=1 可将九个已弃用的 1.x 名称也注册为此大版本的轻量封装。映射关系：

1.x 工具	2.0 工具
socialcrawl_list_platforms	socialcrawl_find，不带参数
socialcrawl_list_endpoints	socialcrawl_find（task 或 platform）；单个契约用 socialcrawl_endpoint
socialcrawl_pricing	socialcrawl_estimate
socialcrawl_discover	socialcrawl_endpoint（端点指南）、socialcrawl_find（目录、计划）、socialcrawl_account（freshness、status）
socialcrawl_get_docs	socialcrawl_endpoint，主题作为 id
socialcrawl_check_balance	socialcrawl_account（requestId 现在为 request_id）
socialcrawl_monitors / socialcrawl_web / socialcrawl_cohorts	socialcrawl_manage，使用 area: "monitors" / "web" / "cohorts"
socialcrawl_request、socialcrawl_collect	不变（platform 现在是普通字符串，并带 did-you-mean）

发现、实时与内置

socialcrawl_find、socialcrawl_endpoint 和 socialcrawl_estimate 从服务内置的数据中作答（由后端注册表生成，dump schema v4），无需密钥。带上密钥后，它们会先请求 API 免费的 /v1/utility/* 路由（find、resolve、endpoint、estimate），这些路由从实时注册表作答，当某个路由未部署时则回退到内置答案。以上每一项都是 0 积分。

为什么新鲜度很重要。 本服务随构建时生成的目录一同发布；而 API 一直在变化。数据调用始终命中实时 API 并持续可用，但发现、定价和本地验证则从该快照作答。服务每个进程会自行检查一次，一旦落后，就会在下一个工具结果中加一行说明。一次免费调用就能告诉你处于哪种情况：

socialcrawl_account  view: "freshness"

这些端点同样是普通 HTTP，因此第三方集成或非 MCP 的 Agent 框架用 curl 就能获得完全相同的信息。

定价——花钱之前先了解成本

socialcrawl_estimate 之所以存在，是因为对大部分表面而言，单一数字就是谎言。SocialCrawl 有三种计费方式：

• 阶梯 —— 按请求的档位费率：standard 1cr、advanced 5cr、premium 10cr。
• 固定（其中一些免费）—— 按端点覆盖，例如 /v1/search/everywhere 固定 20cr。
• 计量 —— 费用取决于请求。会先扣除一个预估上限，再按实际完成的工作退款。

报价一个计量端点的基础成本会低估每一次调用：/v1/search/news 基础为 1cr，但实际收费 2–62cr —— 每个返回文章的 Google 国家线路收 1 积分，再加上启用 bing 引擎时的按文章计费。该工具会返回真实区间、注册表自身的计费规则、影响账单的参数，以及需要预留的最坏情况：

action: "overview"   → ladder, every free endpoint, every flat override, every metered band + rule, cache TTLs, full refund matrix
action: "endpoint"   → one endpoint's price, rule, price-driving params, paging cost, worst case
action: "platform"   → a whole platform's cost table
action: "list"       → rank/filter by cost — "everything I can call for 1 credit", "the 10 most expensive endpoints"
action: "hydration"  → every include= row join: what it fills, per-row rate, row cap, fully-joined ceiling
action: "judgments"  → every judged list: free default labels/relevance, metered presets, the hold per opt-in

把你打算发送的 include 传给 action: "endpoint"，区间就变成算术题 —— 按照后端计价器所用的同一公式，给出精确的预留额度，并按每个 join 逐项列出：

action: "endpoint", platform: "linkedin", resource: "search/people", include: "profile", rows: 3
→ holds 22 credits (10cr page + 12cr for 3 rows of `profile`), settling anywhere down to 10

或者传入你实际要发送的 params（以及整个作业的 calls）。Joins、计量判断和 max_pages 都会逐项列出，并且 max_pages 会乘到页数上，因为走过的每一页都按一次调用计费：

action: "endpoint", platform: "youtube", resource: "search", calls: 10,
params: { query: "espresso", include: "engagement,channel", label: "mention", brand: "Acme", max_pages: "3" }
→ 1cr page + 5cr engagement + 5cr channel + 4cr label=mention = up to 15cr per page
  × 3 pages = up to 45cr per call; 10 calls = up to 450 credits held, settling to what was filled and judged

它还会说明那些使实际收费偏离标价的规则。缓存命中、幂等重放、空结果、上游失败和 dry_run=1 预览均为 0 积分；seen=<id> 会按你已收到的行所占比例对每一页打折；since / stop_at_id 会在你已持有的行处结束遍历。

判断——标签与相关性，默认免费

约 50 个列表端点会免费为你判断其行，不额外消耗积分。帖子带有 sponsored、intent 和 niche；评论带有 sentiment、question、purchase_intent 和 complaint；评价带有 sentiment 和 issue。所有这些都归入 computed.labels，而经过判断的搜索会在 computed.relevance 下为每一行打出与你查询的相关性分数。只有以下这些会增加积分：

• 计量预设：帖子上的 mention（配合 brand=）、quality、injection；评论上的 spam、toxic、low_quality；评价上的 reports、incentivized，
• 带 offer=（你销售的东西）的 label=intent，
• 带你自己主题（放在 relevant_to= 中）的 relevance=score|filter。

每一项按该页每满 25 行收 1 积分（100 行的页面为 4cr），并按新判断的行数结算。已判断过的行和缓存的页面免费。judgments=off 会关闭默认判断，dry_run=1 以 0 积分预览成本。带上 id: "judgments" 的 socialcrawl_endpoint 就是完整约定。

行填充 — 一次调用，取代每行一次页面请求加一次查询

有些列表内容单薄，是因为上游除了这些内容外不再发布其他信息：Pinterest 搜索结果没有收藏数，LinkedIn 互动者行没有粉丝数，YouTube 播放列表没有观看次数或时长。另一个 SocialCrawl 端点能针对每一行分别给出这些信息 — 因此这些端点接受一个 include= 令牌，在同一次调用中将每一行与其对应的兄弟资源连接起来。

GET /v1/pinterest/search?query=kitchen&include=engagement      → saves, likes, comments, shares on every row
GET /v1/youtube/playlist?playlistId=PL...&include=engagement,channel
GET /v1/linkedin/search/people?keywords=cto&include=profile&limit=3

• 可选启用。 没有令牌，就没有连接，没有额外费用，也没有额外延迟 — 从不请求它的调用方所支付的费用与以往完全相同。
• 按实际填充的行计费。 费用上限会预先冻结；只有当一次新的兄弟查询实际填充了某一行时，才会扣留相应费用。由兄弟资源缓存提供的行免费，无法填充的行会退款，而完全完成连接的页面会整体缓存，因此立即重复调用为 0 费用。
• 行数上限决定费用上限。 在 LinkedIn 上使用 limit=3&include=profile 会冻结 22 费用，而不是 50。
• 它会告诉你它做了什么。 data.hydration 报告行数、查询次数、缓存命中数、冻结与扣留的费用，以及毫秒数；当只有部分行被填充时，_warnings 会带有 <token>_partial。

使用 id: "hydration" 调用 socialcrawl_endpoint 会列出每一种连接、其价格以及完整约定；socialcrawl_estimate 会为带有其 include 的一次调用报价。

监控 — 为任何配方安排计划

使用 area: "monitors" 调用 socialcrawl_manage 可将任何注册表端点或 Prism 组合封装为一个按计划运行、带状态的监控器（/v1/monitors/*）。它会按小时/每天/每周（或按 cron）重新运行该配方，将每次结果投递到经过 HMAC 签名的 webhook，在指标阈值或变化时触发告警，并保留每次运行的时间序列供你读取。“Prism 回答一次；监控器替你持续关注。” 管理监控器花费 0 费用；每次计划运行会按该配方的正常费用计费，外加 1 费用的调度附加费。完整约定见使用 id: "monitors" 的 socialcrawl_endpoint。

Web — 抓取、爬取、浏览

使用 area: "web" 调用 socialcrawl_manage，可通过单个 action 参数驱动完整的网页抓取与浏览器自动化能力面（web 平台，/v1/web/*）：

• 同步读取 — scrape（URL → markdown/HTML/截图/链接）、search（带页面内容的网页搜索）、map（发现站点的 URL）、extract（从页面提取大模型结构化数据）。
• 异步任务 — crawl 整个站点、batch_scrape 多个 URL，或 agent（自主多步网页任务）；每个都会返回一个任务，你可以用 job_get/job_list 轮询，用 job_errors 检查（逐页失败信息），并用 job_cancel 停止。crawl_preview 可在你付费之前免费试运行一次爬取的参数。
• 监控 — monitor_create/list/get/update/delete/checks 会按一定节奏重新检查某个 URL，并将变更投递到 webhook。
• 会话 — session_create/get/list、session_execute（在实时页面中运行代码）、session_close。

大多数付费 web 能力面采用按量计费而非固定费用：一次爬取会冻结 limit 费用，并退还每一页未爬取的部分；一个会话会按 ttl_seconds 冻结费用，并在关闭时结算。任务、监控器和会话管理为 0 费用。参见使用 id: "web" 的 socialcrawl_endpoint，或使用 id: "web" 的 socialcrawl_estimate。

智能校验

在进行任何 API 调用之前，socialcrawl_request 会依据内置注册表数据，复现后端自身的预计费校验器：平台和资源存在，必需参数和 oneOf 分组得到满足，枚举值合法，整数位于其声明范围内，参数耦合关系成立（order 需要 sort；Reddit 的 timeframe 需要 sort=top），并且 CSV 列表在其条目限制之内。格式错误的调用会立即失败且免费，而不是耗费一次往返 — 并且 Agent 会被告知究竟需要修复什么，而不是在一个永远不可能成功的调用上反复循环。

可安全重试的请求

向 socialcrawl_request 传入 idempotencyKey（推荐 UUIDv4），即可让调用可安全重试。如果请求在 24 小时内被重放，服务会返回原始响应，并扣除 0 积分（X-Idempotent-Replay: true）。

支持的平台

平台	可用数据
LinkedIn	个人资料（单一子资源或一次调用打包：all、complete、with-posts）与公司主页（包括按域名查找、also-viewed、员工人数）、帖子与带评论的帖子、转发、互动反应、评论与回复、带评论和互动反应的 Pulse 文章、人物搜索（关键词或搜索 URL）、公司与话题标签搜索、相似会员、个人资料子资源（工作经历、教育背景、技能、职位技能、认证、关注的学校/简报/Top Voices、最近活动……）、职位（搜索、公司职位、会员发布的职位、招聘团队、详情）、公司洞察、群组、完整的帖子历史归档（按帖子计量）、转录文本、广告库、profile-360
Prism	跨平台复合能力 — URL 查找、评论采集、批量帖子统计/个人资料/评论查找、最多 5,000 项的异步后台任务、账号审核、名称→账号解析（find-accounts）、账号/链接提及、负面帖子筛查、营销活动简报检查、钩子/格式提升效果、术语早期度、无关键词的国家趋势看板、评论者语言构成、评论来源的买家线索、品牌提及、需求信号、AI 可见度、危机雷达/事后分析、声誉、声量份额、创作者审查与创作者卡片、组织雷达、Korea gap、AI 共识答案、视频/应用/产品情报
Instagram	个人资料、账号透明度（profile/about）、帖子、Reels、评论与评论回复、精选、快拍、被标记与位置信息流、粉丝/关注、相似账号、帖子点赞者、转发统计、带分享数的一次调用 Reels/帖子信息流、互动分析、通用 + 热门帖子搜索、Reels/话题标签/个人资料/位置/音乐搜索（通过 include=creator 进行带创作者卡片的 Reel 搜索）、屏幕文字（OCR）、趋势、转录文本、profile-360
TikTok	个人资料、视频、评论与回复、屏幕文字提取、关键词/话题标签/用户/音乐搜索 + 建议、话题标签详情、趋势（全球或国内 For You）、TikTok 自带的热门话题标签和 Top Videos 看板、受众、相似账号、粉丝、点赞视频、播放列表与收藏、地点信息流、特效、直播、歌曲、转录文本、广告库、profile-360
Facebook	主页、群组与群组帖子、帖子、评论与回复、照片、Reels（包括带观看数的完整 Reels 信息流）、活动与活动搜索、Marketplace、跨帖子/主页/人物/视频/群组的关键词搜索、转录文本、完整广告库
YouTube	频道、视频、Shorts、评论与回复、赞助商、播放列表与条目、社区帖子、搜索（高级 + 自动补全）、趋势、直播、频道联系邮箱查找、媒体文件（音频/视频/字幕/缩略图）、转录文本、批量视频/频道/转录文本、profile-360
Web Scraping	抓取、网页搜索、站点地图、LLM 提取、带逐页错误源的异步爬取/批量抓取/Agent 任务、变更监控、交互式浏览器会话、文档解析 — 由 socialcrawl_manage（区域 web）驱动
US Congress Trades	美国国会 STOCK Act 披露 — 交易信息流（all/48h/7d）、议员、按政治人物和按股票代码的统计与交易、州代表团，以及完整的统计套件（党派、行业、发行人、成交量、异常活动、买卖比、迟交申报）
Klarna	产品详情与所有商家报价、关键词搜索 + 建议、用户和专业评论及评分概览、价格历史、产品对比、带筛选/关键词/购买指南的品类浏览、商店列表
Tripadvisor	酒店、餐厅、景点和游轮 — 每类的搜索与完整详情、带业主回复的旅行者评论、按 URL 查找地点、目的地自动补全、体验类型
Twitter/X	个人资料、推文与回复、推文与用户搜索、用户媒体、粉丝、关注、转发者、社区、视频转录文本、通过 Grok 的 AI 搜索、profile-360
Naver	韩国第一门户 — 博客、新闻、百科、cafe、KiN、本地、图片、网页搜索、勘误与成人内容分类器、Data Lab 搜索趋势与购物洞察系列、简报
Reddit	子版块、帖子详情、评论、带帖子和评论历史的用户个人资料、关键词/评论/媒体搜索、子版块发现、转录文本、omni-search VoC 扫描
GitHub	用户、仓库、issue、PR、README、发布、搜索、仓库档案、用户资料活跃度
Gumtree	英国分类广告 — 房源搜索与详情、相似房源、卖家资料及其广告、搜索建议、热门搜索、带筛选的类目树、位置查找
Jobs	跨 LinkedIn、Indeed、Bing 和 Xing 的职位搜索与职位详情、LinkedIn 组织 ID 解析，以及按职位名称和国家的薪资范围
Sephora	产品详情、评论、关键词搜索 + 建议、类目树浏览、品牌列表与按品牌产品、商店查找、按 SKU 的门店库存
Content Analysis	跨网络品牌提及、情感、评分分布、短语/品类趋势
Google	网页搜索、Ads Transparency、Business Profile（信息、评论、更新、问答）、Travel 酒店
AliExpress	产品详情、关键词搜索、相似产品、评论、按 SKU 的运费、热门产品、精选促销、类目树
Apple App Store	应用搜索、搜索建议、应用详情、评论、排行榜、列表数据库、参考数据
Google Play	应用搜索、搜索建议、应用详情、评论、排行榜、列表数据库、参考数据
Amazon	产品搜索、ASIN 详情、评论、卖家、店铺页面、Best Sellers 排行榜、当前优惠、卖家资料 — 约 13 个市场
Douyin	中国的 TikTok — 视频搜索、创作者资料与信息流、视频详情、评论与评论回复、创作者搜索、热搜榜（大多按行计量）
Finance	金融工具报价、股票代码搜索、市场概览、金融工具新闻、每日价格历史、公司财务报表、期权链
G2	软件市场 — 产品页面、评论、品类列表与品类索引、供应商资料及其目录、产品 URL 索引
Quora	问题搜索与详情、答案搜索、Space 帖子搜索、个人资料搜索、Space/话题搜索
H&M	关键词搜索 + 建议、按国家的商店列表、国家/语言、类目树、按产品的供应商和工厂披露
Pinterest	Pin、画板、用户画板、搜索、按国家的 Pinterest Trends、URL 保存数
Spotify	艺人、曲目、专辑、播客、单集、搜索
Threads	个人资料、帖子、帖子评论、关键词搜索、用户搜索
Utility	免费 API 自发现 — 快速入门、端点目录、按端点的使用指南、跨领域能力索引、白话调用规划器、LLM 上下文载荷。0 积分，由实时注册表提供。位于 socialcrawl_find、socialcrawl_endpoint、socialcrawl_estimate 和 socialcrawl_account 之后
Xiaohongshu	RED / 小红书 — 笔记搜索、热搜榜、创作者资料及其笔记、笔记详情、一级评论（每个返回行 5cr）
Apple Music	目录搜索、艺人、专辑、曲目、按国家的排行榜（歌曲、专辑、音乐视频、播放列表）
Google Shopping	产品搜索、产品详情、价格历史、跨零售商评论、按卖家的报价
Kohl's	关键词搜索、评论、产品问答、商店查找、类目树
Rumble	搜索、频道视频、视频详情、评论、转录文本
Target	按 TCIN 的产品详情、评论、品类浏览、完整分类体系、商店查找
TikTok Shop	产品、评论、列表、搜索、创作者橱窗
Universal Search	一次查询向多个平台分发（固定 20cr）；multi — 一次调用中每个指定平台各自的原生搜索，价格为各自页面价格之和；论坛通道；多国新闻通道（计量）；跨 TikTok/Threads/Instagram 的创作者发现通道
Walmart	产品详情、评论、关键词搜索、品类浏览、卖家报价
Yelp	按 encid 的商家资料、商家评论、商家搜索（紧凑和完整卡片）、搜索建议
Bluesky	个人资料、用户帖子、帖子详情、关键词帖子搜索
Etsy	按 id 或 URL 的列表、店铺目录、相似列表、搜索建议
Hacker News	故事搜索、故事、评论树、个人资料
Home Depot	关键词搜索、按商品 id 或 URL 的产品详情（感知门店/邮编的定价）、评论、按 ZIP 的商店查找
Tavily	网页搜索（带 LLM 答案）、URL 提取、站点地图、完整爬取
Twitch	个人资料、剪辑、视频、日程
Google Trends	随时间变化的兴趣（explore）、上升/爆发相关查询，以及按位置的 Trending Now
Kwai	个人资料、帖子
Telegram	公开频道资料、频道帖子信息流、单条帖子查找
Truth Social	个人资料、帖子
Wayfair	产品搜索、按 SKU 的产品详情、评论
eBay	列表搜索，包括带实际成交价的已售/已结束列表、列表详情
Snapchat	个人资料、Spotlight 评论
Trustpilot	商家搜索、公司评论
Google News	实时 Google News SERP 搜索
Kick	剪辑
Komi	链接页面
LinkBio	链接页面
LinkMe	链接页面
Linktree	链接页面
On-Page	单 URL 页内 SEO 审计 — 一次调用完成技术、内容和元数据检查
Perplexity	带引用来源的 Sonar 网络研究
Pillar	链接页面
Polymarket	预测市场研究 — 多查询分发 + 排名
Product Hunt	当前 Product Hunt 发布（每页约 50 个），可按主题筛选
socialcrawl_find 不带 task 时会列出每个平台及其实时端点数量。

错误处理

MCP 服务会优雅地处理错误，并给 Agent 提供可操作的指引。每个 API 错误都会透传服务自身的 error.message，随后在 API 指定了原因时附上 reason: …，并在单独一行附上 request_id: req-…（从响应体中读取，若响应体不是 JSON 则从 X-Request-Id 请求头读取）。报告问题时请引用 request_id：它是在日志和额度账本中定位某次调用的依据。

错误	Agent 看到的内容
缺少 API key	提示设置 SOCIALCRAWL_API_KEY，并附注册链接
API key 无效	要求检查 key 配置
额度不足	显示余额并链接到账单页面
平台/资源错误	建议使用发现类工具找到正确的端点
缺少参数	列出具体缺少哪些参数并附示例 — 在本地拦截，不计费
参数值无效	指出非法的枚举值、超出范围的整数、错误的关联关系或过长的 CSV — 在本地拦截，不计费
资源未找到（404）	服务给出的条目缺失原因（例如 reason: video_gone）以及是否已扣费（BIL-01）
Idempotency-Key 冲突（409）	告知 Agent 该 key 已被另一个账号使用 — 请生成新的 key
Idempotency-Key 载荷不匹配（422）	告知 Agent 同一个 key 被复用于不同的参数
方法不允许（405）	报告该路由使用了错误的 HTTP 方法
载荷过大（413）	请求体超过 JSON 大小上限；在解析前即被拒绝
触发速率限制（429）	超出每个 key 每分钟 600 次请求的窗口 — 不计费；请退避后重试
并发限制（429）	要求调用方退避（每个 key 最多 50 个并发）
key 预算超限（402）	该 key 自身的支出上限已用尽，而账号仍有额度 — 请提高上限，不要充值
上游错误（502）	服务给出的说明：哪个平台失败、退款情况以及何时重试
平台不可用（503）	服务给出的原因（熔断器打开或上游限流）和重试提示；额度已退还

链接

• 获取你的 API Key — 100 免费额度，无需信用卡
• API 文档 — 完整的端点参考、额度与错误码
• SocialCrawl 网站
• npm 包
• MCP Registry
• 入门指南
• 工作原理