OrganiqAPI do Search Console × servidor MCP: qual um desenvolvedor deve usar?
· Organiq · fatos de terceiros com fonte e data no texto
Use a API do Search Console quando você escreve código que armazena ou transforma os dados: REST com OAuth 2.0, 25.000 linhas por chamada, 1.200 consultas por minuto por site. Use um servidor MCP quando um modelo (Claude, ChatGPT, Cursor) deve chamar os dados durante a conversa: o Organiq expõe 44 ferramentas por Streamable HTTP com OAuth 2.1.
O que é a API do Search Console e quais são os limites?
É a interface REST do Google para ler o desempenho de busca (endpoint Search Analytics), inspecionar URLs e listar sitemaps. Limites publicados pelo Google (developers.google.com/webmaster-tools/limits, 30 de outubro de 2026): Search Analytics, 1.200 consultas por minuto por site e por usuário, 30.000.000 por dia e 40.000 por minuto por projeto; URL Inspection, 2.000 por dia e 600 por minuto por site. Cada chamada devolve até 25.000 linhas ("batches of 25,000 rows at a time", guia da API). Os dados cobrem 16 meses (Google, 2018) e chegam com 2 a 3 dias de atraso (ajuda do Search Console). O que fica por sua conta: banco, autenticação, paginação, repetições, esquema e manutenção.
O que é um servidor MCP do Search Console?
MCP (Model Context Protocol) é o protocolo aberto pelo qual clientes de IA descobrem e chamam ferramentas. Em vez de você escrever o código da consulta, o modelo escolhe a ferramenta e os argumentos a partir da pergunta. O Google publica a API; servidores MCP do Search Console são construídos por terceiros sobre ela, o Organiq entre eles, cada um com o próprio conjunto de ferramentas, autenticação e limites. O Organiq expõe 44 ferramentas, acesso somente leitura ao Google em https://organiqgeo.com/mcp (Streamable HTTP): resumo, consultas e páginas, séries, curva de CTR, quick wins (score_opportunities), decaimento, canibalização, anomalias, previsão, tráfego de IA e relatório, com a análise feita no servidor. Autenticação OAuth 2.1 com PKCE: sem credencial, a ferramenta protegida responde 401 com WWW-Authenticate: Bearer resource_metadata=… e o cliente abre o login; 3 ferramentas funcionam sem login. Clientes sem OAuth usam API key (Authorization: Bearer org_live_…). Erros em JSON: { error: { code, message, nextStep, docsUrl } }; rate_limited traz retryAfterSeconds. Referência completa em /pt/docs.
Quando usar a API, o MCP ou os dois?
| Caso de uso | API do Search Console | Servidor MCP (Organiq) |
|---|---|---|
| Guardar o histórico no seu data warehouse | Sim: você puxa e armazena dentro das cotas | Indireto: o Organiq já armazena todo dia; as ferramentas leem desse banco |
| Perguntar em linguagem natural no Claude, ChatGPT ou Cursor | Não | Sim: o modelo chama as ferramentas na conversa |
| Pipeline automatizado ou CI | Sim | Sim, com API key (por exemplo claude -p no Claude Code) |
| Agente ou script seu chamando o Organiq | — | Sim: JSON-RPC por HTTPS com o header de API key, com qualquer SDK de cliente MCP |
| Exportar milhões de linhas cruas | Sim, em lotes de 25.000 | Não: as ferramentas devolvem análises e listas limitadas, não despejos |
| Escrever no Search Console (enviar sitemap) | Sim, pela API | Não: o acesso ao Google é somente leitura |
| Histórico além de 16 meses | Só se você armazenou antes | Sim, a partir da conexão (planos Starter e Agência) |
Como o MCP do Organiq se relaciona com a API?
O Organiq é um consumidor da API: com o escopo webmasters.readonly, sincroniza uma vez por dia as propriedades conectadas, respeitando as cotas, e grava num banco próprio. As ferramentas MCP leem desse banco, não da API: as suas perguntas não gastam cota do Google, não dependem da disponibilidade da API no momento e enxergam além dos 16 meses. Limites: dado mais recente de D-3; só as propriedades da sua conta; nada de escrita. Guia dos 16 meses: limite de histórico do Search Console.
Perguntas frequentes
Posso chamar o MCP do Organiq a partir de código, sem IA?
Sim. O endpoint é JSON-RPC sobre HTTPS (Streamable HTTP). Use um SDK de cliente MCP ou requisições HTTP com o header Authorization: Bearer e a sua API key, criada no painel.
O MCP substitui a API para exportação em massa?
Não. As ferramentas devolvem análises e listas com limite de linhas, pensadas para uma conversa. Para despejos completos, use a API do Google em lotes de 25.000 linhas.
O Organiq tem API REST própria?
Não em 30 de outubro de 2026; só o servidor MCP. O GSC Wizard oferece API REST (gscwizard.com/pricing, 30 de outubro de 2026).
Qual autenticação o servidor MCP aceita?
OAuth 2.1 com PKCE, registro dinâmico (DCR) e Client ID Metadata Document, ou API key pessoal. Tokens de acesso duram 1 hora; refresh tokens 30 dias, rotacionados a cada uso.
Preciso de um projeto no Google Cloud para usar o MCP?
Não. Você entra com a conta Google no painel do Organiq e concede acesso somente leitura; o projeto e as cotas da API são do Organiq. Para a API direta, sim: projeto próprio, credenciais e cotas por projeto.