Usar a ferramenta de linha de comando

O comando searcherries lê os seus dados da Searcherries em um terminal: visibilidade em IA, respostas de IA armazenadas com as respectivas avaliações, concorrentes, URLs e domínios citados, dados do Google Search Console e do Bing Webmaster Tools, tráfego de IA do GA4 e o plano de ação. Ele imprime tabelas para você ler, ou JSON para scripts e para agentes de programação com IA como Claude Code e Codex.

A ferramenta é somente leitura. Ela chama a API REST, então retorna os mesmos dados armazenados e segue as mesmas regras de plano: o plano gratuito lê projetos, o resumo, o desempenho de busca, o tráfego de IA e o plano de ação; respostas de IA, concorrentes e citações exigem Starter ou Pro, e um teste grátis ativo também vale.

Instalar

Você precisa do Node.js 20 ou mais recente. Instale a ferramenta uma vez:

npm install -g searcherries

Para usar sem instalar, coloque npx na frente de cada comando, por exemplo npx searcherries projects.

Entrar

Abra o MCP na Searcherries, vá até a aba Other clients (Outros clientes) e crie um token de acesso. Copie o token na hora; ele só aparece uma vez.
Execute searcherries login e cole o token quando ele for pedido. O token fica oculto enquanto você cola.
Execute searcherries projects. Os seus projetos aparecem com o status e as fontes conectadas.

A ferramenta confere o token antes de salvá-lo, em um arquivo que só a sua conta de usuário consegue ler. searcherries logout remove o arquivo; o token continua funcionando até você revogá-lo na página MCP. Em uma tarefa agendada ou em CI, defina a variável de ambiente SEARCHERRIES_TOKEN em vez de fazer login.

Comandos

Comando	Retorna
`projects`	Os seus projetos com status, plano, última verificação e fontes conectadas.
`summary`	Um snapshot compacto de um projeto: visibilidade em IA, perguntas, concorrentes, domínios citados, busca, tráfego de IA e conexões.
`answers`	Respostas de IA armazenadas, com o destaque dado à marca, o sentimento, os alertas e as URLs citadas.
`search`	Dados do Google Search Console ou do Bing Webmaster Tools: totais, principais consultas e páginas, oportunidades, tendências, consultas em forma de pergunta, números diários e mensais.
`competitors`	As marcas que as plataformas de IA mencionam: o ranking, uma marca em detalhe ou o histórico mensal.
`citations`	As URLs ou os domínios que as respostas de IA citam.
`traffic`	Tráfego do GA4 vindo de assistentes de IA e de AI Overviews: fontes, páginas de entrada, números diários e mensais.
`plan`	Próximos passos priorizados com evidências datadas, para quem cuida do negócio, do marketing ou de SEO.
`api`	Qualquer endpoint da API REST, impresso como JSON.
`status`	Qual token está em uso e quantas requisições ainda restam neste minuto.

Os comandos que leem um projeto recebem esse projeto como primeiro argumento: o id numérico, o nome da marca, o domínio ou parte de um deles, como acme, acme.com ou 123. Deixe-o de fora quando a sua conta tiver um só projeto. Coloque entre aspas um nome que tenha espaços.

searcherries <command> --help lista as opções de um comando e os valores permitidos. Elas correspondem aos parâmetros da referência de endpoints, escritos com hífens: --prominence-max envia prominence_max.

Exemplos

Encontre as perguntas em que as respostas de IA deixam a sua marca de fora:

searcherries answers acme --prominence-max 1

Leia as respostas negativas e as desvantagens apontadas, com o texto da resposta e a frase que justifica cada alerta:

searcherries answers acme --only-flagged --include-answer-text

Veja como um concorrente aparece e, depois, o ranking mensal:

searcherries competitors acme --competitor rival
searcherries competitors acme --dataset history

Liste as consultas do Google com muitas impressões e poucos cliques em 90 dias:

searcherries search acme --dataset opportunities --period 90d

Gere o plano de ação para um profissional de SEO em JSON:

searcherries plan acme --audience seo --json

Scripts e agentes de IA

--json imprime a resposta da API sem alterações. Os erros vão para a saída de erro (stderr), então um script que lê JSON da saída padrão nunca recebe uma mensagem de erro no lugar dele. --all lê todas as páginas de uma lista e imprime as linhas como uma única resposta.

Quando o limite de requisições é atingido, a ferramenta espera e tenta de novo, desde que a espera seja de um minuto ou menos. O código de saída informa ao script o que aconteceu:

Código	Significado
`0`	O comando funcionou.
`1`	A API ou a rede falhou, o projeto não foi encontrado ou um parâmetro foi recusado.
`2`	O comando ou uma opção foi digitado errado.
`3`	Não há login ativo, ou o token foi recusado.
`4`	O comando exige um plano Starter ou Pro.

Agentes de programação com IA podem executar a ferramenta no terminal que já usam. Peça ao agente para executar searcherries <command> --json e ler a saída, ou conecte o servidor MCP se o seu assistente for compatível com MCP; os dois caminhos leem os mesmos dados.

Privacidade

O token lê os dados da conta da Searcherries que o criou. A ferramenta só o envia para app.searcherries.com, via HTTPS. Revogue o token na página MCP se perder o computador ou se compartilhar o arquivo por engano.

O código-fonte é público no GitHub.