FlexQueries SEO MCP

Pesquisa de SEO pré-paga, backlinks, rankings, auditorias de site e visibilidade em IA para clientes de IA compatíveis.

Servidor MCP hospedado

npx add-mcp 'https://app.flexqueries.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Voltar à Documentação

Configurar o FlexQueries MCP

Conecte o FlexQueries MCP ao Claude, ChatGPT, Codex, Cursor, Antigravity, VS Code e Gemini CLI.

O FlexQueries MCP permite que clientes de IA compatíveis chamem as mesmas ferramentas com consciência de projeto disponíveis no aplicativo. Isso inclui pesquisa de palavras-chave e tendências, SERPs atuais e históricas, domínios e concorrentes, backlinks, lojas de aplicativos, Amazon, visibilidade de IA, pesquisa local e de comércio, auditorias, monitoramento de rankings, Content Studio, relatórios de projeto e dados conectados do Google Search Console e Google Analytics.

A URL do servidor MCP hospedado é:

https://app.flexqueries.com/mcp

A primeira conexão envia você pelo login do FlexQueries. Após a autorização, seu cliente MCP pode chamar as ferramentas do FlexQueries com o contexto de projeto e os escopos de conta que você aprovou.

Para o fluxo de configuração atual e um endpoint copiável, abra o guia do FlexQueries MCP.

API REST ou MCP?

Use MCP para fluxos de trabalho conversacionais com agentes. A API REST, versionada separadamente, suporta 37 operações limitadas de pesquisa/geração, além de leituras de dados salvos com escopo, jobs nativos, relatórios conectados do Google e gravações suportadas de configuração/relatórios. A REST usa uma chave de bearer do workspace, não seu token OAuth do MCP; ambas aplicam as permissões atuais do projeto e o mesmo saldo pré-pago. Leia o catálogo atual e obtenha um orçamento antes de iniciar trabalho pago.

Trabalho salvo e monitoramento de prompt exato

Use suggest_monitoring_prompts para modelos de tópico editáveis e não medidos. Palavras-chave salvas e perguntas de clientes podem fornecer entradas mais específicas. Para pesquisa fresca de dataset do ChatGPT em inglês dos EUA, chame quote_prompt_discovery, revise o preço e depois use research_prompt_questions com um idempotencyKey persistido e o teto confirmado. O enriquecimento opcional de página de busca faz uma solicitação limitada; leia o aviso de cobertura se falhar. Os valores de demanda do dataset são estimativas. Pesquisar ou adicionar uma pergunta não coleta respostas de monitoramento.

quote_prompt_monitor calcula o teto de uso atual por execução e a retenção temporária. create_prompt_monitor salva uma coleção; run_prompt_monitor inicia verificações pagas contra suas superfícies de busca selecionadas e modelos de API rotulados. Confirme o orçamento antes de uma execução manual ou autorização recorrente. Respostas da API Claude/Perplexity não são observações de busca do aplicativo de consumo; suas perguntas são limitadas a 500 caracteres.

Passe measurement para revisar entrega Standard ou Live, de uma a três amostras, busca ChatGPT natural ou forced e answerAnalysisEnabled opcional. Monitores existentes com busca forçada permanecem forçados até serem editados. O limite é de 150 verificações de prompt/mecanismo/amostra por execução. Após salvar uma coleção, chame quote_prompt_monitor com seu configId para obter um quoteToken vinculado à revisão, válido por 15 minutos. Envie esse token, o teto de autorização revisado e um idempotencyKey estável para run_prompt_monitor. Uma estimativa de configuração de inventário não é uma autorização de execução. Configurações alteradas exigem um novo orçamento.

Para rótulos de modelo opcionais, use quote_prompt_answer_analysis, verifique enabled e então aprove explicitamente analyze_prompt_monitor_answer para uma observação salva. Isso faz uma chamada limitada e sem ferramentas em todas as marcas congeladas da execução. Rótulos podem estar errados; orçamentos salvos e trechos de evidência permanecem disponíveis para revisão. Interpretações mais antigas permanecem versionadas, e uma nova versão exige uma nova ação aprovada.

Use quote_prompt_source_research antes de research_prompt_sources. Verifique enabled; interpretação opcional também precisa de interpretationEnabled. Selecione de 1 a 20 URLs públicas sem assinatura já observadas em uma execução salva própria; analyze adiciona interpretação de página com preço separado. Leia snapshots datados por meio de list_prompt_source_snapshots e get_prompt_source_snapshot e, opcionalmente, crie um rascunho privado gratuito com create_prompt_source_opportunity. Leituras e rascunhos nunca buscam páginas, chamam um modelo, enviam divulgação ou publicam alterações.

