Bluesky Brand Presence Mapper

Encuentra el handle de Bluesky de una empresa a partir de su dominio y devuelve la URL del perfil con su número de seguidores.

Documentación

Servidor MCP de Mapeo de Presencia de Marca en Bluesky

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

Un servidor MCP que resuelve el dominio de una empresa a su cuenta de Bluesky con recuentos exactos de seguidores, seguidos y publicaciones. Envuelve el actor Bluesky Brand Presence Mapper de Mamba Labs en Apify y devuelve una fila JSON plana lista para Clay a cualquier cliente MCP.

Qué incluye

Qué hace

Proporciónale un dominio de empresa, o un identificador de Bluesky si ya tienes uno, y encuentra la cuenta oficial de Bluesky de esa empresa a través de la API pública del Protocolo AT. Devuelve la URL del perfil, el identificador, el DID, los recuentos exactos de seguidores, seguidos y publicaciones, el nombre mostrado, la biografía y la fecha de creación de la cuenta, como una sola fila plana.

Los recuentos son exactos, no redondeados. Cuando el identificador resuelto es el propio dominio de la empresa, Bluesky otorgó ese identificador solo después de una verificación DNS que la empresa tuvo que superar, y la fila lo marca como la evidencia de identidad más sólida que ofrece la plataforma. Una empresa sin cuenta de Bluesky devuelve not_found, que es una respuesta real y común, no un fallo.

Toda la búsqueda se ejecuta en Apify. Este paquete es un cliente ligero que llama al actor y devuelve el resultado sin cambios.

La herramienta inicia la ejecución del actor y la consulta hasta que alcanza un estado finalizado, por lo que una ejecución larga no se corta a los 300 segundos. A la ejecución se le permiten 1.800 segundos. Si aún continúa dos minutos después de eso, la llamada deja de esperar y devuelve el ID de ejecución con un enlace a ella en la Consola de Apify, donde aparecerán los resultados cuando termine. Una ejecución que no tiene éxito se devuelve como un error con su ID de ejecución y su estado.

Inicio rápido

Necesitas Node.js 18 o superior y una cuenta de Apify con un token de API.

Añade esto a tu configuración de Claude Desktop:

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

Obtén tu token en https://console.apify.com/account/integrations,, pégalo y reinicia Claude Desktop. La herramienta map_bluesky_brand_presence estará disponible.

Requisitos previos

  • Node.js 18 o superior
  • Una cuenta de Apify con un token de API

Ejemplos de indicaciones

  • "Encuentra la cuenta de Bluesky para theverge.com y dame su número de seguidores."
  • "¿Tiene shopify.com una cuenta de Bluesky y está verificado el identificador de dominio?"
  • "Busca el identificador de Bluesky theverge.com y dime cuándo se creó la cuenta."
  • "Mapea la presencia en Bluesky de npr.org sin usar la búsqueda de cuentas de Bluesky."

Entradas

  • company_domain (opcional): dominio de empresa sin formato, por ejemplo shopify.com. Proporciona esto o un identificador. Con un dominio, el actor realiza el descubrimiento completo; con un identificador, salta directamente a la obtención.
  • company_name (opcional): mejora la precisión de la búsqueda y es contra lo que la compuerta de identidad compara un perfil descubierto, por lo que proporcionarlo reduce coincidencias incorrectas.
  • handle (opcional): un identificador de Bluesky como shopify.com, mamba.bsky.social, o un DID. Proporcionarlo omite el descubrimiento por completo. Una empresa que ha verificado su dominio con Bluesky usa el dominio sin formato como su identificador, por lo que esto a menudo equivale a company_domain.
  • includeFollowerCounts (opcional): cuando es verdadero (el valor predeterminado), se obtiene el perfil y se extraen los recuentos. Establécelo en falso para resolver solo la URL del perfil, que es más económico.
  • skipCache (opcional): cuando es falso (el valor predeterminado), una búsqueda exitosa se almacena en caché durante siete días y se reutiliza. Establécelo en verdadero para forzar una obtención nueva.
  • useActorSearch (opcional): cuando es verdadero (el valor predeterminado) y el dominio no es en sí mismo un identificador verificado, se usa la búsqueda de cuentas propia de Bluesky. Establécelo en falso para confiar solo en la página de inicio de la empresa y en el dominio como identificador, lo que evita cualquier posibilidad de coincidir con una cuenta de nombre similar.

Proporciona company_domain o handle.

Salida

La herramienta devuelve la fila JSON plana del actor para la empresa, con 18 campos en snake_case y sin objetos anidados. Lee bluesky_status antes de leer cualquier recuento: ok, not_found, not_extractable, blocked, identity_mismatch, auth_failed o skipped son respuestas diferentes y el envoltorio nunca las colapsa. bluesky_discovery indica qué ruta encontró la cuenta, desde domain_handle (la más sólida) hasta pattern_guess. Consulta la página de Apify Store para ver el esquema completo de salida.

Ejemplo de salida

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

Características

  • Resuelve una cuenta de marca en Bluesky a partir de un dominio de empresa
  • Recuentos exactos de seguidores, seguidos y publicaciones, no redondeados
  • DID estable devuelto junto con el identificador, para que una cuenta pueda rastrearse a lo largo del tiempo
  • Estado de verificación de dominio, que Bluesky otorga solo después de una verificación DNS
  • Fecha de creación de la cuenta, para que una presencia nueva se distinga de una establecida
  • La ruta de descubrimiento se informa en cada fila en bluesky_discovery
  • 18 campos planos en snake_case, una fila por empresa

Documentación completa del actor

Este servidor es un cliente ligero y no contiene lógica de búsqueda. Para la referencia completa de entrada y salida, precios e historial de ejecuciones, consulta la página de Apify Store:

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


Suite GTM de Mamba Labs

Este servidor es uno de los servidores MCP de la Suite GTM de Mamba Labs. Cada actor de la suite toma un dominio o una empresa y devuelve una fila plana, por lo que se apilan en la misma tabla de Clay sin remodelar nada. El actor detrás de este servidor es el Bluesky Brand Presence Mapper, con ID de actor inmutable de Apify eLpxzP4IuXznlFVND.

Construido por Mamba Labs | npm | Apify Store

Licencia

MIT

Construido por Mamba Labs. https://apify.com/mambalabs