mcpField
M
mcp-bluesky-brand-presence-mapper

mcp-bluesky-brand-presence-mapper

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

关于 mcp-bluesky-brand-presence-mapper

这款 MCP 服务通过公司域名或指定的 Bluesky handle 查找企业账号,并以扁平行返回账号信息及精确的关注者、关注中和帖子数量。查找由 Apify Actor 执行。

主要功能

  1. 01通过域名或 handle 查找账号
  2. 02返回精确的关注者、关注中和帖子数
  3. 03提供 DID 和域名验证信息
  4. 04报告创建日期和发现途径
  5. 05以扁平 JSON 区分查找状态

适用场景

  1. 01检查企业是否拥有 Bluesky 账号
  2. 02查看品牌的关注者和帖子数量
  3. 03核实与域名匹配的 Bluesky handle
  4. 04通过稳定 DID 跟踪账号

MCP 相关

向 MCP 客户端提供 `map_bluesky_brand_presence` 工具。它启动并轮询 Apify Actor,随后返回运行结果。

配置

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

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

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

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

工具

1

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

参数类型必填说明
handlestring否可选。Bluesky 用户名,例如 shopify.com、mamba.bsky.social 或 did。提供此值会完全跳过发现步骤,直接获取个人资料。已通过 Bluesky 验证域名的公司会使用裸域名作为用户名,因此此值通常等于 company_domain。
skipCacheboolean否当值为 "false"(默认值)时,成功的查询会缓存七天并重复使用。设为 "true" 可强制重新获取。以字符串形式发送,以兼容 Clay。
company_namestring否可选。提高搜索准确性;身份验证关卡会用它核对发现的个人资料,因此提供此值可减少错误匹配。
company_domainstring否公司裸域名,例如 shopify.com。请提供此值或 handle。提供域名时,actor 会执行完整发现流程;提供 handle 时,会直接跳过发现并获取资料。
useActorSearchboolean否当值为 "true"(默认值)且该域名本身不是已验证的用户名时,会使用 Bluesky 自身的账号搜索来查找公司。设为 "false" 后,仅依赖公司主页和作为用户名的域名,从而避免匹配到名称相似的账号。以字符串形式发送,以兼容 Clay。
includeFollowerCountsboolean否当值为 "true"(默认值)时,会获取个人资料页面并提取计数。设为 "false" 后仅解析个人资料 URL,成本更低且无需代理。以字符串形式发送,以兼容 Clay。

详细介绍

Bluesky 品牌影响力映射器 MCP 服务

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

Bluesky 品牌影响力映射器 MCP 服务

一个 MCP 服务,可将公司域名解析为其 Bluesky 账号,并提供准确的关注者、关注对象和帖子数量。它封装了 Mamba Labs 在 Apify 上运行的 Bluesky 品牌影响力映射器 Actor,并向任何 MCP 客户端返回适用于 Clay 的扁平 JSON 行。

内容

功能

提供公司域名,或者在已有 Bluesky 账号时提供其用户名,即可通过公开的 AT Protocol API 查找该公司的官方 Bluesky 账号。它会以一行扁平数据的形式返回个人资料 URL、用户名、DID、准确的关注者、关注对象和帖子数量、显示名称、简介以及账号创建日期。

数量均为准确值,而非四舍五入后的值。当解析出的用户名就是公司域名时,说明 Bluesky 仅在公司通过 DNS 验证后才授予该用户名;结果行会将此标记为平台提供的最有力身份依据。没有 Bluesky 账号的公司会返回 not_found。这是常见且有效的结果,并非失败。

所有查找操作都在 Apify 上运行。此软件包只是一个轻量客户端,用于调用 Actor 并原样返回结果。

该工具会启动 Actor 运行任务并轮询,直到任务完成,因此长时间运行的任务不会在 300 秒后被中断。任务最长允许运行 1,800 秒。如果超过这个时限后任务仍在运行两分钟,调用就会停止等待,并返回运行 ID 及其在 Apify Console 中的链接;任务完成后,结果会显示在那里。未成功的任务会作为错误返回,并附带其运行 ID 和状态。

快速开始

你需要 Node.js 18 或更高版本,以及一个带有 API 令牌的 Apify 账号。

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

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

前往 https://console.apify.com/account/integrations 获取令牌,将其粘贴进去,然后重启 Claude Desktop。之后即可使用 map_bluesky_brand_presence 工具。

先决条件

  • Node.js 18 或更高版本
  • 一个带有 API 令牌的 Apify 账号

