{"openapi":"3.1.0","info":{"title":"Herreira API de Conteúdo","description":"API de conteúdo de Herreira (outro em Brasil). Otimizada para agentes de IA e pipelines RAG.","version":"1.0.0","x-niche":"Semi joias de luxo","x-category":"outro","x-location":"Brasil"},"servers":[{"url":"https://artefacto.herreirasemijoias.com.br"}],"paths":{"/api/content":{"get":{"summary":"Listar e buscar conteúdo publicado","description":"Retorna conteúdos publicados com filtro por tipo, busca por termo, paginação e texto completo opcional.","operationId":"listContent","parameters":[{"name":"type","in":"query","description":"Filtrar por tipo de conteúdo: blog, faq, guia, comparativo, case_study, landing","schema":{"type":"string","enum":["blog","faq","guia","comparativo","case_study","landing"]}},{"name":"q","in":"query","description":"Termo de busca (full-text search em português)","schema":{"type":"string"}},{"name":"slug","in":"query","description":"Buscar conteúdo específico por slug","schema":{"type":"string"}},{"name":"full","in":"query","description":"Incluir texto completo e schema markup (true/false)","schema":{"type":"string","enum":["true","false"]}},{"name":"chunks","in":"query","description":"Incluir chunks semânticos na resposta (requer full=true)","schema":{"type":"string","enum":["true","false"]}},{"name":"limit","in":"query","description":"Máximo de resultados (padrão: 50, máximo: 100)","schema":{"type":"integer","default":50,"maximum":100}},{"name":"offset","in":"query","description":"Offset para paginação","schema":{"type":"integer","default":0}},{"name":"format","in":"query","description":"Formato de resposta. 'markdown' retorna conteúdo em text/markdown. Também suporta o header Accept: text/markdown","schema":{"type":"string","enum":["json","markdown"],"default":"json"}}],"responses":{"200":{"description":"Lista de conteúdos publicados","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/ask":{"get":{"summary":"NLWeb: consulta em linguagem natural","description":"Endpoint compatível com o protocolo NLWeb. Recebe uma pergunta em linguagem natural e retorna resultados em JSON-LD Schema.org (SearchResultsPage). Zero LLM: usa full-text search ranqueado em chunks indexados. Rate limit: 30 req/min por IP.","operationId":"askNaturalLanguage","parameters":[{"name":"q","in":"query","required":true,"description":"Pergunta em linguagem natural (max 200 chars)","schema":{"type":"string","maxLength":200}},{"name":"type","in":"query","description":"Filtrar por tipo de conteúdo: blog, faq, guia, comparativo, case_study, landing","schema":{"type":"string","enum":["blog","faq","guia","comparativo","case_study","landing"]}},{"name":"limit","in":"query","description":"Máximo de resultados (padrão: 5, máximo: 10)","schema":{"type":"integer","default":5,"maximum":10,"minimum":1}}],"responses":{"200":{"description":"Resultados em JSON-LD Schema.org (SearchResultsPage)","content":{"application/ld+json":{"schema":{"type":"object"}}}},"429":{"description":"Rate limit excedido (30 req/min)"}}}},"/api/content/chunks":{"get":{"summary":"Busca semântica em chunks de conteúdo com ranking de relevância","description":"Retorna chunks de 100-400 tokens ranqueados por relevância usando full-text search em português. Ideal para pipelines RAG e retrieval granular.","operationId":"searchChunks","parameters":[{"name":"q","in":"query","description":"Termo de busca (full-text search ranqueado por relevância)","schema":{"type":"string"}},{"name":"type","in":"query","description":"Filtrar por tipo de conteúdo","schema":{"type":"string","enum":["blog","faq","guia","comparativo","case_study","landing"]}},{"name":"limit","in":"query","description":"Máximo de chunks (padrão: 20, máximo: 50)","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Chunks ranqueados por relevância","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"x-mcp-endpoint":"https://artefacto.herreirasemijoias.com.br/mcp","x-nlweb-endpoint":"https://artefacto.herreirasemijoias.com.br/ask","x-llms-txt":"https://artefacto.herreirasemijoias.com.br/llms.txt","x-llms-full-txt":"https://artefacto.herreirasemijoias.com.br/llms-full.txt","x-ai-plugin":"https://artefacto.herreirasemijoias.com.br/.well-known/ai-plugin.json","x-a2a-agent-card":"https://artefacto.herreirasemijoias.com.br/.well-known/a2a/agent-card"}