MCP Search Console

mcp-search-console

Servidor MCP do Google Search Console multi-conta para operadores que precisam de uma superfície MCP única em vários sites ou clientes sem reiniciar o servidor.

Postura de lançamento: pacote beta, versão 0.1.3 de pyproject.toml.

Escolha seu caminho

Você é...	Comece aqui	Então
Conectando o servidor ao Claude/Codex/Cursor	docs/start-here.md	Início rápido abaixo
Auditando roteamento de contas ou proteções destrutivas	docs/architecture.md	gsc/server.py
Revisando metadados de empacotamento ou registro	pyproject.toml	server.json

Arquitetura

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  S --> M[Account manager]
  M --> F[Accounts config]
  M --> A[OAuth or service-account auth]
  S --> R[Retry wrapper]
  R --> G[Google Search Console API]
  G --> R --> S

Fluxo de solicitações

flowchart TD
  P[Operator asks for analytics or indexing data] --> T[Selected MCP tool]
  T --> A[Resolve named or default account]
  A --> B[Build authenticated GSC client]
  B --> C[Call Search Console endpoint]
  C --> D{API call succeeds?}
  D -- yes --> E[Return normalized JSON]
  D -- retryable --> F[Backoff and retry]
  F --> D
  D -- no --> G[Return error payload]

Início rápido

1. Instale o pacote.

python -m pip install mcp-search-console-multi

2. Crie a configuração de contas.

mkdir -p ~/.config/mcp-search-console
cp accounts.example.json ~/.config/mcp-search-console/accounts.json

3. Registre-o no seu cliente MCP.

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["mcp-search-console-multi"],
      "env": {
        "GSC_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-search-console/accounts.json"
      }
    }
  }
}

Ferramentas disponíveis

Grupo de ferramentas	Ferramentas	Objetivo
Roteamento de contas	list_accounts, set_default_account, reauthenticate	Inspecionar contas, alternar padrões, atualizar autenticação
Inventário de propriedades	list_properties, get_site_details	Descobrir propriedades acessíveis e permissões
Análise de pesquisa	get_search_analytics, get_performance_overview, compare_periods, get_advanced_search_analytics, get_search_by_page	Consultar dados de desempenho de pesquisa
Inspeção e sitemaps	inspect_url, batch_inspect_urls, check_indexing_issues, list_sitemaps, get_sitemap, submit_sitemap, delete_sitemap	Inspecionar indexação e gerenciar envios de sitemap

submit_sitemap e delete_sitemap ficam atrás do sinalizador destrutivo documentado em docs/start-here.md.

Prova de execução

Afirmação	Prova
O ponto de entrada do pacote é estável	mcp-search-console-multi = "gsc.server:main" em pyproject.toml
O roteamento multi-conta é de primeira classe	AccountManager() e _get_manager() em gsc/server.py
As chamadas do Search Console são repetidas	with_retry() em gsc/server.py e gsc/retry.py
A autenticação é baseada em arquivo por conta	accounts.example.json e gsc/accounts.py

Mapa do repositório

Caminho	Objetivo
gsc/server.py	Superfície de ferramentas FastMCP e normalização de respostas
gsc/accounts.py	Configuração de contas, carregamento de autenticação, construção de clientes
gsc/auth/	Implementações de autenticação OAuth e conta de serviço
gsc/retry.py	Comportamento de repetição para falhas transitórias de API
docs/start-here.md	Configuração, ambiente, validação, falhas comuns
docs/architecture.md	Mapa de componentes e ciclo de vida de execução

Validação

Verificação	Comando
Importação compila	python -m compileall gsc
Pacote compila	python -m build
Links README/docs permanecem locais	rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

Licença

MIT