SearchDock CLI

SearchDock CLI — Interface de Linha de Comando para o Google Search Console

Leia análises do Google Search Console, inspecione URLs indexadas e monitore sitemaps diretamente do seu terminal ou agente de IA.

O SearchDock é open source, roda localmente e solicita acesso somente leitura ao Google. Use o mesmo núcleo via npm, Python, MCP, um plugin para Codex ou Claude Code, ou uma skill de agente independente. O suporte ao Bing Webmaster Tools está planejado.

Configure com seu agente

Copie este prompt para o seu agente de codificação:

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 instalação

Node.js 22 ou posterior é necessário para todas as distribuições.

Pacotes: 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

O pacote Python é um launcher que contém exatamente o mesmo runtime JavaScript. Ele não possui implementação separada do Google. Se você instalar ambos os pacotes, use python -m searchdock_cli para selecionar o launcher Python explicitamente.

Instale ambas as skills para Codex no projeto atual:

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

Substitua codex por claude-code, cursor, opencode ou seu agente suportado. Adicione --global apenas para instalação entre projetos. As skills não instalam a CLI nem autorizam o acesso ao Google. Plugin, MCP e configuração manual.

Para executar a partir do código-fonte:

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

Conecte o Google Search Console

Crie um cliente OAuth Desktop app do Google no seu próprio projeto do Google Cloud, ative a API do Search Console e baixe o JSON do cliente. Consulte configuração do Google para as etapas e limites do modo de teste. Nenhuma credencial de desenvolvedor compartilhada está incluída.

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

O Google abre um fluxo de consentimento no navegador local. O SearchDock usa PKCE, valida o estado do callback e escuta apenas em 127.0.0.1. Ele solicita webmasters.readonly e mantém o token de atualização no diretório de configuração por usuário do seu sistema operacional, fora deste repositório. As credenciais são armazenadas como JSON local protegido por permissões, não criptografado pelo SearchDock. Consulte privacidade.

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 grava resultados legíveis por máquina em stdout e erros em stderr com um status de saída diferente de zero. --output salva JSON em um arquivo novo e se recusa a sobrescrever um existente. Mantenha relatórios privados fora do Git por conta própria. CSV ainda não é suportado. Para URLs contendo vírgulas, use o array urls do MCP ou a API JavaScript para inspeção em lote.

As janelas de relatório padrão são de 28 dias, terminando três dias antes de hoje no Horário do Pacífico, para permitir o processamento do Search Console. Você pode especificar datas exatas. Os dados finalizados podem ainda apresentar atraso. A paginação suporta até 100.000 linhas solicitadas, mas a API do Google retorna as principais linhas e omite alguns dados de consulta anonimizados. Linhas ausentes não provam demanda zero; impressões zero tornam a posição média sem significado.

Agentes de IA e MCP

O SearchDock fornece cinco ferramentas MCP somente leitura: searchdock_sites, searchdock_analytics, searchdock_sitemaps, searchdock_inspect e searchdock_report. Autentique localmente primeiro; as ferramentas MCP não iniciam consentimento nem alteram configurações de conta.

Adicione este servidor stdio a qualquer cliente MCP compatível:

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

Para um checkout do código-fonte, defina command como node e args como ["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]. Clientes Windows que iniciam npx.cmd por meio de um shell podem precisar de command: "cmd" e args: ["/c", "npx", "--yes", "searchdock-cli@0.1.3", "mcp"]. Use as orientações de configuração do Windows do seu cliente.

Os plugins usam a mesma versão npm fixada:

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

No Claude Code:

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

Este comando de uma etapa requer Claude Code 2.1.275+. Versões anteriores podem usar /plugin marketplace add xplormityai/searchdock-cli e depois /plugin install searchdock@searchdock --scope project.

Para skills independentes, copie tanto skills/searchdock quanto skills/searchdock-setup para o diretório de skills do seu agente. O Codex usa ~/.agents/skills/; o Claude Code usa ~/.claude/skills/. Instale a CLI separadamente. Ambas as skills estão incluídas no plugin. O repositório inclui Agent Plugins portáveis, manifestos para Codex e Claude; plugins stdio locais não são listados automaticamente em diretórios de plugins hospedados.

Você também pode instalar a skill com o instalador de skills aberto:

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

O SearchDock está publicado no Registro MCP oficial sob io.github.xplormityai/searchdock-cli. Os fluxos de trabalho de lançamento atualizam seus metadados usando GitHub OIDC.

Tanto a skill SearchDock quanto a de configuração estão publicadas no ClawHub. Suas cópias de skill usam MIT-0, conforme exigido por esse registro; este repositório e seus pacotes permanecem licenciados sob MIT.

O bundle MCPB local está publicado no Smithery. Ele requer Node.js 22+ e um perfil do Google autenticado localmente; não inclui credenciais. python scripts/build_mcpb.py empacota um dist/cli.cjs compilado. Automação de lançamento e descoberta.

O que a API do Google pode e não pode informar

Disponível	Requer a interface do Search Console ou uma exportação
Cliques, impressões, CTR, posição média	Solicitar indexação
Principais consultas/páginas e detalhamentos por data/dispositivo/país	Testar uma URL ao vivo
Desempenho exato de consultas de marca	Tabela completa de exclusões de indexação de páginas
Status de processamento de sitemaps	Ações manuais e problemas de segurança
Versão indexada pelo Google de URLs específicas	Classificação ou indexação atual garantida

O relatório do SearchDock sinaliza erros/avisos de sitemap retornados, processamento pendente e veredictos diferentes de PASS para as URLs que você inspeciona. Não é uma auditoria técnica completa de SEO e não fornece pontuações inventadas de SEO/AEO/GEO.

API 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);

O registro de provedores declara capacidades separadamente. O Bing pode ser adicionado como um adaptador sem alterar a CLI, o MCP ou o modelo de distribuição Python. Diferenças específicas do provedor devem permanecer explícitas. Consulte arquitetura.

Desenvolva e lance

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

Instruções de lançamento cobrem contas npm/PyPI, publicação confiável via OIDC, versionamento e artefatos de lançamento no GitHub. A criação de pacotes por si só não publica nada.

Desenvolvido pela Xplormity Collective. Licença MIT.