mcpField
M
mcp-tiktok-brand-presence-mapper

mcp-tiktok-brand-presence-mapper

ローカル
github.com/mambalabsdevソーシャルメディア01 週間前に更新

mcp-tiktok-brand-presence-mapper について

TikTok ハンドルまたは企業ドメインからブランドの公式アカウントを特定し、プロフィール情報や各種数値を返す Apify Actor を利用する MCP サーバーです。ブランドの TikTok での存在確認に使え、本人確認に失敗した場合は数値を返さず不一致として示します。

主な機能

  1. 01ハンドルまたは企業ドメインからブランドアカウントを特定
  2. 02フォロワー、フォロー、いいね、動画数を返却
  3. 03認証状態、プロフィール、プロフィールリンクを提供
  4. 04本人確認に失敗したアカウントを不一致として表示
  5. 05キャッシュと呼び出しごとの支出上限に対応

活用シーン

  1. 01企業の公式 TikTok アカウントの有無を確認
  2. 02ブランドアカウントのフォロワー数や投稿数を確認
  3. 03候補アカウントと企業の一致を検証

MCP 対応

ブランドの TikTok アカウントを特定・確認する `map_tiktok_brand_presence` ツールを MCP クライアントに提供します。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)。これは主要な入力です。TikTok リンクを掲載している B2B のホームページは 14 件中 4 件だけのため、ハンドルを指定する方が actor に検索させるより安価で、はるかに信頼性が高くなります。
skipCachebooleanいいえ"false"(デフォルト)の場合、成功した検索結果は 7 日間キャッシュされ、再利用されます。"true" にすると、強制的に再取得します。Clay との互換性のため、文字列として送信されます。
company_namestringいいえ任意です。検索精度を高め、発見したアカウントを照合する際の本人確認にも使用されます。
company_domainstringいいえ会社のドメインのみを指定します(例:shopify.com)。ハンドルが分からない場合にハンドルを特定し、検出処理で推定したハンドルの本人確認にも使用します。両方を指定するのが最適です。
escalateOnBlockbooleanいいえTikTok は低コストのデータセンタールーティング経由のリクエストの大半に応答しますが、一部はボット検出ページによってブロックされます。"true"(デフォルト)の場合、ブロックされた fetch を住宅用ネットワーク経由で 1 回再試行します。多くの場合は取得できますが、取得できた行あたりのコストは高くなります。"false" にすると、ブロックを受け入れて status blocked を返します。Clay との互換性のため、文字列として渡します。
includeFollowerCountsbooleanいいえ"true"(デフォルト)の場合、プロフィールページを取得して数値を抽出します。"false" にするとプロフィール URL の解決のみを行い、コストを抑えられ、プロキシも不要です。Clay との互換性のため、文字列として送信されます。

詳細

TikTok ブランドプレゼンスマッパー MCP サーバー

Smithery Glama score MCP Registry npm version npm downloads license

Tiktok Brand Presence Mapper MCP server

Apify 上の Mamba Labs TikTok Brand Presence Mapper アクター向け MCP サーバーです。

TikTok のハンドル名または企業ドメインから、フォロワー数、いいね数、動画数を含むブランドアカウントを特定します。

機能

TikTok のハンドル名または企業ドメインから、そのブランドの公式 TikTok アカウントを特定します。フォロワー数、フォロー中の数、いいね数、動画数、認証状況、表示名、プロフィール、アカウントのプロフィールに記載された外部リンクを、Clay ですぐ使える1行のフラットな形式で返します。およそ1万を超える数値は 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" }
    }
  }
}

前提条件

このアクターはイベントごとの従量課金制で、呼び出しごとに Apify クレジットを消費します。料金は アクターページをご覧ください。

プロンプトの例

  • 「Gymshark の TikTok フォロワー数を教えてください。」
  • 「allbirds.com の TikTok アカウントを探して、認証済みかどうかを教えてください。」
  • 「patagonia.com が TikTok を利用しているかどうかを確認してください。」

ツールと入力

ツール:map_tiktok_brand_presence

入力型意味
handlestringTikTok のハンドル。先頭の @ はあってもなくてもかまいません。例:shopify。これは主要な入力です。B2B のホームページのうち TikTok リンクを掲載しているのは 14 件中 4 件のみのため、
company_domainstring会社のドメインのみ。例:shopify.com。ハンドルがない場合にハンドルを検索するために使用します。また、検出で推測したハンドルの本人確認にも使用します。
company_namestring任意です。検索精度が向上し、検出したアカウントを本人確認ゲートが照合する対象になります。
includeFollowerCountsboolean"true"(デフォルト)の場合、プロフィールページを取得してフォロワー数を抽出します。プロフィール URL の解決のみを行う場合は "false" に設定します。この方法は低コストで、必要な
skipCacheboolean"false"(デフォルト)の場合、成功した検索結果は 7 日間キャッシュされ、再利用されます。新たに取得する場合は "true" に設定します。Clay との互換性のため、文字列として送信されます
escalateOnBlockbooleanTikTok は低コストのデータセンター経由のルーティングでほとんどのリクエストに応答しますが、一部はボット検出ページでブロックされます。"true"(デフォルト)の場合、ブロックされた取得は
max_charge_usdnumber任意の呼び出し上限額(USD)です。実行料金がこの金額を超える処理の前にアクターは停止し、すでに課金された行はすべて保持されます。

出力の読み方

各行にはプラットフォームごとの _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アクターの実行開始時に課金されます。課金されるイベント数はアクターのメモリ量によって異なります(GB ごとに 1 イベント、最低 1 イベント)。
company-checked無料プランでは $0.004、上位の Apify プランでは最安 $0.0028検出カスケードが完了し、劣化していない行が生成された会社ごとに 1 回課金されます。TikTok プロフィールが見つかったかどうかは問いません。劣化した行では検出が行われないため、課金されません。
profile-resolved無料プランでは $0.003、上位の Apify プランでは最安 $0.0021候補の TikTok URL が本人確認ゲートを通過した会社ごとに 1 回課金されます。値が入力された場合ではなく、検証作業に対して課金されます。なりすましとして候補が除外された場合は課金されません。作業は行われていますが、正しい回答は「そのプロフィールは存在しない」です。
follower-count-extracted無料プランでは $0.0025、上位の Apify プランでは最安 $0.00175公開ページから数値のフォロワー数を読み取れた会社ごとに 1 回課金されます。not_extractable、blocked、identity_mismatch、または URL のみを取得する実行では課金されません。

アクターの Apify ページに最新の料金が掲載されています。このサーバーを実行すると Apify クレジットを消費します。

アクターのドキュメント全文

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

Mamba Labs GTM Suite

Mamba Labs は、統一された Clay 対応の出力規約を共有する GTM エンリッチメントアクター群を構築しています。そのため、データを整える手順なしで、各アクターの行を company_domain で結合できます。全アクターはこちら:apify.com/mambalabs

License

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。