That SEO Agent

Pare de dar briefing para a IA sobre seu próprio site.

Documentação

UM ÚNICO CAMINHO DE ENTRADA, E ELE ESTÁ NA SUA MÁQUINA.

O servidor roda na sua máquina e escuta em um endereço de loopback, então conectar um cliente é um único comando, sem chave para colar e sem conta para aprovar. Clone, inicie e aponte o Claude Code ou o Cursor para ele.

git clone --depth 1 https://github.com/thatseoagent/mcp.git

Node 24 ou mais recente · pnpm · nada para se cadastrar

Procurando pelo plugin, pelo conector do claude.ai ou por uma chave de API? Eles apontavam para um servidor hospedado que não existe mais. O que está abaixo substitui todos eles.

Três comandos, do início à conexão

Clone, compile, conecte. O servidor escuta no seu endereço de loopback, então o cliente aponta para a sua própria máquina e não para nós. Não há chave para colar nem permissão para aprovar.

  1. 01 · Clone git clone --depth 1 https://github.com/thatseoagent/mcp.git Copiar Um clone raso: você quer as ferramentas, não o histórico. Tudo o que o servidor precisa está no repositório.
  2. 02 · Compile e inicie pnpm install && pnpm build && pnpm start Copiar Ele escuta em http://127.0.0.1:3737/mcp, e, se essa porta estiver ocupada, ele se recusa a iniciar em vez de silenciosamente mudar de porta e deixar seu cliente apontando para nada.
  3. 03 · Aponte um cliente para ele claude mcp add --transport http thatseoagent http://127.0.0.1:3737/mcp Copiar Claude Code mostrado. Qualquer cliente que fale HTTP MCP funciona de forma idêntica, porque o endereço é tudo o que ele precisa.

Para um cliente que aceita JSON em vez de um comando: Cursor e qualquer outra coisa que aceite uma URL MCP

{
  "mcpServers": {
    "thatseoagent": {
      "type": "http",
      "url": "http://127.0.0.1:3737/mcp"
    }
  }
}

O mesmo endereço único, na outra notação. Não há cabeçalho Authorization, porque não há nada entre seu cliente e sua própria máquina. O campo de tipo também aceita streamable-http como um alias para http, se o seu cliente insistir nisso.

Quais clientes podem alcançá-lo

Um endereço de loopback só é acessível a partir da sua própria máquina. Esse único fato decide toda a tabela: um cliente que se conecta a partir da nuvem do seu fornecedor não consegue ver o seu servidor, por mais bem que fale MCP.

  • Claude Code claude mcp add --transport http A sintaxe documentada aceita qualquer URL, incluindo uma de loopback.
  • Cursor url em mcp.json Aponte para http://127.0.0.1:3737/mcp da mesma forma que você faria com um servidor remoto.
  • Claude Desktop somente stdio Seu mecanismo local inicia um processo filho a partir de claude_desktop_config.json — comando e argumentos, sem campo para um endereço HTTP local. Seus conectores são buscados na nuvem da Anthropic.
  • claude.ai, Cowork, mobile conector do lado da nuvem A central de ajuda da Anthropic é explícita: um conector personalizado é acessado pela infraestrutura de nuvem deles, e não pelo seu dispositivo, e servidores MCP locais não estão disponíveis no Cowork ou no claude.ai.
  • ChatGPT HTTPS público exigido Uma URL de conector precisa ser acessível remotamente; um endereço localhost é recusado como inseguro.

Qualquer coisa não listada segue a mesma regra: se o cliente abre a conexão a partir da sua máquina, funciona; se ele abre a conexão a partir do servidor de alguém, não funciona.

Crie um cliente de aplicativo de desktop

No Google Cloud Console, em APIs & Services e depois em Credentials. Desktop app é o tipo que permite o redirecionamento de loopback que este login usa. Ative a Search Console API e a Google Analytics Data API no mesmo projeto.

Coloque os dois valores no .env

GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET, em um arquivo .env na raiz do servidor. O arquivo é ignorado pelo git, é lido uma vez na inicialização, e uma variável já definida no seu shell tem prioridade sobre ele.

Faça login uma vez

O comando imprime os dois escopos que ele solicita e o que deixa de funcionar sem cada um, abre seu navegador, recebe o redirecionamento em uma porta de loopback efêmera e para de escutar. Ambos os escopos são somente leitura. Execute novamente para trocar de conta.

pnpm login

O que nunca sai da sua máquina

Executar o servidor você mesmo move as partes sensíveis para o seu próprio disco. É isso que muda aqui, mais do que a licença.

Seus tokens do Google

Armazenados em um banco de dados SQLite local no diretório do próprio servidor, ignorado pelo git. Nada é transmitido para nós, porque não há "nós" no caminho da requisição mais.

Seu histórico de auditoria

Registros de sites, execuções de auditoria, leituras de métricas e um cache de resultados, no mesmo arquivo local. Ele é criado e migrado no primeiro uso e é opcional: desligue-o e todas as ferramentas sem credenciais continuam funcionando.

O socket de escuta

Ele faz bind em 127.0.0.1 e recusa requisições de origens cruzadas, então uma página web não consegue alcançá-lo. Também não há autenticação. No seu próprio laptop, essa é a troca certa; em uma máquina em que outras pessoas podem fazer login, não é.

O guia de configuração vive junto com o código

O repositório inclui um documento de configuração que leva uma máquina limpa a um servidor funcional e a um relatório completo, incluindo os passos do Google Cloud, e mapeia cada mensagem de erro comum para sua correção. Ele é escrito em três etapas e diz isso: a primeira não precisa de contas nem de chaves, e você pode parar depois dela. Ele é mantido ao lado daquilo que descreve, e é por isso que esta página o linka em vez de copiá-lo.