append_prompt_monitor adiciona tópicos e prompts após uma nova revisão de preço. set_prompt_monitor_prompt arquiva ou restaura uma pergunta sem excluir seu histórico. update_prompt_monitor pausa, retoma, arquiva ou altera sua frequência usando a revisão atual. get_prompt_monitor_history retorna cobertura salva e contagens de citações; get_prompt_monitor_answer retorna uma resposta completa com suas fontes. Essas leituras salvas são gratuitas. Verificações falhas e não acionadas não são observações de marcas ausentes.

update_prompt_monitor_inventory move, pausa/retoma ou arquiva/restaura uma seleção explícita de até 25 IDs de prompt; rename_prompt_monitor_topic preserva rótulos históricos de tópicos. Ambos exigem a revisão atual. Retomar/restaurar exige revisão do novo teto futuro. edit_prompt_monitor_text cria uma nova versão semântica mantendo o prompt e as respostas antigos. get_prompt_monitor_aliases e set_prompt_monitor_aliases leem/confirmam nomes de marca alternativos para verificações futuras. Esses salvamentos são gratuitos e não iniciam coleta.

get_prompt_monitor_sources agrupa a execução completa de citações salvas antes da paginação assinada e fornece IDs de respostas de apoio. get_prompt_monitor_trends retorna taxas separadas de menção escrita/citação, mudanças de período correspondente com pesos iguais e cobertura. Mudanças exigem 90% de respostas utilizáveis em ambos os períodos. reanalyze_prompt_monitor_run cria uma interpretação gratuita idempotente a partir de respostas retidas e identidades de alvo congeladas; reivindicações originais permanecem inalteradas. Evidência legada de menção escrita é desconhecida até que uma reanálise suportada exista.

list_saved_reports e get_saved_report leem snapshots de relatórios existentes. Um gerente pode usar create_saved_report_share com confirmedPublic: true e uma expiração de um a 30 dias, depois listar metadados ou revogar acesso com list_saved_report_shares e revoke_saved_report_share. Obtenha permissão do usuário antes de expor um relatório por meio de um link bearer público.

As ferramentas de monitoramento de rankings suportam configurações de fuso horário/hora do calendário e pin_rank_tracking_keywords. Auditorias de site aceitam renderização opcional de JavaScript e um ID de autorização de crawler Shopify salvo e vinculado ao domínio. A renderização altera o orçamento; credenciais permanecem no lado do servidor. Veja opções de monitoramento e pesquisa para limites e detalhes de cobrança.

Use reconcile_rank_check para até três tarefas de ranking compradas anteriormente ou respostas de ranking retidas, ou reconcile_prompt_monitor_run para até duas verificações de prompt retidas. Essas ações gratuitas usam a tarefa original e identidades de crédito. Elas nunca compram substituições. Envios desconhecidos permanecem reservados para revisão; revise um orçamento separado de dispositivo ausente somente após a reconciliação do status final.

Use MCP para um cliente de IA interativo e a API REST do cliente para scripts e integrações. Chaves REST e tokens MCP são credenciais separadas. Ambos usam o saldo do workspace do projeto selecionado e preços compartilhados. A REST oferece operações limitadas de pesquisa/geração, além de gerenciamento de projetos, jobs nativos, aprovação recorrente, webhooks de conclusão assinados, exportações, rotas salvas/planejamento e Content Studio, relatórios e configuração de monitoramento. Ela não expõe todas as ferramentas MCP. Veja a referência completa de ferramentas MCP ou baixe esquemas de descoberta.

Antes de conectar

Entre no FlexQueries e crie ou escolha um projeto. Copie a URL do servidor no campo de conexão remota / Streamable HTTP do seu cliente:

https://app.flexqueries.com/mcp

Conexões hospedadas usam OAuth baseado em navegador. Você não precisa criar uma chave de API ou inserir um ID de cliente OAuth ou segredo. Aprove a conta FlexQueries que pretende usar e retorne ao seu cliente para habilitar suas ferramentas. Taxas do cliente são separadas do uso do FlexQueries.

Um cliente autorizado pode usar apenas projetos aprovados dentro das permissões do workspace dessa conta. Ele não recebe acesso direto ao banco de dados ou credenciais do Google. Novas aprovações de conexão padrão para leituras de dados salvos, com pesquisa e gravações desativadas. Para fluxos de trabalho completos de SEO, escolha Habilitar fluxo completo para selecionar pesquisa paga, alterações de trabalho salvo e acesso a todos os projetos atuais e futuros no workspace. Use isso apenas para um cliente em que você confia, revise os limites de gastos e selecione Autorizar. Você pode, em vez disso, manter acesso somente leitura ou escolher projetos específicos. Edite permissões e limites ou revogue acesso em Configurações → Clientes MCP conectados.

