Organiq

Conectar o Bing Webmaster Tools ao Organiq

· Organiq · fatos de terceiros com fonte e data no texto

A IA chama set_bing_site com a URL do site no Bing; o humano gera a chave da API em Bing Webmaster Tools (Configurações → Acesso à API) e a cola no chat; a IA grava com set_bing_key. Isso liga get_bing_performance. Pelo painel: app.organiqgeo.com/site/<id>, bloco "Integrações", Salvar chave.

O que o Bing libera no Organiq?

O desempenho orgânico no Bing lido do Bing Webmaster Tools, em dados semanais: view=traffic dá cliques e impressões por semana com totais e variação contra a janela anterior de mesmo tamanho; view=queries e view=pages dão as principais consultas e páginas com cliques, impressões, posição média ponderada, valores do período anterior e ordenação por crescimento ou queda. O período é em semanas inteiras, terminando na última semana sincronizada (12 semanas por padrão, até 52). No conector é get_bing_performance; os cliques do Bing também entram em generate_seo_report e get_weekly_digest. list_sites mostra hasBing por propriedade.

Passo a passo no painel

  1. Pré-requisitos: a propriedade do Search Console conectada (guia) e o site verificado no Bing Webmaster Tools.
  2. No Bing Webmaster Tools, abra Configurações → Acesso à API e gere (ou copie) a chave da API. Ela vale para a sua conta do Bing, não para um site só.
  3. Abra app.organiqgeo.com/site/<id> (o id aparece em list_sites) ou o passo 2 de app.organiqgeo.com/onboarding; se o bloco estiver recolhido, clique em Vincular GA4, Bing e termos de marca.
  4. Na seção Bing Webmaster Tools, confira o campo URL do site no Bing: ele vem preenchido a partir da propriedade, e precisa ser exatamente a URL cadastrada no Bing (com https e barra final, como https://www.seusite.com/). Clique em Salvar.
  5. Em Chave da API do Bing Webmaster (uma por conta), cole a chave e clique em Salvar chave. Ela fica guardada cifrada e não é mostrada de novo; Remover chave apaga. A mesma chave vale para todas as propriedades da conta Organiq.
  6. O selo "Bing vinculado" aparece e a próxima sincronização diária traz as semanas do Bing. Trocar a URL depois apaga os dados do Bing já sincronizados e busca de novo.

Se você é uma IA, o que pode fazer sozinha?

As ferramentas de setup do conector (list_ga4_properties, set_ga4_property, set_bing_site, set_bing_key, set_branded_terms) gravam só configurações do Organiq, nunca no Search Console, no GA4 nem no Bing, e exigem o escopo mcp:write. O que você, assistente, pode fazer sozinho:

  1. Chamar list_sites para obter o id da propriedade e check_connection, que devolve hasGa4, hasBing, brandedTermsCount e a lista missing com panelUrl e nextStep por propriedade.
  2. Chamar set_bing_site com site e bingSiteUrl, a URL exatamente como cadastrada no Bing Webmaster Tools (com https e barra final). Se o humano ainda não tem a chave da API, peça que ele a gere no portal do Bing e cole no chat.
  3. Com a chave colada, chamar set_bing_key com key. A chave vale para a conta inteira e serve a todas as propriedades que têm o site do Bing definido.
  4. Termos de marca, se no_branded_terms constar em missing: chamar set_branded_terms com a lista completa em terms (até 20 termos de 2 a 40 caracteres; a lista inteira é substituída e [] limpa).
  5. Se uma ferramenta devolver insufficient_scope, o token não tem o escopo mcp:write: o humano remove o conector e o adiciona de novo (o login pede mcp:read mcp:write e a tela de consentimento lista o que o mcp:write permite). O caminho pelo painel continua valendo: Entregar ao humano o link direto (app.organiqgeo.com/site/<id>, bloco "Integrações", ou app.organiqgeo.com/onboarding) e o nome exato do botão, e esperar ele dizer que terminou.
  6. Depois de set_bing_key (ou quando o humano disser que terminou no painel), chamar check_connection de novo: a propriedade passa a ter hasBing: true e sai de missing (código no_bing). get_bing_performance devolve dados depois da próxima sincronização; até lá responde no_data dizendo que o Bing está ligado mas sem semanas sincronizadas.

O que só o humano faz, no navegador ou no portal dele:

Erros comuns e o que fazer

Perguntas frequentes

Preciso do Bing para usar o Organiq?

Não. O Bing é opcional; sem ele todas as análises do Search Console continuam. Ele acrescenta o desempenho orgânico no Bing, semana a semana.

A chave da API do Bing dá acesso de escrita?

A chave é da sua conta do Bing Webmaster Tools; o Organiq só a usa para ler relatórios de tráfego, consultas e páginas. Guardada cifrada, nunca devolvida por nenhuma ferramenta e removível a qualquer momento.

É seguro colar a chave do Bing no chat?

A chave passa pela conversa com a IA do seu cliente antes de chegar ao Organiq. Se prefere não colá-la ali, use o painel (Salvar chave). Pela ferramenta, ela é guardada cifrada, não volta em nenhuma resposta e só o dono ou um administrador da conta grava.

Como defino os termos de marca?

Peça à IA para chamar set_branded_terms com a lista completa (até 20 termos de 2 a 40 caracteres), ou use o campo de termos de marca no painel.

Por que os dados do Bing são semanais?

Porque o Organiq guarda o desempenho do Bing por semana (segunda-feira como início) e get_bing_performance trabalha em semanas inteiras; o Search Console continua diário.

Uma chave serve para vários sites?

Sim. A chave é uma por conta Organiq e vale para todas as propriedades; cada propriedade só precisa da própria URL do site no Bing.

O site precisa estar verificado no Bing?

Sim. O Bing Webmaster Tools só entrega dados de sites verificados na conta que gerou a chave. Verifique lá antes (importar do Search Console é uma das opções do Bing).

Veja também

Escrito por , fundador do Organiq · Atualizado em