mcpField
M
mcp-tiktok-brand-presence-mapper

mcp-tiktok-brand-presence-mapper

本地服务
github.com/mambalabsdev社交媒体01 周前更新

关于 mcp-tiktok-brand-presence-mapper

该 MCP 服务使用 Apify Actor,将 TikTok 账号或企业域名解析为品牌官方账号,并返回账号资料及互动数量。适合核验品牌的 TikTok 存在情况;身份校验未通过时会标记不匹配,而不返回计数。

主要功能

  1. 01通过账号或企业域名查找品牌账号
  2. 02返回粉丝、关注、点赞和视频数
  3. 03提供认证状态、简介及简介链接
  4. 04身份校验失败时标记不匹配
  5. 05支持结果缓存及限制调用支出

适用场景

  1. 01核实企业是否有官方 TikTok 账号
  2. 02查看品牌账号的粉丝和内容数量
  3. 03检查候选账号是否与企业身份相符

MCP 相关

向 MCP 客户端提供 `map_tiktok_brand_presence` 工具,用于解析并检查品牌 TikTok 账号。服务调用 Apify Actor,需配置 APIFY_TOKEN。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"com-mambabuilt-mcp-tiktok-brand-presence-mapper": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-tiktok-brand-presence-mapper"
],
"env": {
"APIFY_TOKEN": "<APIFY_TOKEN>"
}
}
}
}
启动命令npx -y @mambalabsdev/mcp-tiktok-brand-presence-mapper
需要配置的环境变量
APIFY_TOKEN密钥Apify API token from https://console.apify.com/account/integrations

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@mambalabsdev/mcp-tiktok-brand-presence-mapper1.2.0

工具

1

收录的工具列表 · 更新于 2 周前

参数类型必填说明
handlestring否TikTok 账号名,可带或不带前导 @,例如 shopify。这是主要输入:14 个 B2B 首页中只有 4 个声明了 TikTok 链接,因此直接提供账号名比让 actor 查找更便宜,也可靠得多。
skipCacheboolean否当值为 "false"(默认值)时,成功的查询会缓存七天并重复使用。设为 "true" 可强制重新获取。以字符串形式发送,以兼容 Clay。
company_namestring否可选。可提高搜索准确性,也是身份验证用于核对发现账号的名称。
company_domainstring否纯公司域名,例如 shopify.com。没有账号名时用于查找账号,也用于验证通过发现机制猜出的账号。两者都提供时效果最佳。
escalateOnBlockboolean否TikTok 的大多数请求会通过低成本的数据中心路由获得响应,少数请求会被带有机器人检测的页面拦截。设为 "true"(默认值)时,被拦截的 fetch 会通过住宅网络重试一次,通常可以恢复,但每条恢复的记录成本更高。设为 "false" 时会接受拦截并返回状态 blocked。以字符串形式传入,以兼容 Clay。
includeFollowerCountsboolean否当值为 "true"(默认值)时,会获取个人资料页面并提取计数。设为 "false" 后仅解析个人资料 URL,成本更低且无需代理。以字符串形式发送,以兼容 Clay。

详细介绍

TikTok 品牌形象映射器 MCP 服务

Smithery Glama score MCP Registry npm version npm downloads license

TikTok 品牌形象映射器 MCP 服务

这是一个 MCP 服务,用于调用 Apify 上 Mamba Labs 的 TikTok Brand Presence Mapper Actor。

将 TikTok 用户名或公司域名解析为对应的品牌账号,并提供粉丝数、获赞数和视频数。

功能介绍

将 TikTok 用户名或公司域名解析为该品牌的官方 TikTok 账号。返回粉丝数、关注数、获赞数和视频数、认证状态、显示名称、简介以及账号简介中的外链,并整理为一行可直接用于 Clay 的数据。TikTok 会对大约一万以上的数量进行取整,结果行会对此进行标记。如果猜测的账号未通过身份验证,则会报告 identity_mismatch 且不返回任何数量,而不会将其作为公司账号返回。此服务为只读;需要设置 APIFY_TOKEN,且每次调用都会消耗 Apify 额度。

快速开始

将以下内容添加到 MCP 客户端配置中:

