mcp-x-brand-presence-mapper

本地服务

github.com/mambalabsdev社交媒体01 周前更新

代码仓库

关于 mcp-x-brand-presence-mapper

这款 MCP 服务将公司域名解析为 X 账号和主页，并获取可用的账号指标与资料。它面向公司研究，通过 Apify Actor 返回扁平 JSON 行，并区分身份不匹配和无法提取的数据。

主要功能

01解析 X 账号和主页链接
02获取关注者、关注数和帖子数
03返回认证状态、简介和创建日期
04无需 X API 令牌即可使用
05报告抓取方式和结果状态

适用场景

01查找公司的官方 X 主页
02了解公司的 X 受众和活跃度
03仅解析主页链接而不抓取关注者数量

MCP 相关

向 MCP 客户端提供 `map_x_brand_presence` 工具。它将输入传给 Apify Actor，并原样返回结果。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "com-mambabuilt-mcp-x-brand-presence-mapper": {
      "command": "npx",
      "args": [
        "-y",
        "@mambalabsdev/mcp-x-brand-presence-mapper"
      ],
      "env": {
        "APIFY_TOKEN": "<APIFY_TOKEN>"
      }
    }
  }
}

启动命令npx -y @mambalabsdev/mcp-x-brand-presence-mapper

需要配置的环境变量

APIFY_TOKEN密钥Apify API token from https://console.apify.com/account/integrations

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

安装包

npm@mambalabsdev/mcp-x-brand-presence-mapper1.2.0stdio

工具

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

参数	类型	必填	说明
handle	string	否	可选。X 账号名，可带或不带前导 @，例如 Shopify。提供后会跳过发现步骤，直接抓取。
skipCache	boolean	否	当值为 "false"（默认值）时，成功的查询会缓存七天并重复使用。设为 "true" 可强制重新获取。以字符串形式发送，以兼容 Clay。
company_name	string	否	可选。提高搜索准确性；身份验证关卡会用它核对发现的个人资料，因此提供此值可减少错误匹配。
company_domain	string	否	公司裸域名，例如 shopify.com。请提供此值或 handle。提供域名时，actor 会执行完整发现流程；提供 handle 时，会直接跳过发现并获取资料。
xApiBearerToken	string	否	你自己的 X API v2 bearer token，可在 developer.x.com 免费创建。可选：留空时，actor 仍会解析账号名、个人资料 URL 和粉丝数，但 X 会限制公共路由的速率，因此在大型批次中，部分行会返回 not_extractable 而不是计数。提供令牌可解除该限制，每行都会返回完整指标。令牌仅用于本次运行，不会存储，也不会与其他运行共享。
includeFollowerCounts	boolean	否	当值为 "true"（默认值）时，会获取个人资料页面并提取计数。设为 "false" 后仅解析个人资料 URL，成本更低且无需代理。以字符串形式发送，以兼容 Clay。

详细介绍

X Twitter 品牌影响力映射 MCP 服务

一个 MCP 服务，可将公司域名解析为其 X（Twitter）账号、个人资料 URL 和粉丝指标。它封装了 Apify 上 Mamba Labs 的 X Twitter Brand Presence Mapper actor，并向任何 MCP 客户端返回可直接用于 Clay 的扁平 JSON 行。

功能介绍

输入公司域名，即可获取该公司的官方 X 账号和个人资料 URL，以及粉丝数、关注数、帖子数、认证状态、简介和账号创建日期（如果 X 提供这些信息）。每家公司对应一行扁平数据。

开箱即用，无需密钥。X 对公共访问路径实施了严格的速率限制，因此批量处理时，部分行可能会返回账号和 URL，但将指标标记为 not_extractable。提供自己的 X API bearer token 即可解除此限制，无论批次大小如何，都能返回完整指标。密钥提升的是效果，而非解锁工具。

如果猜测的账号未通过身份验证，结果会标记为 identity_mismatch，而不会将其作为该公司的账号返回。所有查询都在 Apify 上运行。此软件包是一个轻量客户端，负责调用 actor 并原样返回结果。

快速开始

需要 Node.js 18 或更高版本，以及拥有 API token 的 Apify 账号。

将以下内容添加到 Claude Desktop 配置中：

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

前往 https://console.apify.com/account/integrations 获取 token，将其粘贴进去，然后重启 Claude Desktop。届时即可使用 map_x_brand_presence 工具。

前置条件

Node.js 18 或更高版本
拥有 API token 的 Apify 账号
可选：自己的 X API v2 bearer token，可在 developer.x.com 免费创建；若要对大批量数据获取完整指标，则需要此 token

示例提示词

“查找 shopify.com 的 X 账号，并告诉我它的粉丝数。”
“stripe.com 的 X 账号是什么？该账号是什么时候创建的？”
“解析 figma.com 的 X 个人资料 URL，不要获取粉丝数。”
“查找 Shopify 的 X 账号，并返回简介和帖子数。”