O FlexQueries verifica o acesso atual antes de uma ferramenta iniciar e novamente antes de retornar resultados privados. Remover acesso ao projeto, desativar gravações ou revogar uma conexão pode reter uma resposta que já estava sendo preparada. Trabalho concluído antes da revogação permanece salvo e mantém sua cobrança normal; a revogação não reverte esse trabalho. Inspecione o histórico salvo ou o ID de operação original após restaurar o acesso, em vez de comprar uma substituição. Listas de projetos também verificam acesso a cada projeto retornado.

Para uma instância auto-hospedada, substitua esta URL pela URL /mcp da sua instância e use sua autenticação configurada. Clientes em nuvem, como conectores remotos do Claude e ChatGPT, precisam de um endpoint publicamente acessível; uma URL localhost no seu computador não funcionará para eles.

Claude Desktop, Claude.ai e Cowork

Abra Personalizar → Conectores.
Selecione + → Adicionar conector personalizado e nomeie-o como FlexQueries.
No campo de URL do servidor MCP remoto, cole https://app.flexqueries.com/mcp e selecione Adicionar.
Selecione Conectar se solicitado. Complete o login no navegador do FlexQueries e aprove o acesso.
Retorne à sua conversa, habilite o FlexQueries no menu Conectores e escolha quais ferramentas o Claude pode executar.

Contas gratuitas têm um slot de conector personalizado. No Team e Enterprise, um proprietário da organização deve adicionar o conector primeiro. Conectores remotos usam a nuvem da Anthropic, inclusive no aplicativo de desktop. Veja o guia de conectores personalizados do Claude.

Para um passo a passo com capturas de tela e uma primeira execução de pesquisa, leia o guia de configuração de SEO para Claude.

Claude Code

Com o Claude Code instalado, execute:

claude mcp add --transport http --scope user flexqueries https://app.flexqueries.com/mcp

Inicie ou reinicie o Claude Code, execute /mcp, selecione flexqueries e autentique. Complete o login no navegador, retorne ao Claude Code e verifique o status da conexão com /mcp. O escopo de usuário compartilha a conexão entre seus projetos; use o escopo local se ele deve se aplicar apenas ao repositório atual. Veja o guia MCP do Claude Code.

ChatGPT

Abra Configurações → Segurança e login e habilite o Modo desenvolvedor, se disponível para sua conta e workspace.
Abra Plugins, selecione o botão de mais e insira FlexQueries como nome, com uma descrição como “ferramentas de pesquisa e projeto de SEO”.
Em Conexão, escolha um endpoint público e insira https://app.flexqueries.com/mcp.
Crie a conexão e complete o login no navegador do FlexQueries. Revise as ferramentas descobertas.
Inicie uma nova conversa e adicione o FlexQueries no menu de ferramentas.

Após o FlexQueries lançar novas ferramentas, use Atualizar na conexão em Plugins e inicie uma nova conversa. Veja o guia de conexão da OpenAI.

Codex CLI

Com o Codex CLI instalado, execute ambos os comandos:

codex mcp add flexqueries --url https://app.flexqueries.com/mcp
codex mcp login flexqueries

Aprove o acesso no navegador. Inicie uma nova sessão do Codex e execute /mcp para verificar a conexão. codex mcp list também mostra servidores configurados. Veja o guia MCP da OpenAI.

Codex Desktop e extensão IDE

No aplicativo de desktop, abra Configurações → Servidores MCP. Na extensão IDE do Codex, abra o menu de engrenagem → Servidores MCP.
Selecione Adicionar servidor, nomeie-o como FlexQueries e escolha Streamable HTTP.
Cole https://app.flexqueries.com/mcp no campo de URL e salve.
Reinicie o servidor ou a extensão, selecione Autenticar e complete o login no navegador do FlexQueries.
Inicie uma nova sessão e verifique se o FlexQueries está habilitado.

O CLI, o aplicativo de desktop e a extensão IDE compartilham configuração no mesmo host. Se você já adicionou o FlexQueries com o CLI, use essa conexão existente. Veja o guia MCP da OpenAI.

Cursor

Merge esta entrada em mcpServers no ~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json em um único projeto. Preserve quaisquer servidores existentes:

{
  "mcpServers": {
    "flexqueries": {
      "url": "https://app.flexqueries.com/mcp"
    }
  }
}

Salve, habilite o FlexQueries nas configurações de MCP do Cursor e conclua o login no navegador quando solicitado. Inicie um chat com o Agent e confirme que as ferramentas estão disponíveis. Consulte o guia de MCP do Cursor.

Google Antigravity

No painel do agente da IDE, abra … → MCP Servers → Manage MCP Servers → View raw config.
Mescle a configuração abaixo em mcpServers, preservando as entradas existentes, e salve.
Atualize a lista de servidores e habilite flexqueries. O Antigravity descobre o OAuth do FlexQueries automaticamente; conclua o login no navegador quando solicitado.
Volte ao agente e verifique se as ferramentas do FlexQueries estão habilitadas. Na CLI do Antigravity, /mcp abre o gerenciador para status da conexão e recarregamento.