{
  "mcpServers": {
    "mamba-tiktok-brand-presence-mapper": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-tiktok-brand-presence-mapper"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

前提条件

该 Actor 按事件收费,每次调用都会消耗 Apify 额度。价格详见 Actor 页面。

示例提示词

  • “Gymshark 有多少 TikTok 粉丝?”
  • “查找 allbirds.com 对应的 TikTok 账号,并告诉我该账号是否已认证。”
  • “检查 patagonia.com 是否有 TikTok 账号。”

工具和输入

工具:map_tiktok_brand_presence

输入类型含义
handle字符串TikTok 账号名,可带或不带前导 @,例如 shopify。这是主要输入:14 个 B2B 首页中只有 4 个声明了 TikTok 链接,因此
company_domain字符串公司域名,不带其他内容,例如 shopify.com。没有账号名时,用于查找账号名;也用于核验通过发现流程猜出的账号名。
company_name字符串可选。可提高搜索准确度,也是身份验证门检查发现的账号时会核对的名称。
includeFollowerCounts布尔值为 "true"(默认值)时,会获取个人资料页面并提取粉丝数。设为 "false" 时,仅解析个人资料 URL,成本更低,且需要
skipCache布尔值为 "false"(默认值)时,成功的查询会缓存七天并重复使用。设为 "true" 时,强制重新获取。为兼容 Clay,以字符串形式传递
escalateOnBlock布尔值TikTok 大多数请求都通过低成本的数据中心路由响应,但少部分请求会被机器人检测页面拦截。为 "true"(默认值)时,被拦截的获取会
max_charge_usd数字可选的本次调用支出上限,单位为 USD。Actor 会在费用可能使本次运行超过该上限前停止,并保留所有已计费行。

读取输出

每一行都带有一个按平台区分的 _status 字段,应首先查看该字段。 Mamba Labs 整个社交产品系列使用相同的状态词汇:

状态含义
ok已获取并解析,存在相应值
not_found已查找,但不存在相应个人资料
not_extractable个人资料存在,但我们无法从数据中获取相应值
blocked平台拒绝了请求,值得稍后重试
identity_mismatch找到了真实的个人资料,但它属于其他人
skipped你未要求查询此平台

false 和 null 绝不能互换。 false 表示我们进行了查找,答案是否定的。 null 表示我们无法进行查找。如果要筛选没有相关账号的公司,请筛选 false,因为 null 行表示未知,而不是不存在。

定价

你按 Apify 上的事件付费,费用计入你自己的 Apify 账户。以下价格来自实时定价记录,读取日期为 2026-10-16:

事件每个事件的价格(USD)触发时机
apify-actor-start$0.00005Actor 开始运行时计费。计费事件数取决于 Actor 内存(每 GB 计一个事件,至少计一个事件)。
company-checkedFree 套餐为 $0.004,更高的 Apify 套餐低至 $0.0028每家公司计费一次,前提是发现流程已完成并生成了非降级行,无论是否找到 TikTok 个人资料。降级行不会触发此事件,因为降级行未执行发现流程。
profile-resolvedFree 套餐为 $0.003,更高的 Apify 套餐低至 $0.0021每家公司计费一次,前提是候选 TikTok URL 通过了身份验证门。计费基于验证工作,而非是否填入了粉丝数。被判定为冒充账号而排除的候选项不会产生费用:工作已经完成,诚实的答案是不存在相应个人资料。
follower-count-extractedFree 套餐为 $0.0025,更高的 Apify 套餐低至 $0.00175每家公司计费一次,前提是从公开页面读取到了数字形式的粉丝数。not_extractable、blocked、identity_mismatch 或仅运行 URL 查询时不会触发。

Actor 的 Apify 页面列出了当前价格。运行此服务会消耗 Apify 额度。

Actor 完整文档

apify.com/mambalabs/tiktok-brand-presence-mapper

Mamba Labs GTM 套件

Mamba Labs 构建了一系列 GTM 数据增强 Actor,它们采用统一的扁平输出格式,可直接用于 Clay,因此各行可按 company_domain 合并,无需清理。 查看完整产品系列:apify.com/mambalabs

License

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。