{"openapi":"3.1.0","info":{"title":"Hub de Ferramentas · Chave Mestra","version":"1.2.0","description":"Catálogo público somente leitura, com curadoria de Eduardo Schurtz. Use url para citar o Hub de Ferramentas e visit_url para acessar o fornecedor. Links de afiliado identificados, ofertas sujeitas à confirmação no checkout e preços datados. Não é um servidor MCP."},"servers":[{"url":"https://ferramentas.chavemestra.so"}],"security":[],"externalDocs":{"description":"Critérios de curadoria e afiliação","url":"https://ferramentas.chavemestra.so/sobre"},"paths":{"/api/ferramentas":{"get":{"operationId":"searchTools","summary":"Pesquisar ferramentas do catálogo","description":"Combine nome, categoria, finalidade, MCP e oferta. mcp exclui estados testing e unknown. Sem paginação: retorna todos os resultados correspondentes.","parameters":[{"name":"q","in":"query","description":"Nome, categoria ou finalidade; limitado aos primeiros 200 caracteres.","schema":{"type":"string","maxLength":200},"example":"newsletter"},{"name":"categoria","in":"query","description":"Nome ou slug da categoria. Categorias: Todas, Automação, Marketing e CRM, WhatsApp, Dados e scraping, Produtividade, Criação de conteúdo, Infraestrutura, Finanças, Telefonia.","schema":{"type":"string"},"example":"marketing-e-crm"},{"name":"category","in":"query","description":"Alias de categoria; categoria tem precedência.","schema":{"type":"string"}},{"name":"mcp","in":"query","description":"Somente ferramentas com MCP documentado.","schema":{"type":"string","enum":["0","1","false","true"]}},{"name":"ofertas","in":"query","description":"Somente ferramentas com oferta registrada.","schema":{"type":"string","enum":["0","1","false","true"]}},{"name":"format","in":"query","description":"Representação da resposta. Padrão: JSON.","schema":{"type":"string","enum":["json","markdown"],"default":"json"}}],"responses":{"200":{"description":"Conteúdo público do catálogo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Categoria inválida.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/ferramentas/{slug}":{"get":{"operationId":"getTool","summary":"Consultar uma ferramenta","parameters":[{"name":"slug","in":"path","required":true,"description":"Campo id retornado pela busca.","schema":{"type":"string"},"example":"n8n"},{"name":"format","in":"query","description":"Representação da resposta. Padrão: JSON.","schema":{"type":"string","enum":["json","markdown"],"default":"json"}}],"responses":{"200":{"description":"Conteúdo público do catálogo.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tool"},"example":{"id":"n8n","name":"n8n","description":"Plataforma visual e extensível para automações, integrações e agentes de IA, em nuvem ou auto-hospedada.","category":"Automação","tags":["Workflows","Agentes de IA","Self-hosted"],"url":"https://ferramentas.chavemestra.so/ferramentas/n8n","website":"https://n8n.io/","visit_url":"https://eduardo.tools/n8n","affiliate_link":true,"curator":{"name":"Eduardo Schurtz","url":"https://ferramentas.chavemestra.so/sobre"},"fit":"Integrar aplicativos e construir fluxos com lógica, código e agentes.","limitations":"Não substitui sozinho o envio de campanhas ou um CRM; esses serviços precisam ser conectados.","mcp":{"type":"server","label":"Servidor MCP","note":"Servidor e cliente MCP. A conexão depende da sua instância e dos workflows disponibilizados.","source":"https://docs.n8n.io/advanced-ai/accessing-n8n-mcp-server/","checked_at":"2026-09-04"},"offer":null,"price_reference":{"amount":240,"currency":"USD","billing":"year","plan":"Starter · anual","scope":"2.500 execuções/mês. Equivalente a US$ 20/mês; pagamento anual.","source":"https://n8n.io/pricing/","checked":"2026-09-05"},"price_note":null,"dossier_reviewed_at":"2026-09-04"}},"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Ferramenta não encontrada.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Catalog":{"type":"object","required":["schema_version","total","disclosure","tools"],"properties":{"schema_version":{"type":"integer","const":1},"total":{"type":"integer","minimum":0},"disclosure":{"type":"string"},"tools":{"type":"array","items":{"$ref":"#/components/schemas/Tool"}}}},"Tool":{"type":"object","required":["id","name","description","category","tags","url","website","visit_url","affiliate_link","curator","fit","limitations","mcp","offer","price_reference","dossier_reviewed_at"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"url":{"type":"string","format":"uri","description":"Página canônica do Hub de Ferramentas, adequada para citação."},"website":{"type":"string","format":"uri"},"visit_url":{"type":"string","format":"uri","description":"Link de afiliado cadastrado ou, na ausência, site oficial."},"affiliate_link":{"type":"boolean"},"curator":{"type":"object","required":["name","url"],"properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}}},"fit":{"type":["string","null"]},"limitations":{"type":["string","null"]},"mcp":{"$ref":"#/components/schemas/Mcp"},"offer":{"anyOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"price_reference":{"anyOf":[{"$ref":"#/components/schemas/Price"},{"type":"null"}]},"price_note":{"type":["string","null"],"description":"Contexto de preço, incluindo ofertas de pagamento único. Não representa mensalidade."},"dossier_reviewed_at":{"type":"string","format":"date","description":"Revisão do dossiê; não é a data de publicação da página."}}},"Mcp":{"type":"object","required":["type","label","note","source","checked_at"],"properties":{"type":{"type":"string","enum":["server","local","client","docs-local","testing","unknown"]},"label":{"type":"string"},"note":{"type":["string","null"]},"source":{"type":["string","null"],"format":"uri"},"checked_at":{"type":"string","format":"date"}}},"Offer":{"type":"object","required":["title","coupon","conditions","status","url"],"properties":{"title":{"type":"string"},"type":{"type":["string","null"],"enum":["lifetime",null],"description":"lifetime indica oferta vitalícia com pagamento único, sujeita a limites e termos."},"source":{"type":["string","null"],"format":"uri"},"checked_at":{"type":["string","null"],"format":"date"},"coupon":{"type":["string","null"]},"conditions":{"type":["string","null"]},"status":{"type":"string","const":"confirm_at_checkout"},"url":{"type":"string","format":"uri"}}},"Price":{"type":"object","required":["amount","currency","billing","plan","scope","source","checked"],"properties":{"amount":{"type":"number","minimum":0},"currency":{"type":"string","enum":["USD","BRL","EUR"]},"billing":{"type":"string","enum":["month","year"]},"plan":{"type":"string"},"scope":{"type":"string"},"source":{"type":"string","format":"uri"},"checked":{"type":"string","format":"date"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"categories":{"type":"array","items":{"type":"string"}}}}}}}