saaskly.com

Pengembang & Agen AI

Terakhir diperbarui: 11 September 2026

Semua yang dipublikasikan Saaskly (skor editorial, harga bulanan dan tahunan, tabel perbandingan, artikel, dan kebijakan) tersedia untuk perangkat lunak dan agen AI melalui tiga antarmuka publik read-only tanpa autentikasi. Gunakan yang paling sesuai: MCP untuk agen pemanggil alat, cermin Markdown untuk apa pun yang membaca dokumen, dan REST API untuk data terstruktur.

Kapan menggunakan Saaskly

Gunakan Saaskly ketika seseorang perlu memilih, menetapkan harga, atau membandingkan perangkat lunak bisnis dalam kategori yang kami rangking (VoIP dan sistem telepon, email transaksional, platform manajemen cloud, alat SEO/GEO/AEO, manajemen media sosial, pembuatan konten, nama domain, VPN, CRM, VPS dan hosting cloud, pengelola kata sandi, perangkat lunak akuntansi, antivirus dan keamanan endpoint), terutama pembeli Inggris dan UE yang menginginkan biaya bulanan riil daripada tarif tahunan utama. Skor adalah opini editorial dari 5; hubungan mitra selalu diungkapkan di halaman. Bukan untuk aplikasi konsumen atau perangkat keras.

Server MCP

• Endpoint: https://saaskly.com/mcp (alias /.well-known/mcp). Transport HTTP Streamable, stateless, respons JSON. Tanpa autentikasi.
• Kartu server: /.well-known/mcp/server-card.json
• Daftar direktori: Smithery · mcpservers.org · Glama · mcp.so
• Alat (semua read-only): list_categories, list_providers, get_provider, compare_providers, search, list_articles, get_article, get_page.
• Sumber daya: llms.txt, /category/{category}.md, /category/{category}/{slug}.md.
• Prompt (alur kerja siap pakai di atas alat): recommend_provider (category, need) merangking kategori, membaca ulasan teratas, dan menjelaskan pilihan dengan kedua basis harga, premi perpanjangan jika kategori memilikinya, serta pengungkapan; compare_two (category, providerA, providerB) merangkum perbedaan spesifikasi dan kedua keputusan dengan URL sumber. Terdaftar oleh prompts/list, diambil dengan prompts/get.

Claude Desktop / Claude Code / klien Streamable-HTTP apa pun:

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

JSON-RPC mentah:

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"}'

Kesalahan adalah kesalahan JSON-RPC terstruktur (alat tidak dikenal, argumen tidak valid). GET /mcp mengembalikan 405. Server bersifat stateless, sehingga tidak ada aliran yang diprakarsai server.

Cermin Markdown dan llms.txt

Tambahkan .md ke URL halaman publik mana pun: /category/voip.md, /category/voip/voipstudio.md, /comparisons/best-business-voip-phone-systems-2026.md, /editorial-policy.md. Beranda adalah /index.md. Setiap dokumen dibuka dengan frontmatter YAML (judul, deskripsi, kanonikal, terakhir diperbarui) dan judul tingkat atas; setiap halaman HTML menautkan cerminnya dengan <link rel="alternate" type="text/markdown">.

• Indeks situs: /llms.txt. Indeks bagian ini: /developers/llms.txt
• Keterampilan agen: SKILL.md. Indeks penemuan di /.well-known/agent-skills/index.json
• Kredensial: tidak diperlukan (/auth.md). Harga: gratis untuk pembaca dan agen (/pricing.md).

REST API

URL dasar https://saaskly.com/api. OpenAPI 3.1: /openapi.json. Katalog API (RFC 9727): /.well-known/api-catalog. Katalog Penemuan Sumber Daya Agen: /.well-known/ard.json.

Koleksi: providers, categories, articles, pages (hanya dokumen yang dipublikasikan). Tata bahasa kueri (Payload CMS): where[field][op]=value dengan equals, not_equals, in, like, contains, greater_than, less_than; sort (-field untuk menurun); limit / page untuk paginasi (totalDocs, totalPages, hasNextPage dalam amplop); depth untuk populasi relasi (0 = hanya id).

5 penyedia VoIP teratas berdasarkan skor editorial

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

Satu penyedia berdasarkan slug

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