{
  "mcpServers": {
    "flexqueries": {
      "serverUrl": "https://app.flexqueries.com/mcp"
    }
  }
}

As versões atuais do Antigravity usam ~/.gemini/config/mcp_config.json globalmente ou .agents/mcp_config.json por workspace. Use o arquivo aberto pela sua versão instalada. O Antigravity exige serverUrl, não url ou httpUrl; nenhuma credencial OAuth manual é necessária para o FlexQueries. Consulte o guia de MCP do Google Antigravity.

VS Code

Abra a Paleta de Comandos e execute MCP: Add Server.
Escolha HTTP, cole https://app.flexqueries.com/mcp, nomeie como flexqueries e escolha Workspace ou Global.
Inicie o servidor, aprove a confiança e conclua o login do FlexQueries no navegador quando solicitado.
Abra o chat de IA do seu editor no modo Agent e habilite o FlexQueries por meio de Configure Tools.

Como alternativa, mescle esta entrada em .vscode/mcp.json. Para configuração global, execute MCP: Open User Configuration:

{
  "servers": {
    "flexqueries": {
      "type": "http",
      "url": "https://app.flexqueries.com/mcp"
    }
  }
}

O VS Code usa servers neste arquivo, não mcpServers. Consulte o guia de MCP do VS Code.

Gemini CLI

Mescle esta entrada em mcpServers no ~/.gemini/settings.json ou no .gemini/settings.json do seu projeto, mantendo outras configurações e servidores:

{
  "mcpServers": {
    "flexqueries": {
      "httpUrl": "https://app.flexqueries.com/mcp"
    }
  }
}

Inicie ou reinicie o Gemini CLI e execute /mcp auth flexqueries, aprovando o login no navegador. Use /mcp list para verificar a conexão e as ferramentas. O Gemini CLI usa httpUrl para Streamable HTTP. Consulte o guia de MCP do Gemini CLI.

Verifique sua conexão

Envie este prompt após a configuração:

Use FlexQueries whoami to verify my account, then list_projects to show my projects and their IDs. Do not run paid research yet.

Essas verificações não usam saldo do FlexQueries. Use um ID de projeto retornado para ferramentas subsequentes. Conecte o Search Console ou o GA4 no painel desse projeto antes de solicitar seus dados primários. A página Conectar um agente de IA (com login) lista as ferramentas atualmente registradas; seu cliente também pode ler o esquema atual de entrada e saída de cada ferramenta durante a descoberta.

Cobrança e permissões

O FlexQueries não tem assinatura nem taxa por assento. Novas contas elegíveis recebem US$ 1 em saldo inicial, e você pode adicionar créditos em Billing quando precisar de mais. O Search Console, relatórios conectados do GA4 e leituras de dados de projetos armazenados não usam seu saldo do FlexQueries. Taxas do cliente de IA ou do provedor de modelo são separadas.

O guia de cobrança explica retenções temporárias de saldo, trabalhos com falha ou parciais, recarregamentos e impostos no checkout. Um resultado válido adquirido sem correspondências ainda pode ser cobrável; dados ausentes não significam automaticamente que a operação falhou.

Chamadas MCP medidas, incluindo pesquisa de dados, briefs de conteúdo gerados e trabalhos de auditoria, gastam do mesmo saldo que o aplicativo. O servidor reserva saldo disponível suficiente antes de o trabalho pago do provedor começar e ajusta o custo final com base no uso. Se o saldo disponível não cobrir a solicitação, a chamada é interrompida antes de esse trabalho começar. Uma chamada pode gerar cobrança quando seu agente a invoca; ela não abre uma tela separada de confirmação do aplicativo. Defina as preferências de confirmação de ferramentas do seu agente e use o estimador de preços para planejar a carga de trabalho.

Limites de workspace, membros e projetos se aplicam junto com os limites de conexão MCP. Os limites de REST são separados. Deixe o recarregamento automático desligado se a carteira financiada deve ser o teto rígido de financiamento. Trabalhos recorrentes podem gastar depois, então confirme o escopo, o teto e a frequência antes de habilitá-los.

Controles de conexão

Aprove projetos selecionados (ou todos os projetos atuais/futuros), pesquisa paga e alterações de trabalho salvo/configuração separadamente. A permissão de pesquisa não concede gravações salvas. Iniciar um trabalho ainda exige a função de workspace relevante, autoridade no projeto e saldo disponível. Os controles são compartilhados entre todas as concessões OAuth para o mesmo cliente, usuário e workspace; autorizar outra conexão para esse cliente não redefine os gastos.

