A API do SEOClave

Comece em 2 minutos

1. Entre na sua conta e abra API (no menu).
2. Clique em Criar chave e copie: ela só aparece uma vez.
3. Teste (não gasta créditos):

curl https://seoclave.com/api/v1/account/ \
  -H "Authorization: Bearer sc_SUA_CHAVE"

{
  "plan": "Pro",
  "balance": 150,
  "plan_expires": "2026-12-02T14:00:00+00:00",
  "limits": { "per_minute": 10, "requests_per_day": 1000, "credits_per_day": 50 },
  "today": { "requests": 1, "credits": 0 }
}

Autenticação

Toda requisição leva o cabeçalho Authorization: Bearer sc_…. A chave nunca vai na URL (ficaria em históricos e logs) e não funciona a partir da sessão do site. Trate-a como uma senha: quem a tiver gasta os seus créditos. Você pode ter até 3 e revogar qualquer uma na hora; quando cria uma, avisamos por e-mail.

Limites por plano

Por conta, somando todas as suas chaves. São obrigatórios: protegem os seus créditos e o serviço de todos.

Toda resposta traz X-RateLimit-Limit e X-RateLimit-Remaining (deste minuto); se passar, a resposta é 429 com Retry-After em segundos. O que é recusado por limite não é cobrado.

Rotas

curl https://seoclave.com/api/v1/keywords/ \
  -H "Authorization: Bearer sc_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"mode": "ideas", "query": "advogado trabalhista", "country": "br", "limit": 50, "max_credits": 1}'

{
  "id": 812, "mode": "ideas", "cached": false, "empty": false,
  "result": { "rows": [
    { "keyword": "advogado trabalhista perto de mim", "volume": 9900, "cpc": 18.4,
      "difficulty": 31, "intent": "commercial", "trend": [ … ] }
  ] },
  "credits": 1, "balance": 149, "notices": []
}

Quanto custa

Como não queimar créditos

• Sempre use max_credits. Se o seu script montar mal uma requisição, não gasta mais do que isso.
• Peça só as linhas que vai usar. limit: 50 custa 1 crédito; 1.000 linhas, 7.
• Meça em lote. Uma lista de 60 palavras em volume custa 1 crédito; 60 requisições soltas, 60.
• Não use refresh em loops. O repetido já é grátis por 30 dias; e se atualizar antes de 24 h, devolvemos o que você tem sem cobrar.
• Guarde o id. Ler de novo /keywords/{id}/ é grátis.
• Baixe o seu limite diário em API enquanto testa.
• Diante de um 429, espere o que disser o Retry-After: tentar de novo na hora não adianta.

Erros

Sempre {"error": {"code": "…", "message": "…"}}. O code não muda: decida com ele. A message é para a pessoa: vem no idioma do cabeçalho Accept-Language (pt, en, es ou fr) ou, se você não o enviar, no idioma da sua conta.

Se você usava os nomes em espanhol

Até 11 de novembro de 2026 a API tinha rotas e campos em espanhol. Eles continuam funcionando igual, com respostas e códigos em espanhol: você não precisa mudar nada. A mensaje dos erros segue a mesma regra da message: Accept-Language, senão o idioma da sua conta, senão espanhol. Para código novo, use os nomes em inglês.

Conector MCP: Claude, Cursor e mais

MCP é o padrão aberto com o qual os assistentes de IA usam ferramentas externas. Conecte o SEOClave e a sua IA consulta o Google sozinha quando a conversa precisa: «quantas pessoas pesquisam advogado em São Paulo?», «em que posição estou para bota de couro?». Usa a mesma chave, gasta os mesmos créditos e respeita os mesmos limites (só contam as consultas, não a saudação nem a lista de ferramentas). Só gastam créditos a pesquisa de palavras (50 linhas = 1 crédito; repetir em 30 dias é grátis) e o top 10 (1 crédito); orçamento, auditoria, robots.txt, DNS, redirecionamentos e os seus projetos são grátis.

Endereço do conector: https://seoclave.com/api/v1/mcp

claude mcp add --transport http seoclave https://seoclave.com/api/v1/mcp \
  --header "Authorization: Bearer sc_SUA_CHAVE"

{
  "mcpServers": {
    "seoclave": {
      "url": "https://seoclave.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer sc_SUA_CHAVE" }
    }
  }
}

claude.ai (web e celular) e Claude Desktop: com um botão

1. No claude.ai, abra Configurações → Conectores → Adicionar conector personalizado.
2. Nome: SEOClave. Endereço: https://seoclave.com/api/v1/mcp.
3. Autenticação: entrar com OAuth, usando a identidade publicada do Claude ou o registro automático (os dois funcionam). Sem cabeçalhos.
4. Clique em Conectar: levamos você ao SEOClave, você entra e clica em Permitir. Sem copiar chaves.

ChatGPT

1. Ative o modo desenvolvedor em Configurações → Apps e conectores → Avançado (conforme o seu plano do ChatGPT).
2. Crie um conector com o endereço https://seoclave.com/api/v1/mcp e autenticação OAuth.
3. Conecte: levamos você ao SEOClave, você entra e clica em Permitir.

Outros assistentes que aceitam conectores MCP com login (OAuth) se conectam do mesmo jeito. Você vê e desconecta em API → Conexões.

Conecte com a sua IA e as suas ferramentas

• ChatGPT (GPT personalizado): em Ações, importe o esquema de https://seoclave.com/api/v1/openapi.json e escolha autenticação «API Key» tipo «Bearer» com a sua chave. O seu GPT poderá medir palavras e ver o top 10 de hoje sozinho.
• n8n ou Make: um nó HTTP Request com o cabeçalho Authorization: Bearer sc_….
• Claude e outros assistentes: com o conector MCP, a sua IA consulta o SEOClave sozinha.

import requests

r = requests.post("https://seoclave.com/api/v1/keywords/",
    headers={"Authorization": "Bearer sc_SUA_CHAVE"},
    json={"mode": "volume", "query": "sapatos\nbota de couro\nsandálias", "country": "br", "max_credits": 1},
    timeout=60)
r.raise_for_status()
for row in r.json()["result"]["rows"]:
    print(row["keyword"], row["volume"], row["cpc"])

const r = await fetch("https://seoclave.com/api/v1/keywords/", {
  method: "POST",
  headers: { Authorization: "Bearer sc_SUA_CHAVE", "Content-Type": "application/json" },
  body: JSON.stringify({ mode: "serp", query: "advogado em são paulo", country: "br", max_credits: 1 }),
});
const data = await r.json();
if (!r.ok) throw new Error(data.error.code);
console.log(data.result.organic.slice(0, 3));

Dúvidas ou falta algo? Escreva pela central de ajuda. Ao usar a API você aceita os termos.