Documentação de API e MCP
SEOforGPT Developers: construa a partir do seu app ou do seu agente
Use a REST API para integrações de software e automação. Use MCP hospedado quando quiser que Claude ou outro assistente compatível rode ferramentas do SEOforGPT por chat.
Comece aqui
Escolha primeiro o tipo de integração. Depois use o endpoint somente com o método de autenticação correto.
Criando software, scripts ou ferramentas internas
- 1. Crie uma chave de API na sua conta SEOforGPT.
- 2. Envie a chave como token Bearer a partir do seu servidor ou job.
- 3. Chame a API Pública v1 para projetos, relatórios, análises e conteúdo.
Conectando Claude ou outro cliente MCP
- 1. Adicione SEOforGPT como conector personalizado no cliente MCP.
- 2. Entre com OAuth quando o cliente pedir acesso.
- 3. Peça ao assistente para listar projetos, rodar visibilidade ou buscar relatórios.
Escolha o caminho certo
Ambos os caminhos acessam os mesmos dados do produto SEOforGPT. A diferença é se a integração é orientada por código ou por assistente.
REST API
Ideal para serviços backend, jobs de CI, dashboards internos e fluxos personalizados em que seu código controla cada requisição.
Use quando
Você precisa de rotas HTTP previsíveis, respostas JSON e autenticação por chave de API.
Primeiro passo
Crie uma chave de API e chame a URL base com autenticação Bearer.
Hosted MCP
Ideal quando um assistente deve listar projetos, rodar verificações de visibilidade, buscar relatórios ou criar rascunhos de conteúdo a partir de uma conversa.
Use quando
Seu cliente oferece suporte a MCP remoto e consegue concluir o login por OAuth.
Primeiro passo
Cole a URL no campo Remote MCP server URL do Claude.
URL base REST
https://www.seoforgpt.io/api/v1Remote MCP server URL
https://www.seoforgpt.io/mcpO que você pode fazer
As superfícies para desenvolvedores expõem o trabalho central que sua equipe já faz no SEOforGPT.
Ler contexto do projeto
Liste projetos e use a configuração salva de marca, site e concorrentes.
GET /api/v1/projectsRodar checks de visibilidade
Inicie fluxos de visibilidade com projeto salvo ou marca personalizada.
POST /api/v1/analyze/projectBuscar dados de relatório
Extraia resultados mais recentes, resumidos, completos ou brutos.
GET /api/v1/reports/latestGerar conteúdo
Crie rascunhos para blog, LinkedIn ou threads informados por busca de IA.
POST /api/v1/generate-contentRecursos
Use estes recursos quando precisar de detalhes de implementação, contexto legível por máquina ou configuração da conta.