O consentimento identifica o cliente registrado e o workspace selecionado antes da aprovação. A recomendação de fluxo completo é opcional; as permissões não são habilitadas sem sua aprovação. As listas de configurações podem carregar conexões e projetos adicionais. Cancelar descarta edições de permissão não salvas. Uma solicitação de conexão com falha pode ser repetida, e recusar não exige um formulário de gasto válido.

Novas políticas mostram US$ 10 por ação, US$ 20 por dia UTC e US$ 100 por mês UTC como padrões editáveis, mas a pesquisa fica desativada até ser aprovada. Você pode adicionar um teto vitalício. Cobranças liquidadas e retenções ativas contam para os limites. Reduzir um teto ou revogar uma conexão interrompe novos envios, não a liquidação de trabalhos já aprovados. Filhos em segundo plano e agendamentos patrocinados por MCP permanecem sujeitos à política da conexão de origem. Conexões existentes mantêm seu acesso anterior sem novos tetos até serem editadas ou reautorizadas; revise-as em Settings.

A admissão MCP é limitada a 60 chamadas por cliente/minuto, 120 por workspace/minuto e duas chamadas ativas por cliente. As cotas de infraestrutura se aplicam também a chamadas gratuitas. Os limites não substituem as próprias configurações de confirmação do cliente de IA.

Inícios e arquivos seguros para repetição

Persista idempotencyKey (16–128 letras, números, hífens ou sublinhados) antes de run_site_audit, run_rank_check, run_aio_monitor, run_prompt_monitor, research_prompt_questions, create_local_review_search ou create_merchant_product_search, e antes de criar/atualizar/arquivar/restaurar projetos. Clientes externos devem fornecê-lo. Reutilize a identidade e as entradas exatas após uma resposta perdida. O _meta.operationId do recibo pode ser lido com get_agent_operation na mesma conexão; isso nunca inicia trabalho substituto. As ferramentas nativas de status/histórico retornam resultados salvos. A retenção de payload é de sete dias; uma identidade expirada não se torna executável novamente.

Repetições e leituras de recibos verificam novamente as permissões atuais de workspace, projeto e conexão. Inícios interrompidos podem recuperar um reconhecimento salvo de trabalho nativo sem enviar novamente. Se não houver reconhecimento confiável, a tentativa se torna indeterminate: inspecione os trabalhos salvos antes de aprovar uma substituição. Um reconhecimento confirma o trabalho salvo, não sua conclusão bem-sucedida. Falhas registradas permanecem falhas mesmo que seu payload de resposta não seja mais retido.

create_project, update_project, archive_project, restore_project e list_archived_projects exigem função de gerenciamento e permissões de conexão apropriadas; o gerenciamento de projetos exige acesso a todos os projetos. Pelo menos um projeto ativo deve permanecer. get_google_connections fornece links seguros de painel para consentimento humano, não tokens. query_analytics aceita entradas limitadas de data/métrica/dimensão/paginação e preserva células ausentes/sinalizadores de privacidade.

export_saved_report retorna um PDF base64, DOCX ou CSV de uma tabela a partir de um snapshot existente, sem atualização paga. Sua resposta inclui tipo MIME, nome do arquivo, tamanho em bytes, data do snapshot e seções omitidas. Os downloads são limitados a 700 KB; seções legadas derivadas do Google são excluídas porque o snapshot salvo não tem proveniência de conexão. Use exportações do painel para arquivos maiores.

Ferramentas de planejamento e monitoramento

O MCP pode organizar Pages e alvos de palavras-chave salvos, vincular briefs/Opportunities existentes, ler resultados orgânicos e referências de IA, gerenciar controles de monitoramento suportados, registrar/aprovar/verificar propostas, configurar entrega de relatórios aprovados e processar importações de CSV somente persistência. Isso usa as concessões atuais do projeto. O acesso de visualizador permite leituras salvas, não trabalho pago ou edições. Consulte fluxos de trabalho de projeto e acesso ao workspace.

O Competitor Watch fornece quote_competitor_watch, create_competitor_watch, update_competitor_watch, run_competitor_watch, set_competitor_watch_active, get_competitor_watch e get_competitor_watch_run. Cite o escopo exato primeiro; criação/início exige o teto confirmado. O monitoramento semanal é opcional e tem um teto mensal separado. Ferramentas de leitura/histórico não atualizam a pesquisa. Descobertas do painel podem ser salvas em Opportunities ou descartadas.

A pesquisa guiada de oportunidades fornece get_opportunities, quote_opportunity_research, start_opportunity_research e get_opportunity_research. Cite usando projectId, budgetCredits (1.000 créditos = US$ 1; zero significa somente dados salvos; máximo 10.000) e um focus opcional de balanced, content, links, ai ou local. Mostre as verificações retornadas, a estimativa, a retenção temporária e os avisos ao usuário antes de solicitar aprovação. Inicie com o quoteKey exato, teto, foco e um UUID estável idempotencyKey. Após um erro de rede, reutilize essa chave; consulte o runId salvo em vez de iniciar outro trabalho pago.

