Usa bseoa como skill de IA

Un skill enseña a tu asistente a instalar bseoa, construir el comando correcto, ejecutar la auditoría y explicar los resultados. Un solo ZIP funciona en todos los asistentes que pueden ejecutar comandos.

¿Skill o conector?

Hay dos formas de llevar bseoa a tu asistente. Esta página trata del skill.

Skill

Instrucciones que lee el asistente. Funciona en cualquier lugar donde pueda ejecutar comandos. Descarga la CLI la primera vez que se usa.

Conector

Nueve herramientas que el asistente llama directamente. Hoy en hosts de escritorio; los hosts de navegador llegarán pronto.

Configurar el conector →

Antes de empezar

  1. 1. Consigue una clave de licencia. Empieza la prueba gratis de 14 días: todas las funciones, sin límite de páginas, sin tarjeta de crédito. Sin clave, cada auditoría devuelve un error de licencia.
  2. 2. Descarga el skill. bseoa-skill-26.9.16.zip es una sola carpeta, bseoa/, con un SKILL.md dentro. En los asistentes que pueden ejecutar comandos (Claude Code, Codex, Claude.ai) el skill instala la CLI por sí mismo cuando falta.
  3. 3.

    Opcional: si la CLI de bseoa ya está instalada en tu equipo, guarda tu clave una vez para que todos los asistentes puedan usarla.

    bseoa license store <your-license-key>
    bseoa license status

    bseoa y black-seo-analyzer son el mismo binario.

Claude

Claude Code

En la terminal o en tu IDE.

Skill

Descomprime el skill en tu carpeta de skills, de modo que SKILL.md quede en skills/bseoa/SKILL.md:

~/.claude/skills/                      (macOS / Linux)
%USERPROFILE%\.claude\skills\          (Windows)

Abre una sesión nueva y escribe /bseoa seguido de lo que quieres.

Conector

Para herramientas estructuradas en lugar de la CLI completa, añade el conector:

claude mcp add bseoa -s user -- bseoa mcp

Añade -e BLACK_SEO_ANALYZER_KEY=<key> si no ejecutaste bseoa license store.

Documentación de Claude Code →

Claude Desktop

Usa el paquete del conector. No necesitas nada más en tu PATH.

Descarga el paquete para tu sistema operativo, haz doble clic e introduce tu clave. Claude Desktop instala el binario incluido y guarda la clave como secreto.

Claude.ai (web y móvil)

El skill se ejecuta en el sandbox de ejecución de código de Claude y descarga allí la CLI para Linux la primera vez que se usa.

  1. 1. Ve a Settings → Capabilities y activa Code execution and file creation.
  2. 2. En Additional allowed domains, añade download.blackseoanalyzer.com y el dominio de cada sitio que quieras auditar. El sandbox no puede acceder a nada más.
  3. 3. Ve a Customize → Skills → + → Create skill → Upload a skill y elige el ZIP del skill.
  4. 4. Empieza un chat: "Usa el skill bseoa para auditar https://example.com." Incluye tu clave de licencia. Claude instala la CLI, ejecuta la auditoría y explica los resultados.

El sandbox se reinicia en cada conversación, así que la CLI se descarga de nuevo cada vez y el historial de rastreos no se conserva. Para un historial persistente usa Claude Desktop o Claude Code.

Team y Enterprise: primero un propietario debe activar la ejecución de código y creación de archivos, y Skills, en Organization settings → Plugins & skills. Los skills se siguen subiendo por usuario.

ChatGPT

Codex CLI

Se ejecuta en tu equipo.

Skill

Descomprime el skill en tu carpeta de skills, de modo que SKILL.md quede en skills/bseoa/SKILL.md:

~/.agents/skills/                      (macOS / Linux)
%USERPROFILE%\.agents\skills\          (Windows)

Invócalo con $bseoa, o deja que Codex lo use cuando tu prompt trate de una auditoría SEO.

