Saiba como configurar o comportamento principal do SEO Magic: Gemini API chave, tema do site, idioma, integração plugin SEO, Autopilot, Google APIs (PRO), integração ACF (PRO) e opções de importação/exportação.
Visão geral: como as configurações são organizadas
A Configurações tela em SEO Magic é dividido em várias seções:
- Configuração Geral – comportamento núcleo plugin (Free).
- Piloto automático – automação de fundo para preencher os campos de metadados e mídia em falta (Free).
- Configurações da API do Google – configuração centralizada para serviços avançados do Google (PRO).
- Integração com o ACF – escolha quais campos ACF são usados como contexto IA (PRO).
- Regras do modelo AI (avançadas) – regras opcionais para usar diferentes modelos de IA com base em condições.
- Configuração da Importação / Exportação – backup e migrar sua configuração.
Este artigo explica cada seção e como eles trabalham juntos.
Configuração Geral (Livre)
Google Gemini API Key
Campo: Google Gemini API Key + Testar a Ligação
Objectivo: chave principal para todas as gerações de IA.
- SEO Magic usa esta chave para chamar Modelos Google Gemini.
- Sem uma chave válida, o plugin não pode gerar metadados, texto alt ou conteúdo.
- Você pode obter uma chave de Google AI Studio.
Como configurar:
- Cola a tua chave no campo.
- Clique Testar a Ligação.
- Espere pelo sucesso ou mensagem de erro.
Se o ensaio falhar:
- Verifique se a chave está completa (sem espaços extras).
- Certifique-se de que a API Gemini está habilitada para essa chave.
- Verifique se seu servidor pode fazer solicitações HTTPS de saída (algumas firewalls as bloqueiam).

Assunto do Site Principal
Campo: Main Site Topic
Uma breve descrição do que é o seu site.
Exemplo:
“Descubra, discuta e analise os melhores filmes e programas de TV.”
Este texto é enviado à IA como contexto global e ajuda o modelo:
- Compreenda seu nicho e público típico.
- Escolha ângulos e palavras-chave mais relevantes.
- Mantenha títulos e descrições alinhados com seu tópico.
Seja breve, mas específico.

Modelo padrão de IA
Campo: Default AI Model (p. ex. Gemini 2.0 Flash (Recomendado))
Este é o modelo SEO Magic irá usar quando:
- Não Regra do modelo de IA aplica-se ao conteúdo atual.
- Uma ferramenta não solicita explicitamente um modelo diferente.
Se você não tem certeza do que escolher, Flash Gemini 2.0 é um padrão sólido (rápido e de boa qualidade).

Idioma de Geração
Campo: Generation Language (p. ex. Espanhol, Inglês)
Controla a idioma de saída padrão para as gerações IA:
- Títulos, descrições, texto alt e conteúdo serão gerados neste idioma por padrão.
- Algumas ferramentas permitem que você sobreponha a linguagem no prompt, mas esta é a configuração global.
Defina isto para o idioma principal do seu site.

Integração de plug-in de SEO
Campo: SEO Plugin Integration (p. ex. Tudo em um SEO (AIOSEO), Yoast, Rank Math)
Aqui você escolhe qual plugin SEO SEO Magic deve sincronizar com:
- Apenas plugins de SEO ativos estão listados.
- SEO Magic mapeia seus campos internos (título, descrição, etiquetas sociais) para o correto meta- chaves desse plugin.
Resultado:
- Metadados gerados pelo SEO Magic aparece dentro do seu plugin SEO.
- Você pode continuar usando seu plugin de SEO UI habitual para rever ou ajustar títulos / descrições.

Procurar os Tipos de Conteúdo
Campo: Scan Content Types
Uma lista de tipos de post onde você decide qual conteúdo SEO Magic deve lidar, por exemplo:
- Correios
- Páginas
- Tipos de correio personalizados (por exemplo, “Filmes”, “Cursos”, “Produtos”, etc.)
Somente os tipos selecionados:
- Seja incluído nas métricas de cobertura no Painel.
- Aparecer nas ferramentas Posts / Metadados SEO.
- Ser digitalizado pelo piloto automático (se activado).
Se você quiser que o SEO Magic ignore certos tipos de conteúdo, basta deixá-los sem controle.

Limpeza de Dados
Campo: Delete all plugin data upon deactivation
- Quando habilitado, SEO Magic apagará seu configurações, logs e pontuações internas quando o plugin é desativado.
- Isto é… irreversível.
Se você só planeja desativar o plugin temporariamente, ou deseja manter dados históricos, deixe isso girado desligado.