O trabalho reutiliza evidências salvas do projeto, compra apenas pesquisa limitada aprovada e retém seus resultados em Opportunities. O uso bem-sucedido é liquidado da retenção; o restante é liberado. Pesquisas vazias válidas podem custar créditos, verificações indisponíveis não são recompradas automaticamente e a medição primária exige acesso correspondente ao Google. O Flex AI Agent integrado pode ler, citar e verificar o progresso, mas não pode iniciar uma retenção de pesquisa separada dentro de sua autorização de gasto de chat; aprove esse trabalho em Opportunities ou com o fluxo MCP externo dedicado.

Leituras compartilhadas de resultados do Google são limitadas a 10 por workspace por minuto e validam o acesso atual à propriedade conectada, inclusive antes de retornar relatórios privados em cache. Importações de CSV não enriquecem métricas nem iniciam verificações de classificação. Uma verificação de proposta confere a versão aprovada em uma página pública limitada; ela não edita o site nem estabelece causalidade de receita. Os destinatários de relatórios devem confirmar antes da entrega e não ganham acesso interativo ao projeto.

A conexão do Search Console usa acesso somente leitura ao Google. Isso não torna todo o servidor MCP somente leitura: os agentes também podem salvar palavras-chave e iniciar trabalhos suportados em projetos autorizados.

Perguntas sobre a conexão do Search Console

Posso conectar o Google Search Console especificamente ao Claude Code? Sim. Use o comando de configuração do Claude Code acima, conclua a autenticação no navegador e selecione um projeto com uma propriedade do Search Console conectada. O FlexQueries gerencia o aplicativo OAuth do Google, então você não precisa do seu próprio projeto no Google Cloud.

Este é um servidor MCP do Google Search Console que eu instalo sozinho? Não. https://app.flexqueries.com/mcp é um servidor remoto hospedado. Adicione-o a um cliente MCP compatível e faça login; não há servidor local do Search Console nem arquivo de credenciais para manter.

Ferramentas disponíveis

O FlexQueries MCP expõe ferramentas para fluxos de trabalho de pesquisa de SEO:

Pesquise palavras-chave com volume, dificuldade, CPC, intenção e demanda disponível em busca com IA.
Expanda o fraseado de pesquisa com o Google Autocomplete.
Compare tendências de palavras-chave, regiões, padrões de público e pesquisas relacionadas ou em alta.
Inspecione os resultados orgânicos atuais do Google e compare snapshots históricos disponíveis do SERP.
Encontre linhas exatas de palavra-chave, página, posição, volume, CPC, intenção e tráfego para um domínio ou página.
Compare concorrentes de SERP, lacunas de domínio, páginas ou pastas exatas e tráfego em um conjunto de alvos fornecido.
Inspecione tecnologias de domínio e sinais públicos de registro.
Pesquise empresas locais perto de uma coordenada, busque resultados do Maps ou Local Finder, inspecione perfis de empresas, leia o Google Business Q&A e execute consultas de avaliações.
Liste palavras-chave salvas de um projeto FlexQueries.
Salve palavras-chave úteis de volta no FlexQueries.
Inicie auditorias de site, verifique o status delas e inspecione problemas de página.
Compare a visibilidade da marca, pesquise prompts em modelos de IA suportados, leia citações e falhas parciais, gerencie monitores de visibilidade agendados e inspecione fontes do Google AI Mode.
Crie e configure rastreadores de posição, gerencie palavras-chave, estime custos, inicie verificações e leia posições e histórico salvos.
Resuma a pegada orgânica de um domínio.
Encontre palavras-chave para as quais um domínio já está classificado.
Verifique resumos de backlinks, redes de referência, lacunas de links de páginas exatas e histórico de backlinks.
Descubra listagens da Apple App Store e do Google Play, métricas de aplicativos, palavras-chave de classificação, concorrentes e interseções de palavras-chave.
Pesquise a demanda de palavras-chave da Amazon, pesquisas relacionadas, classificações de ASIN, concorrentes e interseções de produtos.
Pesquise resultados de produtos suportados da Amazon e do Google Shopping, incluindo trabalhos assíncronos de resultados de produtos.
Pesquise no Bing, Google News, Imagens, Eventos, Datasets e YouTube onde a superfície de pesquisa selecionada for suportada.
Leia o desempenho primário do Google Search Console (cliques, impressões, CTR, posição).
Inspecione o status de indexação, rastreamento e canônico para URLs específicas (até 10 por chamada).

Conteúdo, análises e trabalho contínuo