Conector

codex mcp add bseoa -- bseoa mcp

ChatGPT (web, escritorio, móvil)

Los skills están en ChatGPT Work en los planes de pago.

En ChatGPT Work (planes de pago), sube el ZIP del skill en Skills y luego pide una auditoría SEO mencionando bseoa. Se está verificando si el contenedor de ChatGPT puede descargar y ejecutar la CLI; si no puede, usa Codex CLI (arriba) o espera al conector alojado.

Conector: próximamente. Ver la página del conector.

Perplexity

Perplexity para Mac (conector)

Necesita el helper PerplexityXPC, que la app ofrece instalar.

  1. 1. Primero guarda tu clave con bseoa license store <key>. El conector no tiene dónde poner una variable de entorno.
  2. 2. Ve a Settings → Connectors → Add Connector → MCP.
  3. 3.

    En la pestaña Simple, llámalo bseoa e introduce el comando:

    /usr/local/bin/bseoa mcp --db-path /Users/you/bseoa-crawl.db

    Usa la ruta absoluta; el helper no lee el PATH de tu shell. Sustituye /usr/local/bin/bseoa por la salida de which bseoa si lo instalaste en otro lugar (la skill lo instala en ~/.local/bin).

  4. 4. Activa el conector en Sources en la pantalla de inicio y pregunta: "Usa bseoa para ver qué falla en https://example.com."

Perplexity Computer (skill)

  1. 1. Abre la página Skills → Create skill → Upload a skill (el ZIP o solo SKILL.md, hasta 10 MB).
  2. 2. Sube el ZIP del skill, o solo el archivo SKILL.md que contiene.

Se está verificando que la CLI pueda ejecutarse dentro de Computer. Mientras tanto, usa Perplexity para Mac (arriba) o espera al conector alojado.

Ver la página del conector.

Grok

Grok (grok.com)

Skill

  1. 1. Ve a Skills en grok.com.
  2. 2. Sube SKILL.md del ZIP como archivo, o abre Skill Creator y pega su contenido cuando te pregunte qué debe hacer el skill.

Con él, Grok ya puede planificar e interpretar auditorías; ejecutar auditorías desde Grok llegará con el conector alojado.

Conector

grok.com/connectors → New Connector → Custom. URL próximamente. Ver la página del conector.

Prompts para probar

Audita https://example.com y dame las cinco correcciones de mayor impacto.
Revisa solo https://example.com/pricing. ¿Qué le impediría posicionarse?
Rastrea https://example.com y muéstrame cada página con la meta descripción ausente o duplicada.
¿Cómo se verán estas tres URL en Google? [urls]
Compara el rastreo de hoy con el de ayer. ¿Qué empeoró?

Solución de problemas

Todas las herramientas devuelven no_license

El conector arranca sin clave a propósito. Ejecuta bseoa license store <key> (o define BLACK_SEO_ANALYZER_KEY en el bloque env del host) y reinicia el host, ya que la licencia se comprueba una sola vez al arrancar.

"command not found" cuando un host inicia bseoa

Los hosts no usan el PATH de tu shell. Pon la ruta absoluta a bseoa en la configuración.

list_crawls está vacío después de un rastreo

Dos directorios de trabajo distintos, así que dos archivos crawl.db distintos. Pasa un --db-path absoluto.

El skill no puede descargar la CLI en un sandbox web

La lista de dominios permitidos del sandbox está bloqueando download.blackseoanalyzer.com. Añádelo donde la herramienta lo permita (Claude.ai lo permite) o usa un host de escritorio.

Los enlaces rotos son solo de linkedin.com, facebook.com o instagram.com

Esos sitios bloquean a los rastreadores a propósito. Tus enlaces están bien.

Prueba bseoa gratis durante 14 días

Todas las funciones, sin límite de páginas, sin tarjeta de crédito. Consigue una clave, añade el skill a tu asistente y pide una auditoría.