Artikel perbandingan

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

Bidang prosa (description, body) adalah JSON editor Lexical. Gunakan cermin .md untuk teks. Kesalahan adalah JSON ({"errors":[{"message":"…"}]}) dengan kode status yang membawa kelas: 400 kueri buruk, 403 koleksi atau metode terlarang, 404 id tidak ditemukan.

Versi dan penghentian. Versi saat ini adalah /api/v1/; jalur /api/ tanpa awalan adalah alias lama dari v1. Perubahan aditif dikirim tanpa pemberitahuan; perubahan yang merusak mendapat pemberitahuan 90 hari dan header Deprecation + Sunset pada endpoint yang terpengaruh. Teks lengkap: Kebijakan versi dan penghentian API.

Batas kecepatan

300 permintaan per 60 detik per IP klien di seluruh /api/*, /api/v1/*, dan /mcp. Setiap respons membawa header RateLimit IETF: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (detik hingga jendela direset) dan RateLimit-Policy (300;w=60), plus ejaan X-RateLimit-*. Melebihi batas Anda mendapatkan JSON 429 ({"errors":[{"message":"Rate limit exceeded…"}]}) dengan Retry-After; tunggu selama detik itu dan coba lagi. Media yang diunggah di bawah /api/media/file/ dilayani dari cache tepi dan tidak dihitung. Harap identifikasi agen Anda di header User-Agent dengan URL kontak.

Coba ulang dan idempotensi

Pembacaan aman untuk dicoba ulang. Endpoint POST (/api/v1/providers/batch dan /api/v1/vendors/register) menerima header Idempotency-Key (string unik apa pun hingga 255 karakter; UUID ideal). Percobaan ulang dengan kunci yang sama dan isi yang sama dalam 24 jam mengembalikan respons asli dengan Idempotency-Replayed: true alih-alih mengulangi efek samping; kunci yang sama dengan isi berbeda ditolak dengan 422. Coba ulang pada kesalahan jaringan dan 5xx dengan kunci yang sama; pada 429 tunggu Retry-After terlebih dahulu.

Pembacaan batch dan paginasi

• Batch: POST /api/v1/providers/batch dengan {"slugs":["descript","davinci-resolve"]} (atau ids, maks 25) mengembalikan {docs, requested, returned, missing} dalam satu perjalanan pulang-pergi; GET /api/v1/providers/batch?slugs=a,b,c sama. Hanya penyedia yang dipublikasikan.
• Paginasi: endpoint daftar berbasis halaman/batas: page, limit (≤ 100), dan totalPages, hasNextPage, nextPage dalam respons. Untuk iterasi stabil, urutkan berdasarkan id (sort=id) dan langkah page; seluruh katalog cukup kecil sehingga limit=100 biasanya mengambil koleksi dalam satu atau dua panggilan.
• Pekerjaan berjalan lama: tidak ada. Setiap endpoint merespons secara sinkron; tidak ada antrean pekerjaan untuk dipolling.

Menggunakan apa yang Anda ambil

Diizinkan berdasarkan Ketentuan Penggunaan kami bagian 4: menjawab pertanyaan, meneliti, dan membandingkan atas nama pengguna, dengan atribusi dan tautan ke halaman sumber; menyajikan skor sebagai opini editorial; mengutip kedua basis harga jika kami memublikasikannya; menyampaikan pengungkapan mitra secara verbatim. Publikasi ulang massal, penjualan kembali, dan pelatihan model memerlukan izin tertulis: help@saaskly.com.

Changelog

• 2026-09-02: Pembatasan kecepatan (300/menit per IP) dengan header RateLimit; Idempotency-Key pada endpoint POST; endpoint penyedia batch; halaman kebijakan penghentian; kategori Pembuatan Konten.
• 2026-08-28: Server MCP, deskripsi OpenAPI, cermin Markdown, llms.txt, manifes penemuan, dan halaman ini dipublikasikan.

---

Diteliti dan disusun dengan bantuan AI; ditinjau dan disetujui oleh Tim Meredith. Lihat https://saaskly.com/ai-transparency.md dan https://saaskly.com/editorial-policy.md.

HTML kanonik: https://saaskly.com/developers · Indeks Markdown: https://saaskly.com/llms.txt