Content Studio: leia briefs, clusters de palavras-chave e sugestões de links internos; gere um brief pago informado por SERP; pontue e salve um rascunho; aplique tags de cluster; ou exclua um brief.
Análises e relatórios: leia totais conectados do GA4 e páginas de destino sem cobrança de uso do FlexQueries, além de relatórios de projeto que combinam dados de auditoria, posição, Search Console e GA4.
Pesquisa de domínio: acesse tabelas paginadas de palavras-chave e principais páginas, concorrentes, lacunas de conteúdo, estimativas de tráfego e histórico de visibilidade.
SERP Intelligence: analise lotes de palavras-chave, inspecione lacunas on-page e solicite capturas de tela de SERP suportadas.
Palavras-chave salvas: navegue pela lista completa, edite tags, remova palavras-chave e atualize métricas.
Verificações recorrentes: crie, atualize, pause e execute monitores de posição ou visibilidade de IA; gerencie agendamentos de auditoria e auditorias salvas. Criar um agendamento permite execuções pagas futuras, então combine o escopo e a frequência primeiro.

O Flex AI Agent integrado usa as mesmas ferramentas vinculadas ao projeto. Administração de conta, adição de fundos e consentimento da conta do Google permanecem no painel. Gerencie clientes autorizados em Configurações → Clientes MCP conectados, onde cada conexão pode ser revogada imediatamente.

Lendo resultados corretamente

As ferramentas retornam dados estruturados junto com texto legível por modelo. Ferramentas de workspace com suporte a serviço colocam seu resultado completo sob data; ferramentas de pesquisa existentes mantêm seus campos nomeados documentados. Um objeto meta identifica o projeto e vincula de volta ao painel. O cliente pode descobrir o esquema de entrada e saída de cada ferramenta por meio do MCP.

A dificuldade de palavra-chave (KD) mede a dificuldade de classificação orgânica de 0 a 100. A concorrência de publicidade é uma métrica separada de pesquisa paga e não substitui a KD. Métricas ausentes não estão disponíveis, não são zero pesquisas ou classificações fáceis.

O Verificar métricas de palavras-chave do painel, REST keywords.metrics e MCP get_keyword_metrics retêm cada frase solicitada. Em países suportados com banco de dados primário, suas citações incluem um fallback de volume em lote para frases sem volume relatado. Estimativas ausentes permanecem nulas; um zero fornecido permanece zero. A concorrência de publicidade não é KD orgânica. Outros países suportados podem fornecer volume sem KD ou intenção.

O MCP aceita até 700 frases por consulta. Ele verifica a cobertura antes de armazenar em cache o resultado e mantém o máximo citado antes de chamadas pagas. Cada linha de resultado inclui check_status. Um lote falho ou não verificado não é um resultado sem dados bem-sucedido. A reutilização de cache fresco não adiciona nova cobrança de consulta. Fluxos de trabalho de palavras-chave locais e rastreamento de posição usam volume local com KD nacional onde suportado; eles não substituem volume nacional por volume local ausente.

As execuções de palavras-chave do painel agora salvam suas configurações de entrada e resultados. Abra um resultado salvo para revisá-lo sem gastar créditos, ou escolha Atualizar resultados após revisar a citação atual. Várias frases exatas são executadas como um lote. Várias frases de descoberta abrem abas de ideias separadas marcadas como Não executado até você iniciá-las. Verificações opcionais de volume de IA têm seu próprio resultado e podem ser repetidas sem repetir a pesquisa base bem-sucedida.

Países e campos legíveis

Use countryCode com um código ISO de duas letras suportado, como US, GB ou DE, em ferramentas de pesquisa baseadas em país. Omita-o para usar o padrão de mercado do projeto dessa ferramenta. Para um lote de consultas, defina o país em cada consulta ou semente. Idiomas permanecem códigos curtos como en ou de. Maps e Local Finder usam near.latitude, near.longitude e near.zoom opcional (4–18), não um raio de distância. Zoom maior estreita a área; zoom omitido usa 17 para Maps ou 9 para Local Finder. Pesquisa de diretório de empresas e Google Business Q&A têm entradas de raio separadas. Algumas ferramentas têm cobertura de mercado mais estreita, que validam antes de iniciar a pesquisa.

Resultados de projeto, rastreador e palavras-chave salvas incluem campos legíveis country e countryCode. Entradas e campos de saída numéricos mais antigos locationCode permanecem disponíveis para clientes existentes. Ao fornecer ambos os identificadores, eles devem se referir ao mesmo país.

get_backlinks_profile aceita grouping: "strongest_per_domain" (o padrão) ou "all_links". O alias antigo mode permanece suportado. Resultados de empresas locais, SERP local, Q&A e classificação de domínio usam campos FlexQueries planos como reviewCount, rank, searchVolume e estimatedTraffic; eles não retornam envelopes de resposta do fornecedor. Valores ausentes permanecem nulos.

