saaskly.com

Desenvolvedores e agentes de IA

Última atualização: 11 de setembro de 2026

Tudo o que a Saaskly publica (pontuações editoriais, preços mensais e anuais, tabelas de comparação, artigos e políticas) está disponível para software e agentes de IA por meio de três interfaces públicas, somente leitura e sem autenticação. Use a que melhor se adequar: MCP para agentes que chamam ferramentas, espelhos Markdown para qualquer coisa que leia documentos e a API REST para dados estruturados.

Quando usar a Saaskly

Recorra à Saaskly quando alguém precisar escolher, precificar ou comparar software empresarial em uma categoria que classificamos (VoIP e sistemas telefônicos, e-mail transacional, plataformas de gerenciamento em nuvem, ferramentas de SEO/GEO/AEO, gerenciamento de mídias sociais, criação de conteúdo, nomes de domínio, VPNs, CRM, VPS e hospedagem em nuvem, gerenciadores de senhas, software de contabilidade, antivírus e segurança de endpoint), especialmente compradores do Reino Unido e da UE que desejam o custo mensal real em vez de uma taxa anual de destaque. As pontuações são opinião editorial de 0 a 5; relacionamentos com parceiros são sempre divulgados na página. Não se aplica a aplicativos de consumo ou hardware.

Servidor MCP

• Endpoint: https://saaskly.com/mcp (alias /.well-known/mcp). Transporte HTTP streamable, sem estado, respostas JSON. Sem autenticação.
• Cartão do servidor: /.well-known/mcp/server-card.json
• Listagens em diretórios: Smithery · mcpservers.org · Glama · mcp.so
• Ferramentas (todas somente leitura): list_categories, list_providers, get_provider, compare_providers, search, list_articles, get_article, get_page.
• Recursos: llms.txt, /category/{category}.md, /category/{category}/{slug}.md.
• Prompts (fluxos de trabalho prontos sobre as ferramentas): recommend_provider (category, need) classifica a categoria, lê as principais avaliações e explica a escolha com ambas as bases de preço, o prêmio de renovação quando a categoria possui um, e as divulgações; compare_two (category, providerA, providerB) resume as diferenças da ficha técnica e ambos os veredictos com URLs de origem. Listado por prompts/list, buscado com prompts/get.

Claude Desktop / Claude Code / qualquer cliente Streamable-HTTP:

{ "mcpServers": { "saaskly": { "type": "http", "url": "https://saaskly.com/mcp" } } }

JSON-RPC bruto:

curl -s -X POST https://saaskly.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Erros são erros JSON-RPC estruturados (ferramenta desconhecida, argumentos inválidos). GET /mcp retorna 405. O servidor não tem estado, portanto não há stream iniciado pelo servidor.

Espelhos Markdown e llms.txt

Anexe .md a qualquer URL de página pública: /category/voip.md, /category/voip/voipstudio.md, /comparisons/best-business-voip-phone-systems-2026.md, /editorial-policy.md. A página inicial é /index.md. Todo documento abre com frontmatter YAML (título, descrição, canônico, última atualização) e um cabeçalho de nível superior; toda página HTML vincula seu espelho com <link rel="alternate" type="text/markdown">.

• Índice do site: /llms.txt. Índice desta seção: /developers/llms.txt
• Habilidade de agente: SKILL.md. Índice de descoberta em /.well-known/agent-skills/index.json
• Credenciais: nenhuma necessária (/auth.md). Preços: gratuito para leitores e agentes (/pricing.md).

API REST

URL base https://saaskly.com/api. OpenAPI 3.1: /openapi.json. Catálogo de API (RFC 9727): /.well-known/api-catalog. Catálogo de descoberta de recursos agênticos: /.well-known/ard.json.

Coleções: providers, categories, articles, pages (somente documentos publicados). Gramática de consulta (Payload CMS): where[field][op]=value com equals, not_equals, in, like, contains, greater_than, less_than; sort (-field para descendente); limit / page para paginação (totalDocs, totalPages, hasNextPage no envelope); depth para preenchimento de relacionamentos (0 = apenas IDs).

Top 5 provedores de VoIP por pontuação editorial

