SearchDock CLI

SearchDock CLI — Interfaz de línea de comandos para Google Search Console

Lee análisis de Google Search Console, inspecciona URLs indexadas y monitorea sitemaps desde tu terminal o agente de IA.

SearchDock es de código abierto, se ejecuta localmente y solicita acceso de solo lectura a Google. Usa el mismo núcleo a través de npm, Python, MCP, un plugin de Codex o Claude Code, o una habilidad de agente independiente. El soporte para Bing Webmaster Tools está planificado.

Configuración con tu agente

Copia este prompt en tu agente de codificación:

Set up SearchDock CLI for this project using
https://github.com/xplormityai/searchdock-cli. Read its README and
skills/searchdock-setup/SKILL.md. Check Node.js 22+, reuse an existing
installation, or install the CLI from npm. Install searchdock-setup and
searchdock skills for the agent I am using, scoped to this project, and
connect the stdio MCP server if this agent supports it. Keep existing
agent configuration. For Google access, ask only for the local path to
my Desktop OAuth client JSON and guide me through read-only browser
consent. Never print credentials or tokens. Let me choose the Search
Console property, then verify the connection with a metrics request.
Tell me exactly which steps succeeded and what still needs my input.

Comandos de instalación

Se requiere Node.js 22 o posterior para todas las distribuciones.

Paquetes: npm · PyPI.

# npm
npm install --global searchdock-cli
searchdock --help

# No global installation
npx --yes searchdock-cli@0.1.3 --help

# Python; Node.js is still required
pipx install searchdock-cli
# Alternatively: python -m pip install searchdock-cli

El paquete de Python es un lanzador que contiene exactamente el mismo runtime de JavaScript. No tiene una implementación separada de Google. Si instalas ambos paquetes, usa python -m searchdock_cli para seleccionar el lanzador de Python explícitamente.

Instala ambas habilidades para Codex en el proyecto actual:

npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes

Reemplaza codex con claude-code, cursor, opencode o tu agente compatible. Agrega --global solo para instalación entre proyectos. Las habilidades no instalan la CLI ni autorizan el acceso a Google. Configuración de plugin, MCP y manual.

Para ejecutar desde el código fuente:

git clone https://github.com/xplormityai/searchdock-cli.git
cd searchdock-cli
npm ci
npm run build
node dist/cli.cjs --help

Conectar Google Search Console

Crea un cliente de aplicación de escritorio OAuth de Google en tu propio proyecto de Google Cloud, habilita la API de Search Console y descarga el JSON del cliente. Consulta configuración de Google para los pasos y los límites del modo de prueba. No se incluyen credenciales compartidas de desarrollador.

searchdock auth login --client-file /path/to/desktop-client.json
searchdock sites list
searchdock sites use sc-domain:example.com
searchdock auth status

Google abre un flujo de consentimiento en el navegador local. SearchDock usa PKCE, valida el estado de la devolución de llamada y escucha solo en 127.0.0.1. Solicita webmasters.readonly y guarda el token de actualización en el directorio de configuración por usuario de tu sistema operativo, fuera de este repositorio. Las credenciales se almacenan como JSON local protegido por permisos, no cifrado por SearchDock. Consulta privacidad.

Comandos

# Search performance and top queries
searchdock analytics --days 28
searchdock analytics --dimensions page --days 28 --json
searchdock analytics --dimensions date --start 2026-09-01 --end 2026-09-30

# Exact, case-insensitive brand queries
searchdock analytics --brand "Your Brand" --json

# Sitemaps and Google's indexed URL status
searchdock sitemaps
searchdock inspect https://example.com/

# Combined report, including only the URLs you specify
searchdock report --urls https://example.com/,https://example.com/about --json
searchdock report --output ./private-report.json

# Multiple accounts/sites
searchdock auth login --client-file /path/to/client.json --profile work
searchdock sites use https://example.com/ --profile work
searchdock analytics --profile work --site https://example.com/ --json

# Diagnostics and local credential removal
searchdock doctor
searchdock auth logout

--json escribe resultados legibles por máquina en stdout y errores en stderr con un estado de salida distinto de cero. --output guarda JSON en un archivo nuevo y se niega a sobrescribir uno existente. Mantén los informes privados fuera de Git tú mismo. CSV aún no es compatible. Para URLs que contengan comas, usa el array urls de MCP o la API de JavaScript para inspección por lotes.

Las ventanas de informe tienen un valor predeterminado de 28 días que terminan tres días antes de hoy en hora del Pacífico, para permitir el procesamiento de Search Console. Puedes especificar fechas exactas. Los datos finalizados pueden tener retraso. La paginación admite hasta 100,000 filas solicitadas, pero la API de Google devuelve las filas principales y omite algunos datos de consultas anonimizados. Las filas faltantes no prueban demanda cero; las impresiones cero hacen que la posición promedio no tenga sentido.