Pesquisas de produtos e avaliações retornam IDs de trabalho FlexQueries começando com job_. Passe esse ID inalterado para a ferramenta de resultado correspondente. IDs de trabalho salvos mais antigos ainda funcionam, e visualizar um resultado salvo concluído não reinicia a pesquisa nem cobra novamente.

Links de captura de tela de SERP usam o domínio FlexQueries e permanecem disponíveis por até 90 dias. Abra-os enquanto estiver conectado a uma conta com acesso ao projeto. Um link de captura de tela não concede acesso aos dados de outro workspace.

Siga hasMore e nextPage / nextOffset para palavras-chave salvas e linhas de auditoria. Mantenha filtros e o ID de auditoria retornado inalterados ao paginar. Uma primeira página retornada não é o relatório completo. Ferramentas de pesquisa do Search Console e do fornecedor também expõem seus próprios campos de paginação.

Uma verificação iniciada retorna um identificador de trabalho, não pesquisa concluída. Leia get_rank_tracker, get_aio_monitoring ou get_audit_status para acompanhar seu estado. Snapshots anteriores podem permanecer disponíveis enquanto um novo trabalho é executado. Preserve datas e configurações de mercado, distinga estimativas de tráfego do fornecedor de Analytics primário e trate métricas ausentes ou respostas de modelo com falha como indisponíveis, não como zero.

O que fazer após a configuração

Uma vez que o FlexQueries MCP esteja conectado, use os guias de fluxo de trabalho do agente para trabalhos de SEO focados.

Comece com um fluxo de trabalho focado em vez de pedir ao seu agente para "fazer SEO" de forma ampla.

Use configuração de projeto de SEO para capturar seus objetivos de SEO e contexto do site em um workspace local.
Use coach de SEO se você é novo em SEO ou não tem certeza de qual fluxo de trabalho executar primeiro.
Use pesquisa de palavras-chave para descobrir oportunidades de palavras-chave.
Use panorama competitivo para mapear um mercado antes de escolher concorrentes ou páginas.
Use análise de concorrentes para estudar um concorrente.
Use agrupamento de palavras-chave para transformar palavras-chave em grupos de páginas.
Use prospecção de links para encontrar prospects de divulgação para um ativo linkável.

Solução de problemas

Cada conexão externa pode executar duas ferramentas ao mesmo tempo. Rajadas curtas esperam até dez segundos por uma vaga; esperar não compra pesquisa. Se a conexão permanecer ocupada, aguarde alguns segundos antes de tentar novamente. Limites de taxa de solicitação ainda se aplicam ao cliente e ao workspace; não abra conexões extras para contorná-los.

Permissões e limites de gastos são verificados novamente após uma chamada enfileirada ser admitida. Cancelar uma chamada em espera não inicia pesquisa. Se uma chamada paga for interrompida ou seu resultado for incerto, verifique o trabalho original ou o resultado salvo antes de solicitar novo trabalho pago; uma solicitação de substituição pode incorrer em outra cobrança.

Citações aceitam o idempotencyKey opcional mostrado em seu esquema de entrada. Mantenha a chave de idempotência necessária inalterada ao verificar ou retomar uma operação aceita.

Se seu cliente não conseguir conectar, verifique se a URL do servidor é exatamente https://app.flexqueries.com/mcp.

Se nenhuma ferramenta aparecer, atualize ou reinicie a conexão, complete a autenticação, habilite suas ferramentas e inicie um novo chat. Um cliente pode armazenar em cache uma lista de ferramentas mais antiga.

Se a autorização falhar, desconecte o servidor FlexQueries no seu cliente, adicione-o novamente e repita o fluxo de login.

Se o navegador concluir a aprovação, mas um callback 127.0.0.1 ou localhost disser que recusou a conexão, o callback pertence ao seu cliente MCP local, não ao FlexQueries. Mantenha o cliente em execução, inicie Autenticar ou seu comando de login MCP novamente a partir desse cliente e termine o novo fluxo do navegador sem reutilizar uma URL de callback antiga. Callbacks locais não podem ser concluídos em um computador diferente, um shell headless ou após o cliente fechar seu listener temporário.

Se uma ferramenta lançada recentemente estiver ausente, atualize as ferramentas em cache do servidor ou remova e adicione novamente a conexão, depois inicie uma nova conversa. A página IA e MCP conectada é o catálogo atual.

Se seu agente não conseguir encontrar um projeto, peça para listar projetos FlexQueries primeiro e use o ID de projeto retornado em chamadas de ferramenta posteriores.

Dados estruturados

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://flexqueries.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Docs",
      "item": "https://flexqueries.com/docs"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Set up FlexQueries MCP",
      "item": "https://flexqueries.com/docs/mcp"
    }
  ]
}