curl -s "https://saaskly.com/api/providers?where[category][equals]=voip&sort=-overallRating&limit=5&depth=0"

Um provedor por slug

curl -s "https://saaskly.com/api/providers?where[slug][equals]=voipstudio&depth=0"

Artigos de comparação

curl -s "https://saaskly.com/api/articles?where[contentType][equals]=comparison&depth=0"

Campos de prosa (description, body) são JSON do editor Lexical. Prefira o espelho .md para texto. Erros são JSON ({"errors":[{"message":"…"}]}) com o código de status carregando a classe: 400 consulta inválida, 403 coleção ou método proibido, 404 ID ausente.

Versionamento e descontinuação. A versão atual é /api/v1/; os caminhos /api/ sem prefixo são um alias legado da v1. Mudanças aditivas são lançadas sem aviso; mudanças disruptivas recebem 90 dias de aviso e cabeçalhos Deprecation + Sunset nos endpoints afetados. Texto completo: Política de versionamento e descontinuação de API.

Limites de taxa

300 solicitações por 60 segundos por IP de cliente em /api/*, /api/v1/* e /mcp. Toda resposta carrega os cabeçalhos RateLimit da IETF: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (segundos até a janela ser redefinida) e RateLimit-Policy (300;w=60), além das grafias X-RateLimit-*. Acima do limite, você recebe um JSON 429 ({"errors":[{"message":"Rate limit exceeded…"}]}) com Retry-After; aguarde esse número de segundos e tente novamente. Mídia enviada sob /api/media/file/ é servida pelo cache de borda e não é contabilizada. Identifique seu agente no cabeçalho User-Agent com uma URL de contato.

Repetições e idempotência

Leituras são seguras para repetir. Os endpoints POST (/api/v1/providers/batch e /api/v1/vendors/register) aceitam um cabeçalho Idempotency-Key (qualquer string única de até 255 caracteres; um UUID é ideal). Uma repetição com a mesma chave e o mesmo corpo dentro de 24 horas retorna a resposta original com Idempotency-Replayed: true em vez de repetir o efeito colateral; a mesma chave com um corpo diferente é recusada com 422. Repita em erros de rede e 5xx com a mesma chave; em 429, aguarde Retry-After primeiro.

Leituras em lote e paginação

• Lote: POST /api/v1/providers/batch com {"slugs":["descript","davinci-resolve"]} (ou ids, máx. 25) retorna {docs, requested, returned, missing} em uma única ida e volta; GET /api/v1/providers/batch?slugs=a,b,c é o mesmo. Somente provedores publicados.
• Paginação: endpoints de listagem são baseados em página/limite: page, limit (≤ 100) e totalPages, hasNextPage, nextPage na resposta. Para iteração estável, ordene por id (sort=id) e avance page; o catálogo inteiro é pequeno o suficiente para que limit=100 normalmente busque uma coleção em uma ou duas chamadas.
• Trabalho de longa duração: nenhum. Todo endpoint responde de forma síncrona; não há fila de trabalhos para consultar.

Usando o que você busca

Permitido sob nossa Política de Uso, seção 4: responder perguntas, pesquisar e comparar em nome de um usuário, com atribuição e link para a página de origem; apresentar pontuações como opinião editorial; citar ambas as bases de preço onde as publicamos; repassar divulgações de parceiros na íntegra. Republicação em massa, revenda e treinamento de modelos exigem permissão por escrito: help@saaskly.com.

Registro de alterações

• 2026-09-02: Limite de taxa (300/min por IP) com cabeçalhos RateLimit; Idempotency-Key em endpoints POST; endpoint de provedores em lote; página de política de descontinuação; categoria Criação de Conteúdo.
• 2026-08-28: Servidor MCP, descrição OpenAPI, espelhos Markdown, llms.txt, manifestos de descoberta e esta página publicados.

---

Pesquisado e redigido com assistência de IA; revisado e aprovado por Tim Meredith. Consulte https://saaskly.com/ai-transparency.md e https://saaskly.com/editorial-policy.md.

HTML canônico: https://saaskly.com/developers · Índice Markdown: https://saaskly.com/llms.txt