示例提示词

  • "查找 theverge.com 的 Bluesky 账号,并告诉我其关注者数量。"
  • "shopify.com 有 Bluesky 账号吗?其账号句柄是否通过域名验证?"
  • "查询 Bluesky 账号句柄 theverge.com,并告诉我账号的创建时间。"
  • "在不使用 Bluesky 账号搜索的情况下,梳理 npr.org 在 Bluesky 上的情况。"

输入

  • company_domain(可选):裸公司域名,例如 shopify.com。请提供此项或账号句柄。提供域名时,Actor 会执行完整发现流程;提供账号句柄时,则直接跳到抓取步骤。
  • company_name(可选):可提高搜索准确度,也是身份验证环节用于比对所发现个人资料的依据,因此提供此项可减少匹配错误。
  • handle(可选):Bluesky 账号句柄,例如 shopify.com、mamba.bsky.social 或 DID。提供此项会完全跳过发现流程。已通过 Bluesky 域名验证的公司会将裸域名用作账号句柄,因此它通常与 company_domain 相同。
  • includeFollowerCounts(可选):为 true 时(默认值),会获取个人资料并提取相关数量。设为 false 则只解析个人资料 URL,成本更低。
  • skipCache(可选):为 false 时(默认值),成功的查询会缓存 7 天并重复使用。设为 true 可强制重新抓取。
  • useActorSearch(可选):为 true 时(默认值),且域名本身并非已验证账号句柄时,会使用 Bluesky 自带的账号搜索。设为 false 则仅依据公司主页和域名作为账号句柄进行查找,避免匹配到名称相似的账号。
  • max_charge_usd(可选):本次运行的美元费用上限。若某个项目可能导致费用超过此金额,Actor 会在处理该项目之前停止。省略此项则使用 Apify 设置的每次运行最高费用。

请提供 company_domain 或 handle 其中之一。

输出

工具会返回该公司的 Actor 扁平 JSON 行,包含 18 个 snake_case 字段,不含嵌套对象。读取任何数量之前,请先查看 bluesky_status:ok、not_found、not_extractable、blocked、identity_mismatch、auth_failed 或 skipped 各自代表不同结果,封装层不会将它们合并。bluesky_discovery 指明发现账号所用的路径,从最可靠的 domain_handle 到 pattern_guess。完整输出架构请参阅 Apify Store 页面。

示例输出

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "theverge.com",
  "company_name": "The Verge",
  "bluesky_url": "https://bsky.app/profile/theverge.com",
  "bluesky_handle": "theverge.com",
  "bluesky_did": "did:plc:7exlcsle4mjfhu3wnhcgizz6",
  "bluesky_domain_verified": true,
  "bluesky_followers": 357220,
  "bluesky_following": 141,
  "bluesky_posts": 14584,
  "bluesky_followers_exact": true,
  "bluesky_display_name": "The Verge",
  "bluesky_bio": "The Verge covers the intersection of technology, science, art, and culture.",
  "bluesky_created_at": "2023-05-23T19:11:25.009Z",
  "bluesky_discovery": "domain_handle",
  "bluesky_status": "ok",
  "run_date": "2026-08-22T19:26:58.474Z"
}

功能

  • 从公司域名出发解析品牌的 Bluesky 账号
  • 提供准确的关注者、关注对象和帖子数量,而非四舍五入后的数字
  • 除账号句柄外,还会返回稳定的 DID,便于长期追踪账号
  • 提供域名验证状态;Bluesky 仅在完成 DNS 检查后才会授予验证
  • 提供账号创建日期,以便区分新账号和已运营一段时间的账号
  • 每行都会在 bluesky_discovery 中报告发现路径
  • 18 个扁平 snake_case 字段,每家公司一行

定价

Apify FREE 方案下每个事件的价格,取自实时定价记录;付费 Apify 方案的单次事件费用更低。

事件价格(USD)
Actor 启动(apify-actor-start)0.00005
检查公司(company-checked)0.0035
解析个人资料(profile-resolved)0.003
提取关注者数量(follower-count-extracted)0.0025

Actor 完整文档

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

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


Mamba Labs GTM 套件

此服务是 Mamba Labs GTM 套件中的一项 MCP 服务。套件中的每个 Actor 都接受域名或公司名称,并返回一行扁平数据,因此可以直接放入同一个 Clay 表格,无需重新整理格式。此服务背后的 Actor 是 Bluesky Brand Presence Mapper,其不可变的 Apify Actor ID 为 eLpxzP4IuXznlFVND。

由 Mamba Labs 构建 | npm | Apify Store

许可证

MIT

由 Mamba Labs 构建。https://apify.com/mambalabs

评论

支持 Markdown

第一次接触 MCP?

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

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