输入

company_domain（可选）：公司的纯域名，例如 shopify.com。请提供该值或句柄。提供域名时，Actor 会执行完整的发现流程；提供句柄时，则会直接跳到抓取步骤。
company_name（可选）：提高搜索准确度，也是身份校验会用来核对已发现个人资料的名称，因此提供该值可以减少错误匹配。
handle（可选）：X 句柄，可带或不带前导 @，例如 Shopify。提供该值后会跳过发现流程，直接抓取。
includeFollowerCounts（可选）：为 true（默认值）时，会抓取个人资料页面并提取各项计数。设为 false 时，只解析个人资料 URL，费用更低且无需代理。
skipCache（可选）：为 false（默认值）时，成功的查询会缓存七天并重复使用。设为 true 时，强制重新抓取。
xApiBearerToken（可选）：你自己的 X API v2 bearer token，可在 developer.x.com 免费创建。不提供时，该工具仍会解析句柄、个人资料 URL 和关注者数量，但 X 会对公共接口限流，因此大型批次中的部分行会返回 not_extractable，而不是计数。你的 token 仅用于本次运行，不会被存储，也不会与其他运行共享。
max_charge_usd（可选）：本次调用的支出上限，单位为 USD。Actor 会在任何费用可能导致运行总额超过此上限之前停止，并保留已计费的所有行。

请提供 company_domain 或 handle。

输出

该工具会返回此公司的扁平 JSON 行，其中包含 18 个蛇形命名字段，不含嵌套对象。请先查看 x_status：ok、not_found、not_extractable 和 identity_mismatch 表示不同结果，包装器不会将它们合并。x_fetch_route 表示计数数据的获取途径，x_discovery 表示句柄的发现方式。完整输出架构请参阅 Apify Store 页面。

输出示例

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "shopify.com",
  "company_name": "Shopify",
  "x_url": "https://x.com/Shopify",
  "x_handle": "Shopify",
  "x_followers": 452243,
  "x_followers_exact": true,
  "x_following": 3423,
  "x_tweet_count": 37167,
  "x_verified": false,
  "x_display_name": "Shopify",
  "x_bio": "The entrepreneurship company",
  "x_created_at": "2008-11-03T18:33:14.000Z",
  "x_fetch_route": "syndication",
  "x_discovery": "homepage_sameas",
  "x_status": "ok",
  "run_date": "2026-08-22T19:23:45.055Z"
}

功能

从公司域名开始，解析其官方 X 句柄和个人资料 URL
提供关注者数、关注数和帖子数，以及认证状态
提供账号创建日期、简介和显示名称
无需密钥即可运行，也可使用你自己的 X API 密钥以扩展规模
优先通过主页上的 sameAs 标记发现域名
在每行的 x_fetch_route 中报告抓取途径
每家公司一行，包含 18 个扁平蛇形命名字段

定价

你按事件付费，费用由你自己的 Apify 账户结算。以下价格来自实时定价记录，读取日期为 2026-10-16：

事件	每次事件价格（USD）	触发时机
`apify-actor-start`	$0.00005	Actor 开始运行时计费。计费事件数量取决于 Actor 内存（每 GB 计一次，至少一次）。
`company-checked`	Free 计划为 $0.0035，较高的 Apify 计划低至 $0.00245	每家公司计费一次，条件是发现流程级联完成且生成了非降级行，无论是否找到 X 账号。降级行不会触发此事件，因为降级行未执行发现。
`profile-resolved`	Free 计划为 $0.003，较高的 Apify 计划低至 $0.0021	每家公司计费一次，条件是候选 X URL 通过身份校验。该事件按验证工作触发，而不是按计数数据是否已填充触发。这是 Actor 在无密钥模式下产生费用的事件，因为无论 X 是否提供计数，句柄解析都会成功。
`follower-count-extracted`	Free 计划为 $0.0025，较高的 Apify 计划低至 $0.00175	每家公司计费一次，条件是实际读取到了数字形式的关注者数量，来源可以是任一途径。受限流影响的行不会触发该事件，也不会因计数而收费；这是有意设计的：如果 `not_extractable` 行触发事件，就等于为字符串 `not_extractable` 收费。

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

完整的 Actor 文档

此服务是一个轻量级客户端，不包含任何查询逻辑。如需查看完整的输入和输出参考、定价及运行历史，请访问 Apify Store 页面：

https://apify.com/mambalabs/x-brand-presence-mapper

Mamba Labs GTM 套件

此服务是 Mamba Labs GTM 套件中的一个 MCP 服务。套件中的每个 Actor 都接收一个域名或公司名称，并返回一行扁平数据，因此无需调整格式即可将它们叠加到同一个 Clay 表格中。此服务背后的 Actor 是 X Twitter Brand Presence Mapper，其不可变的 Apify Actor ID 为 oLOgadhHUkNAyDA3w。