Bluesky Brand Presence Mapper

Encontra o handle de Bluesky de uma empresa a partir do seu domínio e retorna a URL do perfil com o número de seguidores.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Bluesky Brand Presence Mapper

Um servidor MCP que resolve o domínio de uma empresa para sua conta no Bluesky com contagens exatas de seguidores, seguindo e publicações. Ele encapsula o ator Bluesky Brand Presence Mapper da Mamba Labs no Apify e retorna uma linha JSON plana pronta para Clay para qualquer cliente MCP.

O que ele faz

Forneça o domínio de uma empresa, ou um handle do Bluesky se você já tiver um, e ele encontra a conta oficial da empresa no Bluesky por meio da API pública do protocolo AT. Ele retorna a URL do perfil, o handle, o DID, contagens exatas de seguidores, seguindo e publicações, nome de exibição, bio e data de criação da conta, como uma única linha plana.

As contagens são exatas, não arredondadas. Quando o handle resolvido é o próprio domínio da empresa, o Bluesky concedeu esse handle somente após uma verificação de DNS que a empresa teve que passar, e a linha sinaliza isso como a evidência de identidade mais forte que a plataforma oferece. Uma empresa sem conta no Bluesky retorna not_found, que é uma resposta real e comum, não uma falha.

Toda a busca é executada no Apify. Este pacote é um cliente leve que chama o ator e devolve o resultado inalterado.

A ferramenta inicia a execução do ator e a consulta até um status concluído, para que uma execução longa não seja interrompida em 300 segundos. A execução tem permissão de 1.800 segundos. Se ainda estiver em andamento dois minutos depois disso, a chamada para de esperar e retorna o ID da execução com um link para ela no Console do Apify, onde os resultados chegam quando ela termina. Uma execução que não for bem-sucedida retorna como erro com seu ID e status.

Início rápido

Você precisa do Node.js 18 ou mais recente e de uma conta no Apify com um token de API.

Adicione isto à sua configuração do Claude Desktop:

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

Obtenha seu token em https://console.apify.com/account/integrations,, cole-o e reinicie o Claude Desktop. A ferramenta map_bluesky_brand_presence estará disponível.

Pré-requisitos

Node.js 18 ou mais recente
Uma conta no Apify com um token de API

Exemplos de prompts

"Encontre a conta do Bluesky para theverge.com e me dê o número de seguidores."
"O shopify.com tem uma conta no Bluesky, e o handle é verificado por domínio?"
"Consulte o handle do Bluesky theverge.com e me diga quando a conta foi criada."
"Mapeie a presença no Bluesky para npr.org sem usar a busca de contas do Bluesky."

Entradas

company_domain (opcional): domínio simples da empresa, por exemplo shopify.com. Forneça isto ou um handle. Com um domínio, o ator executa a descoberta completa; com um handle, ele pula direto para a busca.
company_name (opcional): melhora a precisão da busca e é o que a verificação de identidade compara com um perfil descoberto, então fornecê-lo reduz correspondências incorretas.
handle (opcional): um handle do Bluesky como shopify.com, mamba.bsky.social, ou um DID. Fornecê-lo pula a descoberta completamente. Uma empresa que verificou seu domínio com o Bluesky usa o domínio simples como handle, por isso isso geralmente é igual a company_domain.
includeFollowerCounts (opcional): quando verdadeiro (o padrão), o perfil é buscado e as contagens são extraídas. Defina como falso para resolver apenas a URL do perfil, o que é mais barato.
skipCache (opcional): quando falso (o padrão), uma busca bem-sucedida é armazenada em cache por sete dias e reutilizada. Defina como verdadeiro para forçar uma nova busca.
useActorSearch (opcional): quando verdadeiro (o padrão) e o domínio não é em si um handle verificado, a busca de contas do próprio Bluesky é usada. Defina como falso para confiar apenas na página inicial da empresa e no domínio como handle, o que evita qualquer chance de corresponder a uma conta com nome semelhante.

Forneça company_domain ou handle.

Saída

A ferramenta retorna a linha JSON plana do ator para a empresa, com 18 campos em snake_case e sem objetos aninhados. Leia bluesky_status antes de ler qualquer contagem: ok, not_found, not_extractable, blocked, identity_mismatch, auth_failed ou skipped são respostas diferentes e o wrapper nunca as colapsa. bluesky_discovery indica qual rota encontrou a conta, de domain_handle (mais forte) até pattern_guess. Veja a página da Apify Store para o esquema completo de saída.

Exemplo de saída

{
  "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"
}

Recursos

Resolve uma conta de marca no Bluesky a partir do domínio de uma empresa
Contagens exatas de seguidores, seguindo e publicações, não arredondadas
DID estável retornado junto com o handle, para que uma conta possa ser rastreada ao longo do tempo
Status de verificação de domínio, que o Bluesky concede somente após uma verificação de DNS
Data de criação da conta, para que uma presença nova seja distinguível de uma estabelecida
A rota de descoberta é relatada em cada linha em bluesky_discovery
18 campos planos em snake_case, uma linha por empresa

Documentação completa do ator

Este servidor é um cliente leve e não contém lógica de busca. Para a referência completa de entrada e saída, preços e histórico de execuções, veja a página da Apify Store:

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

Suíte GTM da Mamba Labs

Este servidor é um dos servidores MCP da Suíte GTM da Mamba Labs. Cada ator da suíte recebe um domínio ou uma empresa e retorna uma linha plana, então eles se empilham na mesma tabela do Clay sem remodelar nada. O ator por trás deste servidor é o Bluesky Brand Presence Mapper, com ID imutável de ator Apify eLpxzP4IuXznlFVND.

Construído por Mamba Labs | npm | Apify Store

Licença

MIT

Construído por Mamba Labs. https://apify.com/mambalabs