关于 mcp-tiktok-brand-presence-mapper
该 MCP 服务使用 Apify Actor,将 TikTok 账号或企业域名解析为品牌官方账号,并返回账号资料及互动数量。适合核验品牌的 TikTok 存在情况;身份校验未通过时会标记不匹配,而不返回计数。
主要功能
- 01通过账号或企业域名查找品牌账号
- 02返回粉丝、关注、点赞和视频数
- 03提供认证状态、简介及简介链接
- 04身份校验失败时标记不匹配
- 05支持结果缓存及限制调用支出
适用场景
- 01核实企业是否有官方 TikTok 账号
- 02查看品牌账号的粉丝和内容数量
- 03检查候选账号是否与企业身份相符
MCP 相关
向 MCP 客户端提供 `map_tiktok_brand_presence` 工具,用于解析并检查品牌 TikTok 账号。服务调用 Apify Actor,需配置 APIFY_TOKEN。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
1收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| handle | string | 否 | TikTok 账号名,可带或不带前导 @,例如 shopify。这是主要输入:14 个 B2B 首页中只有 4 个声明了 TikTok 链接,因此直接提供账号名比让 actor 查找更便宜,也可靠得多。 |
| skipCache | boolean | 否 | 当值为 "false"(默认值)时,成功的查询会缓存七天并重复使用。设为 "true" 可强制重新获取。以字符串形式发送,以兼容 Clay。 |
| company_name | string | 否 | 可选。可提高搜索准确性,也是身份验证用于核对发现账号的名称。 |
| company_domain | string | 否 | 纯公司域名,例如 shopify.com。没有账号名时用于查找账号,也用于验证通过发现机制猜出的账号。两者都提供时效果最佳。 |
| escalateOnBlock | boolean | 否 | TikTok 的大多数请求会通过低成本的数据中心路由获得响应,少数请求会被带有机器人检测的页面拦截。设为 "true"(默认值)时,被拦截的 fetch 会通过住宅网络重试一次,通常可以恢复,但每条恢复的记录成本更高。设为 "false" 时会接受拦截并返回状态 blocked。以字符串形式传入,以兼容 Clay。 |
| includeFollowerCounts | boolean | 否 | 当值为 "true"(默认值)时,会获取个人资料页面并提取计数。设为 "false" 后仅解析个人资料 URL,成本更低且无需代理。以字符串形式发送,以兼容 Clay。 |
详细介绍
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" }
}
}
}
前提条件
- Node.js 18 或更高版本
- Apify API 令牌,可从 console.apify.com/account/integrations 获取
该 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.00005 | Actor 开始运行时计费。计费事件数取决于 Actor 内存(每 GB 计一个事件,至少计一个事件)。 |
company-checked | Free 套餐为 $0.004,更高的 Apify 套餐低至 $0.0028 | 每家公司计费一次,前提是发现流程已完成并生成了非降级行,无论是否找到 TikTok 个人资料。降级行不会触发此事件,因为降级行未执行发现流程。 |
profile-resolved | Free 套餐为 $0.003,更高的 Apify 套餐低至 $0.0021 | 每家公司计费一次,前提是候选 TikTok URL 通过了身份验证门。计费基于验证工作,而非是否填入了粉丝数。被判定为冒充账号而排除的候选项不会产生费用:工作已经完成,诚实的答案是不存在相应个人资料。 |
follower-count-extracted | Free 套餐为 $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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。