# ExploriGen para agentes e desenvolvedores (developers)

> Consultoria brasileira de visibilidade em busca. Trabalha conteudo, acesso e fontes para melhorar a presenca no Google e em respostas de IA. Posicionamento e citacoes nao sao garantidos. Atendimento em portugues, a distancia, a partir do Brasil.

ExploriGen é uma consultoria de visibilidade em busca e em respostas de IA, no Brasil, em pt-BR. Esta página é a vista para máquinas (agent mode view) do site: os mesmos dados das páginas, com os endereços diretos. Ela responde em [https://explorigen.io/agentes](https://explorigen.io/agentes), em [https://explorigen.io/?mode=agent](https://explorigen.io/?mode=agent), em [https://explorigen.io/developers](https://explorigen.io/developers) e em [https://explorigen.io/docs](https://explorigen.io/docs); com `Accept: text/markdown` vem o mesmo conteúdo em markdown.

O que é aberto, sem chave de API (API key) e sem cadastro (no signup): markdown de toda página, llms.txt, os dois servidores MCP, /ask, `GET /api` e o sandbox. A API REST v1 pede um bearer que o próprio agente obtém em duas chamadas, de graça, em registro autônomo (self-serve). Cota (rate limit): 120 requisições por minuto com bearer, 60 sem — toda resposta traz `RateLimit-Limit`, `RateLimit-Remaining` e `RateLimit-Reset`; acima da cota, 429 com `Retry-After`. A política inteira, com a depreciação, está em [https://explorigen.io/api/versioning.md](https://explorigen.io/api/versioning.md). As duas operações que escrevem — o registro e a troca por token — aceitam `Idempotency-Key`: repetir com a mesma chave devolve a mesma credencial. O instrumento da leitura de prontidão tem o próprio portão, de 8 chamadas por minuto, sinalizado por 503/429.

## Roteamento

Método + endereço + o que faz. Endpoint só-POST aparece como texto, de propósito: não responde a GET.

- POST https://explorigen.io/mcp — servidor MCP do produto (explorigen; Streamable HTTP, JSON-RPC 2.0, sem autenticação). Servidor MCP da ExploriGen para agir: consultar a prontidão de um domínio para agentes (get_readiness_score), buscar e ler páginas, listar soluções, preços e como contratar. Somente leitura, sem autenticação. Product MCP server: read-only, no auth. Cartão (server card): [https://explorigen.io/.well-known/mcp/server-card.json](https://explorigen.io/.well-known/mcp/server-card.json).
- POST https://explorigen.io/mcp/docs — servidor MCP de documentação (docs; explorigen-docs). Servidor MCP de documentação (docs) da ExploriGen: lista, lê e busca as páginas públicas e o llms.txt. Use search_docs para achar e get_doc para ler. Documentation MCP server: search the docs, read-only, no auth. Cartão: [https://explorigen.io/.well-known/mcp/docs/server-card.json](https://explorigen.io/.well-known/mcp/docs/server-card.json).
- GET [https://explorigen.io/.well-known/mcp.json](https://explorigen.io/.well-known/mcp.json) — manifesto MCP (o cartão do produto mais a lista dos dois servidores); o mesmo documento em [https://explorigen.io/.well-known/mcp](https://explorigen.io/.well-known/mcp).
- GET [https://explorigen.io/api](https://explorigen.io/api) — índice público da API (200, sem token): endpoints, escopos, política de versão, onde está a autenticação e o sandbox.
- GET [https://explorigen.io/api/v1/](https://explorigen.io/api/v1/) — API REST v1, somente leitura (read-only), com bearer: `paginas`, `paginas/<rota>`, `busca?q=`, `solucoes`, `precos`, `prontidao/<dominio>`. Sem token responde 401 com `WWW-Authenticate` apontando os metadados. Como obter o token: [https://explorigen.io/auth.md](https://explorigen.io/auth.md).
- GET [https://explorigen.io/api/v1/sandbox/](https://explorigen.io/api/v1/sandbox/) — sandbox (test mode): as mesmas rotas da v1 com dados fixos, sem token, sem tocar o KV nem a ORA.
- POST https://explorigen.io/agent/identity — registro anônimo (anonymous) do agente: devolve `identity_assertion`. POST https://explorigen.io/agent/token — troca a asserção pelo `access_token` (1 h, escopos `site.read`, `prontidao.read`). Metadados: [https://explorigen.io/.well-known/oauth-protected-resource](https://explorigen.io/.well-known/oauth-protected-resource) (recurso protegido, RFC 9728) e [https://explorigen.io/.well-known/oauth-authorization-server](https://explorigen.io/.well-known/oauth-authorization-server) (servidor de autorização, RFC 8414).
- POST https://explorigen.io/ask — NLWeb: busca lexical (keyword search) nas páginas, corpo `{"query":{"text":"..."}}`, resposta JSON ou SSE. Também GET https://explorigen.io/ask?query=...&streaming=false.
- GET [https://explorigen.io/index.md](https://explorigen.io/index.md) — a home em markdown; toda página tem o gêmeo `<rota>.md`, e a própria rota HTML devolve markdown com `Accept: text/markdown` (e aos bots de IA pelo User-Agent).
- GET https://explorigen.io/api/ia/leitura?site=<dominio> — leitura de prontidão técnica gravada para um domínio (nota 0-100 e grau A+–F do instrumento ora.ai). GET nunca mede; medir é na página [https://explorigen.io/diagnostico-de-visibilidade-cognitiva](https://explorigen.io/diagnostico-de-visibilidade-cognitiva), grátis (free), 3 medições por visitante a cada 24 h.
- GET [https://explorigen.io/llms.txt](https://explorigen.io/llms.txt) — índice para modelos; por área: [https://explorigen.io/api/llms.txt](https://explorigen.io/api/llms.txt) (documentação da API — developer documentation), [https://explorigen.io/solucoes/llms.txt](https://explorigen.io/solucoes/llms.txt), [https://explorigen.io/blog/llms.txt](https://explorigen.io/blog/llms.txt), [https://explorigen.io/diagnostico-de-visibilidade/llms.txt](https://explorigen.io/diagnostico-de-visibilidade/llms.txt).
- GET [https://explorigen.io/.well-known/agent-skills/index.json](https://explorigen.io/.well-known/agent-skills/index.json) — índice de skills (Agent Skills v0.2.0) para agentes de código.
- GET [https://github.com/lepitismak/explorigen-agentes](https://github.com/lepitismak/explorigen-agentes) — repositório público com as mesmas skills, o manifesto MCP, AGENTS.md e .cursorrules para agentes de código.
- GET [https://explorigen.io/.well-known/agent-card.json](https://explorigen.io/.well-known/agent-card.json) — cartão A2A (agent card): identidade, capacidades e as ferramentas como skills.
- GET [https://explorigen.io/.well-known/api-catalog](https://explorigen.io/.well-known/api-catalog) — catálogo de APIs (RFC 9727, linkset). GET [https://explorigen.io/api/openapi.json](https://explorigen.io/api/openapi.json) — OpenAPI 3.1 da API v1, do sandbox, da autorização e do /ask.
- GET [https://explorigen.io/pricing.md](https://explorigen.io/pricing.md) — preços públicos: Diagnóstico de Visibilidade, R$ 997,00, até 7 dias depois do pagamento e do e-mail de confirmação; Diagnóstico de Visibilidade Cognitiva: grátis (free); demais serviços sob proposta (custom pricing).
- GET [https://explorigen.io/auth.md](https://explorigen.io/auth.md) — autenticação de agentes (agent auth): descoberta, registro, troca, uso, erros, sandbox.
- GET [https://explorigen.io/sitemap.xml](https://explorigen.io/sitemap.xml) — mapa do site com lastmod. GET [https://explorigen.io/schemamap.xml](https://explorigen.io/schemamap.xml) — Schema Map (NLWeb) com o tipo schema.org de cada rota. Feeds: [https://explorigen.io/feeds/solucoes.jsonl](https://explorigen.io/feeds/solucoes.jsonl) e [https://explorigen.io/feeds/artigos.jsonl](https://explorigen.io/feeds/artigos.jsonl) (JSON Lines).
- GET [https://explorigen.io/agentes/catalogo.json](https://explorigen.io/agentes/catalogo.json) — catálogo: marca, produtos, soluções, objetivos, artigos, páginas, FAQ, caminhos e ferramentas, gerado do código no build. GET [https://explorigen.io/agentes/indice.json](https://explorigen.io/agentes/indice.json) — índice de busca (título, descrição, texto por página).
- GET [https://explorigen.io/.well-known/http-message-signatures-directory](https://explorigen.io/.well-known/http-message-signatures-directory) — diretório Web Bot Auth (RFC 9421): a chave Ed25519 do agente de leitura da ExploriGen, com o estado honesto no campo purpose.
- GET [https://explorigen.io/webmcp.js](https://explorigen.io/webmcp.js) — as ferramentas WebMCP que toda página registra em `document.modelContext`.
- Contato: [contato@explorigen.io](mailto:contato@explorigen.io) · triagem por objetivo em [https://explorigen.io/comecar](https://explorigen.io/comecar) · contato direto em [https://explorigen.io/contato](https://explorigen.io/contato).

## Início rápido (quickstart)

Três chamadas reais, sem conta: registro anônimo, troca pelo token e uma busca na API v1. Precisa de `curl` e `jq`.

```bash
# 1. Registro anônimo (self-serve): devolve a identity_assertion (24 h)
A=$(curl -s -X POST -H 'content-type: application/json' -d '{"type":"anonymous"}' https://explorigen.io/agent/identity | jq -r .identity_assertion)
# 2. Troca a asserção pelo access_token (1 h)
T=$(curl -s -X POST https://explorigen.io/agent/token --data-urlencode 'grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer' --data-urlencode "assertion=$A" | jq -r .access_token)
# 3. Busca lexical (keyword search) na API v1
curl -s -H "Authorization: Bearer $T" "https://explorigen.io/api/v1/busca?q=seo"
```

Sem token, no sandbox (test mode), a mesma forma com dados fixos:

```bash
curl -s "https://explorigen.io/api/v1/sandbox/busca?q=seo"
curl -s https://explorigen.io/api/v1/sandbox/precos
```

Sem nenhuma chamada de autorização: `curl -s -H 'Accept: text/markdown' https://explorigen.io/solucoes` devolve a página em markdown, e `curl -s -X POST -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' https://explorigen.io/mcp` lista as ferramentas MCP.

## Capacidades

### Ferramentas MCP do produto (POST https://explorigen.io/mcp)

- `get_readiness_score` — Consulta a leitura de prontidão técnica gravada para um domínio (nota 0-100 e grau A+–F do instrumento ora.ai, camadas, lacunas). Nunca mede: se não há leitura, devolve ausente=true e o endereço /diagnostico-de-visibilidade-cognitiva para medir. Get the recorded agent-readiness score for a domain (never triggers a scan).
- `search_site` — Busca lexical nas páginas públicas de explorigen.io (título, descrição e texto). Search ExploriGen pages by keyword; no semantic ranking.
- `get_page` — Devolve o markdown de uma página pública de explorigen.io pela rota (ex.: /solucoes/seo-tecnico). Get a page of explorigen.io as markdown.
- `list_services` — Lista as soluções da ExploriGen (SEO técnico, conteúdo, SEO local, respostas de IA, dados estruturados, autoridade, conversão, dados e performance, anúncios, automação) e as cinco portas por objetivo de negócio. Aceita `tipo` para pedir só um dos dois conjuntos e `termo` para filtrar por palavra no nome ou no resumo. List ExploriGen services; optional `tipo` and `termo` filters.
- `get_pricing` — Preços públicos: diagnóstico pago (valor, prazo, o que inclui, link de pagamento) e diagnóstico gratuito; demais serviços são sob proposta. Aceita `produto` para devolver só um deles. Get public pricing (same data as /pricing.md); optional `produto` filter.
- `how_to_hire` — Como contratar ou falar com a ExploriGen: e-mail, triagem por objetivo (/comecar), contato direto (/contato), o diagnóstico pago (/diagnostico-de-visibilidade) e a leitura gratuita (/diagnostico-de-visibilidade-cognitiva). Aceita `produto` para o caminho de contratação de um produto específico. How to contact or hire ExploriGen; optional `produto` filter.

### Ferramentas MCP de documentação (POST https://explorigen.io/mcp/docs)

- `list_docs` — Lista as páginas públicas de explorigen.io (rota, título, descrição, seção) — a documentação (docs) que este servidor serve. List the ExploriGen docs pages.
- `get_doc` — Devolve uma página de explorigen.io em markdown pela rota. Get one docs page as markdown.
- `search_docs` — Busca lexical na documentação (docs) de explorigen.io. Search the ExploriGen docs.
- `get_llms_txt` — Devolve o llms.txt raiz de explorigen.io (índice para modelos). Aceita `secao` para devolver só um bloco `## ...` do arquivo, em vez dos 10 KB inteiros. Get the site's llms.txt; optional `secao` returns a single section.

### Ferramentas WebMCP (no navegador, em toda página)

- `explorigen_get_readiness_score` — Consulta a leitura de prontidão gravada de um domínio (GET /api/ia/leitura). Get the recorded readiness score for a domain.
- `explorigen_search` — Busca lexical nas páginas do site (POST /ask). Search the site.
- `explorigen_get_page` — Lê uma página do site em markdown (<rota>.md). Get a page as markdown.
- `explorigen_get_pricing` — Preços públicos (GET /pricing.md). Public pricing.
- `explorigen_how_to_hire` — Canais de contato e produtos (GET /agentes/catalogo.json). How to hire.

### Escopos da API v1

- `site.read` — ler páginas, busca e catálogo (read pages, search, catalog)
- `prontidao.read` — consultar leituras de prontidão gravadas (read recorded readiness scores)

Política de versão: A versão vai no caminho (/api/v1/). Mudança incompatível nasce em /api/v2/ e a v1 continua no ar por pelo menos 90 dias depois do aviso, sinalizado pelos cabeçalhos Deprecation e Sunset (RFC 9745/8594). A API v1 é somente leitura (read-only): nenhuma operação cria, altera ou apaga dado. A política inteira, com as cotas (rate limit), está em https://explorigen.io/api/versioning.md.

## Páginas

43 páginas públicas, cada uma com o gêmeo em markdown (acrescente .md ao endereço).

- [Apareça no Google e nas respostas de IA — ExploriGen](https://explorigen.io/): Sua empresa aparece quando alguém procura o que você vende? A ExploriGen mostra onde você some no Google e nas respostas de IA, e o que fazer primeiro.
- [Blog sobre busca e IA — ExploriGen](https://explorigen.io/blog): Artigos e guias da ExploriGen sobre SEO, mídia paga, ChatGPT, Google Flow e busca com IA.
- [112 comandos para ChatGPT: imagem, texto e raciocínio — ExploriGen](https://explorigen.io/blog/100-prompts-para-chatgpt): Um catálogo com 112 comandos para ChatGPT, com busca e filtro, divididos entre direção de imagem e direção de texto e raciocínio.
- [11 comandos para Google Flow: câmera e movimento — ExploriGen](https://explorigen.io/blog/comandos-google-flow): Atalhos para orientar câmera, enquadramento, velocidade e movimento em vídeos gerados no Google Flow, com exemplo de prompt pronto para copiar.
- [Como criar conteúdo que aparece no Google e atrai clientes — ExploriGen](https://explorigen.io/blog/como-criar-conteudo-que-aparece-no-google-e-atrai-clientes): Aprenda a planejar conteúdo pela intenção de busca, organizar o artigo e conectar a leitura à geração de contatos.
- [Ninguém pesquisa o seu ramo: o cliente pesquisa a própria dor — ExploriGen](https://explorigen.io/blog/ninguem-pesquisa-o-seu-ramo): O cliente não pesquisa o nome do seu serviço. Ele descreve o problema, com as palavras dele. É a essa pergunta que o conteúdo do site precisa responder.
- [O que é SEO e como funciona para atrair clientes — ExploriGen](https://explorigen.io/blog/o-que-e-seo-e-como-funciona-para-atrair-clientes): Entenda o que é SEO, como funciona para atrair clientes e por onde começar: pilares, checklist e ferramentas para acompanhar os resultados.
- [Ranqueamento no Google: o que realmente faz diferença — ExploriGen](https://explorigen.io/blog/ranqueamento-no-google-o-que-realmente-faz-diferenca): Entenda os fundamentos do ranqueamento no Google, os mitos mais comuns e como definir prioridades para melhorar seu site.
- [SEO e mídia paga: como integrar e medir o retorno — ExploriGen](https://explorigen.io/blog/seo-e-midia-paga): Entenda como combinar SEO e mídia paga, identificar desperdícios e medir o custo de aquisição para decidir onde investir com mais critério.
- [Taxa de conversão: como calcular, interpretar e melhorar — ExploriGen](https://explorigen.io/blog/taxa-de-conversao-como-calcular-interpretar-e-melhorar): Veja como calcular a taxa de conversão, interpretar os resultados e identificar os ajustes que ajudam a transformar visitas em contatos.
- [WhatsApp para empresas: do app básico à API profissional — ExploriGen](https://explorigen.io/blog/whatsapp-para-empresas-do-app-basico-a-api-profissional): Compare o app e a API do WhatsApp para empresas e entenda como organizar o atendimento e integrar os contatos ao seu site.
- [Por onde começar: você já sabe o que precisa? — ExploriGen](https://explorigen.io/comecar): Quem já sabe o que falta vai direto à solução. Quem ainda não sabe faz o diagnóstico e descobre o que resolver primeiro.
- [Contato — ExploriGen](https://explorigen.io/contato): Escreva para contato@explorigen.io contando o que vende e onde o contato some. Respondemos com o próximo passo.
- [Diagnóstico de Visibilidade: por que você não é encontrado — ExploriGen](https://explorigen.io/diagnostico-de-visibilidade): Diagnóstico de Visibilidade: veja onde sua empresa aparece hoje no Google, no Bing e nas respostas de IA, com registros e um plano de prioridades.
- [Diagnóstico de Visibilidade Cognitiva — ExploriGen](https://explorigen.io/diagnostico-de-visibilidade-cognitiva): Diagnóstico de Visibilidade Cognitiva grátis: como a inteligência artificial lê e interpreta o seu site. Não mede citações nem vendas.
- [Método Explorigen — ExploriGen](https://explorigen.io/metodo): Veja o que examinamos, quais documentos saem do trabalho e os sites publicados para conferir.
- [Política de cookies — ExploriGen](https://explorigen.io/politica-de-cookies): Entenda quais cookies podem ser usados no site da ExploriGen e como controlar essas tecnologias.
- [Política de privacidade — ExploriGen](https://explorigen.io/politica-de-privacidade): Saiba quais dados a ExploriGen trata neste site, por que eles são usados e como exercer seus direitos.
- [Resultados: trabalhos reais identificados — ExploriGen](https://explorigen.io/resultados): Demonstrações de trabalho, com endereço para conferir. Sites de Galetos do Brasil, Galetos do Brasil Aldeota e Arthur Braün.
- [Arthur Braün · Arquitetos: demonstração de trabalho — ExploriGen](https://explorigen.io/resultados/arthur-braun): Escritório de arquitetura, interiores e urbanismo, com acompanhamento de obra. O site apresenta serviços e projetos do escritório, com links para contato. Endereço do trabalho disponível para conferir.
- [Galetos do Brasil: demonstração de trabalho — ExploriGen](https://explorigen.io/resultados/galetos-do-brasil): Galeteria de galeto na brasa, com entrega e retirada. O site reúne as unidades e apresenta os canais de pedido de cada loja. Endereço do trabalho disponível para conferir.
- [Galetos do Brasil Aldeota: demonstração de trabalho — ExploriGen](https://explorigen.io/resultados/galetos-do-brasil-aldeota): Unidade da marca Galetos do Brasil, com galeto na brasa, entrega e retirada. O site da Aldeota apresenta os pratos e os caminhos para pedir nessa unidade. Endereço do trabalho disponível para conferir.
- [SEO e GEO: apareça no Google e no ChatGPT — ExploriGen](https://explorigen.io/seo-e-geo): Como SEO e busca com IA se completam, como o ChatGPT escolhe fontes e como medir se sua empresa aparece.
- [Sobre a Explorigen — ExploriGen](https://explorigen.io/sobre): Consultoria de visibilidade digital: sua empresa no Google e nas respostas de inteligência artificial, com medição antes e depois.
- [Soluções para encontrar, atender e conquistar clientes — ExploriGen](https://explorigen.io/solucoes): Soluções para busca, respostas de IA, anúncios, site, atendimento e medição. Escolha pelo problema e confira o escopo.
- [Como transformar visitas em contatos — ExploriGen](https://explorigen.io/solucoes/aumentar-conversao): Deixe claro o que você vende e facilite pedir orçamento ou marcar horário.
- [Como aparecer no Google e nas respostas do ChatGPT — ExploriGen](https://explorigen.io/solucoes/aumentar-visibilidade): Apareça no Google e nas respostas do ChatGPT quando alguém pesquisa o que você vende.
- [Automação de atendimento e vendas — ExploriGen](https://explorigen.io/solucoes/automacoes): Contatos, respostas e tarefas repetidas rodam sozinhos; seu time fica com quem precisa de uma pessoa.
- [Como organizar e automatizar o atendimento — ExploriGen](https://explorigen.io/solucoes/automatizar-operacao): Automatize o que se repete e libere seu time para as conversas que fecham venda.
- [Autoridade digital — ExploriGen](https://explorigen.io/solucoes/autoridade-digital): Reunimos fontes, especialistas e menções de fora para outros confirmarem o que sua empresa afirma.
- [Dados estruturados — ExploriGen](https://explorigen.io/solucoes/dados-estruturados): Marcamos produtos, serviços e relações num formato que o Google e a inteligência artificial (IA) leem direto.
- [Estratégia de conteúdo e busca — ExploriGen](https://explorigen.io/solucoes/estrategia-de-conteudo-e-busca): Transformamos o que as pessoas pesquisam em páginas que ajudam a comparar e escolher sua empresa.
- [Como chegar a novos clientes além da indicação — ExploriGen](https://explorigen.io/solucoes/gerar-demanda): Apareça para quem procura o que você faz e para quem nem sabe que precisa.
- [Índice de Visibilidade Cognitiva — ExploriGen](https://explorigen.io/solucoes/indice-de-visibilidade-cognitiva): Uma leitura de como a IA descreve e indica sua empresa, além de ver se ela cita. Ainda não é um serviço pronto.
- [Dados e performance — ExploriGen](https://explorigen.io/solucoes/inteligencia-de-dados-e-performance): Juntamos busca, conteúdo, inteligência artificial (IA) e números do negócio para mostrar o que mudou e onde agir.
- [Anúncios para chegar a novos clientes — ExploriGen](https://explorigen.io/solucoes/midia-paga): Anúncios para apresentar sua empresa a quem tem perfil para precisar dela, medindo quais campanhas trazem contato bom.
- [Otimização de conversão — ExploriGen](https://explorigen.io/solucoes/otimizacao-de-conversao): Ajustamos o site para quem entra dar o próximo passo: o contato.
- [Respostas de inteligência artificial — ExploriGen](https://explorigen.io/solucoes/otimizacao-para-mecanismos-generativos): Organizamos o que sua empresa faz, com provas, para o ChatGPT e o Google com IA citarem você.
- [Como saber o que traz retorno no marketing — ExploriGen](https://explorigen.io/solucoes/reduzir-cac): Saiba qual canal traz cliente de verdade e onde o dinheiro está indo embora.
- [SEO local — ExploriGen](https://explorigen.io/solucoes/seo-local): Organizamos perfil no Google, páginas e avaliações para você aparecer quando a pesquisa inclui bairro ou cidade.
- [SEO técnico — ExploriGen](https://explorigen.io/solucoes/seo-tecnico): Consertamos o que impede o Google de ler seu site e mostrar suas páginas na busca.
- [Termos de uso — ExploriGen](https://explorigen.io/termos-de-uso): Conheça as regras para acessar e usar o site da ExploriGen.
- [Como está sua visibilidade digital? Retrato grátis — ExploriGen](https://explorigen.io/visibilidade-digital): Conte onde sua empresa está e o que o cliente procura. Uma pessoa procura como ele e mostra, de graça, onde você aparece hoje.