DocumentaçãoAPI e MCP

Primeiros passos

Crie uma chave, faça a sua primeira chamada e leia as respostas.

Tudo o que você faz no semchat, a partir do seu próprio código (a API) ou do seu assistente de IA (MCP): os seus sites, a análise deles, planos de ação, palavras-chave, concorrentes, backlinks, documentos, tarefas agendadas e o chat do semchat. As mesmas ações do aplicativo, pelos mesmos preços.

Obter uma chave

  1. 1Abra Definições → API e MCPNo seu espaço de trabalho, no semchat. Só o proprietário e os administradores criam e revogam chaves.
  2. 2Crie uma chaveDê um nome a ela e depois copie: ela só aparece uma vez.
  3. 3Revogue a chave se ela vazarRevogar, na mesma aba: a chave para de funcionar na hora.
Uma chave age sobre todo o espaço de trabalho. Guarde-a em um servidor, nunca em um site ou aplicativo público.
Definições › API e MCP: as chaves, o servidor MCP e a configuração para cada assistente

Autenticação

Toda requisição leva a chave no cabeçalho Authorization: Bearer (ou X-API-Key). A URL base é https://app.semchat.io/api/v1. Os corpos e as respostas são em JSON.

curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"

Sem uma chave válida, a resposta é um 401: veja Erros e limites.

Um primeiro site

Crie um site e inicie a análise dele na mesma chamada. A análise é cobrada; needs_credits indica quando os créditos não foram suficientes para pagá-la.

curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'

Depois, leia o plano de ação dele com Listar as tarefas, ou pergunte ao chat sobre ele com Enviar uma mensagem em um site.

Respostas

  • Uma resposta é { "data": … }: um objeto, ou uma lista com todos os itens.
  • As datas estão em ISO 8601, em UTC, e os ids são UUIDs.
  • Os créditos nunca aparecem como números brutos, só como porcentagem do período: Obter o espaço de trabalho, Obter o uso.

O que uma chave pode ver

Uma chave pertence a um espaço de trabalho: ela vê os sites e as conversas desse espaço e mais nada, e age com as permissões do membro que a criou.

O documento OpenAPI

A referência completa em OpenAPI 3.1, para importar no Postman, no Insomnia ou em um gerador de clientes: openapi.json.

Não encontrou a resposta? Fale com a gente.

Pronto para fazer seu site decolar?

Faça sua primeira pergunta - o semchat responde com um plano de ação claro em segundos.

Grátis · sem cadastro · em 5 segundos