Mcp Tiktok Brand Presence Mapper

com.mambabuilt由 mambabuilt.com 發布v1.2.1更新於 Nov 7, 2026

Resolve a TikTok handle or company domain to the brand account with follower counts.

已驗證STDIO僅桌面網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

把 TikTok 帳號名稱或公司網域解析為該品牌的官方 TikTok 帳號，並以單列扁平資料回傳粉絲、按讚與影片數。

可以做什麼
  • 把 TikTok 帳號名稱或公司網域解析為品牌的官方 TikTok 帳號
  • 回傳粉絲數、追蹤數、按讚數、影片數、驗證狀態、顯示名稱、簡介與外連網址，合併為單列扁平資料
  • 標示被 TikTok 四捨五入的計數，並將未通過身分核對的猜測帳號回報為 identity_mismatch
  • 可選擇略過計數擷取只解析網址以降低成本、沿用七天快取，或設定單次呼叫的花費上限
適用情境
適合需要了解某公司 TikTok 經營狀況、粉絲規模或驗證狀態的行銷與 GTM 研究，也適合確認某網域是否根本沒有 TikTok 帳號。適用於希望每家公司產出一列扁平資料的補充資料流程。
執行需求
透過 npx 在使用者本機執行，需要 Node.js 18 或更新版本。需要 Apify API 權杖，以 APIFY_TOKEN 環境變數提供，並需要連線至 Apify 與 TikTok 的網路。
安裝前請注意
每次呼叫都會依事件計費，扣抵你自己的 Apify 帳戶額度；可用 max_charge_usd 限制單次呼叫花費。必須提供 APIFY_TOKEN 密鑰。查詢為唯讀，但成功結果預設快取七天，除非設定 skipCache；約一萬以上的計數會被 TikTok 四捨五入。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Tiktok Brand Presence Mapper，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

其他 MCP 客戶端

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

README

TikTok Brand Presence Mapper MCP Server

[Glama score] [MCP Registry] [npm version] [npm downloads] [license]

[Tiktok Brand Presence Mapper MCP server]

MCP server for the Mamba Labs TikTok Brand Presence Mapper actor on Apify.

Resolve a TikTok handle or a company domain to the brand account with follower, like and video counts.

What it does

Resolve a TikTok handle, or a company domain, to that brand's official TikTok account. Returns follower, following, like and video counts, verification status, display name, bio and the account's outbound bio link, as one flat Clay ready row. Counts above roughly ten thousand are rounded by TikTok and the row flags that. A guessed account that fails the identity check is reported as identity_mismatch with no counts rather than being returned as the company's. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.

Quick start

Add this to your MCP client configuration:

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

Prerequisites

The actor is pay per event and consumes Apify credits per call. Pricing is on the actor page.

Example prompts

  • "How many TikTok followers does Gymshark have?"
  • "Find the TikTok account for allbirds.com and tell me if it is verified."
  • "Check whether patagonia.com has a TikTok presence at all."

Tool and inputs

Tool: map_tiktok_brand_presence

InputTypeMeaning
handlestringThe TikTok handle, with or without the leading @, for example shopify. This is the PRIMARY input: only 4 of 14 B2B homepages declare a TikTok link, so
company_domainstringBare company domain, for example shopify.com. Used to FIND the handle when you do not have one, and to identity check a handle that discovery guessed.
company_namestringOptional. Improves search accuracy and is what the identity gate checks a discovered account against.
includeFollowerCountsbooleanWhen "true" (default) the profile page is fetched and the counts are extracted. Set "false" to resolve the profile URL only, which is cheaper and need
skipCachebooleanWhen "false" (default) a successful lookup is cached for seven days and reused. Set "true" to force a fresh fetch. Sent as a string for Clay compatibi
escalateOnBlockbooleanTikTok answers most requests over cheap datacenter routing and blocks a minority with a bot detection page. When "true" (default) a blocked fetch is r
max_charge_usdnumberOptional spending cap for this call, in USD. The actor stops before any charge that would take the run past this amount and keeps every row already charged.

Reading the output

Every row carries a per platform _status field, and it is the field to read first. The vocabulary is the same across the whole Mamba Labs social family:

StatusMeaning
okfetched and parsed, the value is there
not_foundwe looked and there is no such profile
not_extractablethe profile exists and the value is not on the wire to us
blockedthe platform refused us, worth retrying later
identity_mismatchwe found a real profile and it belongs to someone else
skippedyou did not ask for this platform

false and null are never interchangeable. false means we looked and the answer is no. null means we could not look. If you filter for companies with no presence, filter on false, because null rows are unknown rather than absent.

Pricing

You pay per event on Apify, billed to your own Apify account. Prices from the live pricing record, read 2026-10-16:

EventPrice per event (USD)Fires when
apify-actor-start$0.00005Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
company-checked$0.004 on the Free plan, down to $0.0028 on higher Apify plansOnce per company for which the discovery cascade completed and a non degraded row was produced, whether or not a TikTok profile was found. Does not fire on a degraded row, because on a degraded row no discovery was performed.
profile-resolved$0.003 on the Free plan, down to $0.0021 on higher Apify plansOnce per company whose candidate TikTok URL passed the identity gate. Fires on the validation work, not on a populated count. A candidate dropped as an impersonator does not charge: the work was done and the honest answer is that there is no such profile.
follower-count-extracted$0.0025 on the Free plan, down to $0.00175 on higher Apify plansOnce per company where a numeric follower count was read off the public page. Does not fire on not_extractable, blocked, identity_mismatch or url only runs.

The actor's Apify page carries the current prices. Running this server consumes Apify credits.

Full actor documentation

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

Mamba Labs GTM Suite

Mamba Labs builds a fleet of GTM enrichment actors that share one flat, Clay ready output convention, so their rows join on company_domain with no cleaning step. Full fleet: apify.com/mambalabs

License

MIT

來源：README.md，提交 345d595

工具

1

map_tiktok_brand_presence

Map TikTok Brand Presence

Resolve a TikTok handle, or a company domain, to that brand's official TikTok account. Returns follower, following, like and video counts, verification status, display name, bio and the account's outbound bio link, as one flat Clay ready row. Counts above roughly ten thousand are rounded by TikTok and the row flags that. A guessed account that fails the identity check is reported as identity_mismatch with no counts rather than being returned as the company's, and a brand with no TikTok account reports tiktok_status not_found. Read tiktok_status before any count. Use it to look up one known brand per call; it does not search TikTok, list or read videos, or compare accounts, so pair it with the sibling presence mappers for other platforms. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.

輸入參數handleskipCachecompany_namecompany_domainmax_charge_usdescalateOnBlockincludeFollowerCounts

版本歷史

5
  1. v1.2.1最新Nov 5, 2026
  2. v1.2.0Oct 16, 2026
  3. v1.1.1Oct 6, 2026
  4. v1.1.0Oct 6, 2026
  5. v1.0.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

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

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

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

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分