--- title: "Interfaces públicas do site | Tropk" description: "Documentação da API de conteúdo, MCP de leitura, Markdown, limites e formulários do site público da Tropk." canonical: "https://tropk.ai/docs/website-api" last_modified: "2026-10-12T16:04:28.241Z" --- # Interfaces públicas do site | Tropk DOCUMENTAÇÃO ## Interfaces públicas do site Consulte o conteúdo publicado e entenda os contratos dos formulários, os limites e as regras de repetição. ## Leitura pública do site Use estas interfaces para encontrar e ler páginas, artigos e recursos publicados da Tropk. Não é necessário cadastro ou chave de API. Elas não dão acesso à plataforma, ao CMS, a rascunhos, leads ou dados de clientes. [Especificação OpenAPI](/openapi.json). [Catálogo de APIs](/.well-known/api-catalog). [Card do servidor MCP](/server-card); endereço [MCP](/recursos/glossario/mcp): /mcp/website. ## API de documentos GET /api/website/v1/documents?limit=20 lista título, resumo, seção e URLs. q busca palavras em títulos/resumos; não é uma resposta gerada por IA. limit aceita 1–50; nextCursor indica o próximo offset, ou null no final. O inventário pode mudar entre consultas. GET /api/website/v1/documents?path=/precos lê o documento em Markdown. Use somente caminhos retornados pela lista. Caminhos privados, externos, inexistentes ou não indexáveis são recusados. A versão /v1 mantém o formato das respostas; mudanças incompatíveis serão oferecidas em outra versão. Novos campos podem ser adicionados. Verifique a especificação publicada antes de integrar. ## MCP para busca e leitura Configure um cliente MCP com transporte Streamable HTTP no endereço /mcp/website. O servidor é stateless: cada POST é uma mensagem JSON-RPC; não cria sessões. Inclua Accept: application/json, text/event-stream. GET retorna 405 porque não há stream iniciado pelo servidor. search\_website recebe query, cursor e limit; read\_website\_document recebe um path publicado. Ambas são ferramentas somente de leitura. resources/list oferece o índice tropk://website/index; resources/templates/list descreve documentos tropk://website/document{?path}. As ferramentas não enviam formulários nem geram relatórios. Preserve as ressalvas e cite as URLs ao usar o conteúdo. Erros de consulta têm isError; erros de protocolo seguem JSON-RPC. ## Markdown e feeds estruturados Acrescente .md às páginas públicas; a inicial usa /index.md. Também são aceitos Accept: text/markdown e ?mode=agent. Os formatos refletem a mesma versão publicada no Payload. [llms.txt](/llms.txt) é o índice de entrada; [llms-full.txt](/llms-full.txt) contém a lista completa de documentos. [schemamap.xml](/schemamap.xml) anuncia [o feed JSONL](/feeds/public-pages.jsonl), que reutiliza o [JSON-LD](/recursos/glossario/json-ld) real da home e páginas institucionais. O feed não é uma API de dados privados. ## Limites e recuperação A leitura pela API/MCP aceita 120 requisições por endereço IP a cada 15min em cada instância. Os formulários aceitam 20 envios/IP/15min; o checklist também limita 8 novos cadastros/e-mail/hora no banco. A infraestrutura pode aplicar limites adicionais. Respostas informam RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset e RateLimit-Policy quando o limitador é aplicado. Em 429, respeite Retry-After antes de tentar novamente. Esses limites em memória não são um quota global entre réplicas. Erros REST usam error (mensagem), code (identificador), status e recovery (onde encontrar orientação). 400 pede correção,403 recusa,404 indica documento/material ausente,409 aponta conflito/repetição,429 pede espera e 503 indica indisponibilidade ou resultado incerto. ## Formulários e autorização Enviar formulários registra dados e pode iniciar processamento. Só faça isso com autorização da pessoa para os dados e a finalidade. As ferramentas MCP de leitura não realizam essas ações. POST /api/resources/checklists/{key} aceita JSON ou formulário. Envie e-mail e resourceSlug; nome e companyWebsite são opcionais. A chave UUID é informada em Idempotency-Key ou no campo idempotencyKey; ambos devem coincidir. Accept: application/json retorna downloadUrl; a autorização expira em 5min. Sem esse Accept, o download pode retornar XLSX. POST /api/website/report aceita JSON com domain, leadFirstName e leadEmail; leadLastName e leadWhatsapp são opcionais. Idempotency-Key UUID é obrigatório. A resposta202 contém reportId, redirectUrl e statusUrl, e Location aponta para o acompanhamento JSON. Ela confirma a aceitação; não significa que o relatório terminou. GET em statusUrl devolve pending/uncertain para a entrega, ou processing/ready/failed conforme o estado real do relatório; respeite Retry-After. Guarde a chave e o statusUrl como links privados. Nenhum dado de contato ou de projeto é retornado pelo acompanhamento do website. Os envios exigem o mesmo Origin do site e corpo até 16 KiB. ## Repetição segura Reutilize a mesma chave somente com os mesmos dados normalizados. O checklist reconcilia o cadastro por chave única; alterar campos gera 409. O relatório reserva um recibo único e persistente no Payload antes de encaminhar o processamento. Envios concorrentes não iniciam outro fluxo com a mesma chave. Uma solicitação pendente ou incerta nunca é repetida automaticamente. Se a conexão cair, não gere outra chave para insistir: use o canal de contato. Uma chave não é uma autorização de conta nem uma garantia de conclusão do processamento. ## Clientes e instruções de leitura [Cliente JavaScript sem dependências](/agents/tropk-public-reader.mjs). [CLI Node](/agents/tropk-public-cli.mjs); mantenha os dois arquivos na mesma pasta. Exemplo: node tropk-public-cli.mjs search [GEO](/recursos/glossario/geo). [Baixar skill, regras e plugin de leitura](/agents/tropk-public-reading.zip). Os artefatos são preparados para o novo website; não constituem publicação em npm, skills.sh ou marketplace. Não oferecem comandos de escrita. ## Privacidade e contato Consulte [privacidade](/privacidade) e [termos](/termos) antes de enviar dados. Dúvidas: contato@tropk.ai. O conteúdo aberto pode ser citado; isso não concede licença para operar contas ou acessar dados de terceiros. As interfaces e documentos são preparados no novo site. Disponibilidade no domínio público, [indexação](/recursos/glossario/indexacao) e listagens externas dependem da publicação e devem ser verificadas nesse ambiente. --- [Todas as páginas em Markdown]()