Piloto automático (gratuito)
A Piloto automático a seção controla uma tarefa de fundo opcional que completa automaticamente os metadados em falta e os campos de mídia de acordo com suas regras.
Piloto automático está disponível em ambos os Livre e PRO versões.
PRO simplesmente adiciona mais ferramentas que se beneficiam de ter todos esses metadados preenchidos.
Habilitar piloto automático
Campo: Enable Autopilot
- Interruptor mestre para todas as funcionalidades do piloto automático.
- Se isto estiver desactivado, nenhuma geração de fundo será executada.
Frequência de digitalização
Campo: Scan Frequency (p. ex. Por hora)
Define quantas vezes o Autopilot verifica o site para obter conteúdo para otimizar:
- A cada hora
- Várias vezes por dia
- Uma vez por dia (dependendo das opções que você escolher)
SEO Magic depende de WordPress cron (wp-cron) ou o seu servidor cron para executar estas análises. Certifique-se de que as tarefas agendadas estão rodando corretamente em seu site.
No Envio de Imagem
Campo: On Image Upload – Generate metadata (Alt Text, Title, etc.) automatically when a new image is uploaded.
Quando ativado:
- Cada nova imagem enviada para a Media Library é processada automaticamente.
- SEO Magic gera:
- Título
- Alt Text
- Legenda
- Designação das mercadorias
usando o nome do arquivo, tópico do site e qualquer contexto disponível.
Campos de Conteúdo (Autopiloto)
Grupo de campo: Content Fields
Aqui você decide qual campos de SEO pós-nível O piloto automático está autorizado a preencher:
- Meta Título
- Meta- Descrição
- Título do Facebook
- Descrição do Facebook
- Título do Twitter
- Descrição do Twitter
Apenas os campos assinalados são gerados automaticamente.
Os valores existentes são geralmente preservados; o piloto automático foca no preenchimento faltando Campos.
Campos de Imagem (Piloto Automático)
Grupo de campo: Image Fields
Aqui você decide qual campos de mídia O piloto automático pode completar:
- Título
- Alt Text
- Legenda
- Designação das mercadorias
Novamente, apenas os campos verificados são preenchidos, e os valores existentes são respeitados.
Como o piloto automático funciona internamente
- Em cada execução agendada, o piloto automático verifica o selecionado tipos de conteúdo e encontra itens com faltando campos nos Campos de Conteúdo / Campos de Imagem que você ativou.
- Para cada item, SEO Magic prepara um prompt usando:
- A Assunto do Site Principal,
- O conteúdo atual ou informações de mídia,
- A Idioma de Geração,
- E o Modelo padrão de IA (ou um modelo de Regras de Modelo de IA, se configurado).
- Ele envia a solicitação para Gemini e salva os valores gerados nos metadados ou campos de mídia apropriados.
Você pode desligar o piloto automático a qualquer momento se preferir um fluxo de trabalho totalmente manual.

Configurações da API do Google (PRO)
Disponível na versão PRO. Ele centraliza as chaves do Google API para recursos avançados, como Auto-Linking, Backlink Audit e Site Health Audit.
Chave de API de pesquisa do Google
Campo: Google Search API Key
Usado para:
- Assistente de Ligação Automática (descobrir fontes externas e potenciais alvos de ligação).
- Auditoria de backlink (cheques de navegação seguros).
- Auditoria de Saúde do Site (pedidos da PageSpeed).
No seu projeto do Google Cloud, certifique-se de ativar:
- API de pesquisa personalizada
- API de Navegação Segura
- API de Perspectivas de Páginas

ID do motor de busca programável
Campo: Programmable Search Engine ID
- Requerente para a Assistente de Ligação Automática.
- SEO Magic usa este ID para consultar seu motor de busca programável (CSE) e encontrar links externos relevantes.

ID do Cliente Google OAuth e Segredo do Cliente
Campos: Google OAuth Client ID, Google OAuth Client Secret
Estes são necessários para o Auditoria de backlink:
- Eles permitem SEO Magic para se conectar ao seu Console de Pesquisa do Google conta via OAuth.
- O plugin recupera dados de backlink do Console de pesquisa para agrupar e analisá-lo.
Você deve adicionar um URI redirecionado como este em suas credenciais do Google Cloud OAuth:
https://your-site.com/wp-admin/admin.php?page=smg-backlink-audit
(Substituir your-site.com com seu domínio real.)
Se o URI redirecionado estiver faltando ou incorreto, o fluxo OAuth falhará.

Integração ACF (PRO)
A Integração com o ACF seção permite aos usuários PRO escolher qual Campos Personalizados Avançados deve ser lido pela IA como contexto extra.
Casos de uso típicos:
- Para um tipo de post personalizado “Pessoa”: campos como “nome completo”, “biologia curta”, “ URL do perfil social”.
- Para um tipo “Movie” ou “Produto”: campos como “Release year”, “Brand”, “Platform”, “Rating”, etc.
Principais detalhes:
- Apenas simples baseado em texto Os campos ACF estão listados (texto simples, área de texto, URL…).
- Isto mantém a luz e evita o envio de estruturas de dados complexas.
Quando você seleciona os campos para um tipo de publicação:
- SEO Magic inclui esses valores no contexto ao gerar conteúdo, metadados e texto alt.
- A IA obtém uma compreensão mais profunda e estruturada de cada item.

Regras do modelo AI (avançadas)
A Regras do modelo AI painel permite definir regras condicionais, por exemplo:
“Se o tipo de publicação for «Produto», utilizar o modelo A; se a categoria for «Notícia», utilizar o modelo B.”
- As regras são avaliadas em ordem.
- A primeira regra correspondente é usada.
- Se nenhuma regra corresponde, SEO Magic cai de volta para o Modelo padrão de IA.
Você pode deixar isso em branco (sem regras) para manter a configuração simples, ou adicionar regras mais tarde se você precisar de controle mais fino.

Configuração da Importação / Exportação
Esta secção está disponível tanto no Free como no PRO.
Exportar – Arquivo de configurações de download
- Clique Ficheiro de Configuração da Transferência para exportar sua configuração atual como um
.jsonArquivo. - Este arquivo inclui suas configurações de SEO Magic (não seu conteúdo).
Útil para:
- Fazer backup antes de grandes mudanças.
- Reutilizando a mesma configuração em vários sites.
Importar – Aplicar uma configuração salva
- Utilizar o Importar botão para enviar um
.jsonarquivo exportado anteriormente de SEO Magic. - Quando você clicar Configuração da Importação, suas configurações atuais serão sobrescrito.
Reveja sempre a tela Configurações após uma importação, especialmente se o arquivo veio de um site diferente (pode conter chaves API ou URLs específicas para esse ambiente).