Agentes de IA y MCP

SearchDock proporciona cinco herramientas MCP de solo lectura: searchdock_sites, searchdock_analytics, searchdock_sitemaps, searchdock_inspect y searchdock_report. Autentícate localmente primero; las herramientas MCP no inician consentimiento ni cambian la configuración de la cuenta.

Agrega este servidor stdio a cualquier cliente MCP compatible:

{
  "mcpServers": {
    "searchdock": {
      "command": "npx",
      "args": ["--yes", "searchdock-cli@0.1.3", "mcp"]
    }
  }
}

Para una copia del código fuente, establece command a node y args a ["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]. Los clientes de Windows que inician npx.cmd a través de un shell pueden necesitar command: "cmd" y args: ["/c", "npx", "--yes", "searchdock-cli@0.1.3", "mcp"]. Usa la guía de configuración de Windows de tu cliente.

Los plugins usan la misma versión fija de npm:

# Codex CLI
codex plugin marketplace add xplormityai/searchdock-cli
codex plugin add searchdock@searchdock

En Claude Code:

/plugin install searchdock --marketplace xplormityai/searchdock-cli --scope project

Este comando de un solo paso requiere Claude Code 2.1.275+. Las versiones anteriores pueden usar /plugin marketplace add xplormityai/searchdock-cli, luego /plugin install searchdock@searchdock --scope project.

Para habilidades independientes, copia tanto skills/searchdock como skills/searchdock-setup en el directorio de habilidades de tu agente. Codex usa ~/.agents/skills/; Claude Code usa ~/.claude/skills/. Instala la CLI por separado. Ambas habilidades están incluidas en el plugin. El repositorio incluye Agent Plugins portátiles, manifiestos de Codex y Claude; los plugins stdio locales no se listan automáticamente en los directorios de plugins alojados.

También puedes instalar la habilidad con el instalador de habilidades abiertas:

npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes

SearchDock está publicado en el Registro MCP oficial bajo io.github.xplormityai/searchdock-cli. Los flujos de trabajo de lanzamiento actualizan sus metadatos usando GitHub OIDC.

Tanto la habilidad SearchDock como la de configuración están publicadas en ClawHub. Sus copias de habilidad usan MIT-0, según lo requerido por ese registro; este repositorio y sus paquetes permanecen con licencia MIT.

El paquete local MCPB está publicado en Smithery. Requiere Node.js 22+ y un perfil de Google autenticado localmente; no incluye credenciales. python scripts/build_mcpb.py empaqueta un dist/cli.cjs construido. Automatización de lanzamiento y descubrimiento.

Lo que la API de Google puede y no puede decirte

Disponible	Requiere la interfaz de Search Console o una exportación
Clics, impresiones, CTR, posición promedio	Solicitar indexación
Consultas/páginas principales y desgloses por fecha/dispositivo/país	Probar una URL en vivo
Rendimiento exacto de consultas de marca	Tabla completa de exclusiones de indexación de páginas
Estado de procesamiento de sitemaps	Acciones manuales y problemas de seguridad
Versión indexada por Google de URLs específicas	Ranking o indexación actual garantizados

El informe de SearchDock marca errores/advertencias de sitemaps devueltos, procesamiento pendiente y veredictos que no son PASS para las URLs que inspeccionas. No es una auditoría SEO técnica completa y no proporciona puntuaciones inventadas de SEO/AEO/GEO.

API de JavaScript

import { selectedContext } from 'searchdock-cli';

const { adapter, site } = await selectedContext({ profile: 'default' });
const result = await adapter.analytics(site, { days: 28, dimensions: ['page'] });
console.log(result.rows);

El registro de proveedores declara capacidades por separado. Bing se puede agregar como adaptador sin cambiar la CLI, MCP o el modelo de distribución de Python. Las diferencias específicas del proveedor deben permanecer explícitas. Consulta arquitectura.

Desarrollar y publicar

npm ci
npm run build
npm test
npm run check
python -m pip install build twine
npm run release:artifacts
python -m twine check dist/releases/searchdock_cli-0.1.3-py3-none-any.whl dist/releases/searchdock_cli-0.1.3.tar.gz

Instrucciones de lanzamiento cubren cuentas de npm/PyPI, publicación confiable OIDC, versionado y artefactos de lanzamiento de GitHub. La creación de paquetes por sí sola no publica nada.

Creado por Xplormity Collective. Licencia MIT.