Voor agenten en ontwikkelaars

AgentRank is gebouwd om door AI-agenten te worden gebruikt én door hen te worden beoordeeld. Er zijn twee manieren: een dieptelink die een mens de vooringevulde scanner overhandigt, en de JSON-endpoints die de webapp zelf gebruikt.

1. Dieptelink (werkt voor iedereen, geen instellingen)

Stuur een gebruiker naar https://jannick.io/?url=voorbeeld.nl om een website namens hen te scannen. De scanner is vooringevuld; wie nog niet is ingelogd maakt een gratis account aan (1 gratis scan, geen creditcard), waarna de scan automatisch start.

2. JSON-endpoints (ingelogde sessie vereist)

Dit zijn de functies die de app aanroept. Ze worden geauthenticeerd met de AgentRank-sessie van de gebruiker, dezelfde sessie die de browser vasthoudt na inloggen, dus er is geen aparte API-sleutel te beheren of te lekken.

Een scan uitvoeren

Endpoint: POST https://jannick.io/api/apps/6a9d111004ca350a0146906d/functions/runAudit
Body: { "url": string, "force"?: boolean } — interactieve scans lezen de site al live; force is een marker voor betaalde plannen. Zie OpenAPI voor optionele save- en follow-up-invoer.
Response (200): { "result": { site_name, overall_score, grade, summary, categories, top_fixes, generated_llms_txt, generated_schema, detected_cms, live_crawled }, "saved": boolean, "auditId": string|null }

Een gedeeld rapport lezen

Endpoint: POST https://jannick.io/api/apps/6a9d111004ca350a0146906d/functions/getPublicReport · Body: { "id": string } (24-hex report id).Alleen rapporten waarvan de eigenaar 'openbare link delen' heeft aangezet worden teruggegeven. Agency-rapporten van een actief abonnement zijn ook zonder AgentRank-login te openen (white-label deellink). Hetzelfde rapport is te bekijken op https://jannick.io/r/<reportId>.

Sites benchmarken tegen concurrenten

Endpoint: POST https://jannick.io/api/apps/6a9d111004ca350a0146906d/functions/getBenchmark
Body: { "urls": ["jouw-site.nl", "concurrent-a.nl", "concurrent-b.nl"] } — 2 tot 3 URL's; de eerste is jouw site, de rest zijn concurrenten.
Response (200): { "rows": [{ url, host, available, auditId, site_name, overall_score, grade, categories, scanned_at, public }], "insights": [{ host, signal, delta }], "generated_at": string }
Leest de meest recente audit per host uit records die jij kunt zien (je eigen, plus openbare audits als terugvaloptie) — er worden geen nieuwe scans gestart, dus het telt niet mee tegen je redelijk-gebruik-limiet. insights bevat elk signaal waar een concurrent 5 punten of meer boven je site scoort. Ook beschikbaar voor Pro- en Agency-gebruikers op de vergelijkingspagina.

Limieten

• Gratis: 1 scan. Pro: max 50 per dag en 200 per 30 dagen. Agency: 100 per factuurperiode en max 50 per dag. Elke aanroep telt mee, ook met save:false.
• Alleen openbare http(s)-websites op standaardpoorten kunnen worden gescand; privé- of interne adressen worden geweigerd.
• Een scan duurt ongeveer een minuut: het leest de homepage, robots.txt, sitemap.xml en llms.txt live en beoordeelt zes categorieën.

Foutcodes

• 400 invalid_url — geen openbaar websiteadres.
• 401 auth_required — geen ingelogde sessie.
• 402 limit_reached — gratis scans opgebruikt; upgrade naar Pro.
• 402 agency_quota — maandquotum van het agency-abonnement bereikt.
• 429 fair_use — limiet van het betaalde abonnement bereikt (50 scans per 24 uur / 200 per 30 dagen). scope is day of month; wacht minstens het aantal seconden uit de Retry-After-header voordat je het opnieuw probeert. Het andere venster kan nog steeds gelden.
• 502 scan_failed — de site kon niet goed genoeg worden gelezen om te beoordelen.

Machineleesbare manifesten

• /openapi.json — OpenAPI 3.0-spec voor de endpoints hierboven (request/response-schema's, foutcodes).
• /.well-known/agent-card.json — capaciteitskaart met AgentRank's HTTP-vaardigheden, endpoints en authenticatie; geen A2A-protocolserver.
• /.well-known/mcp.json — MCP-stijl manifest van dezelfde tools (nog geen gehoste MCP-server; verwijst naar OpenAPI + agentkaart).
• /agents.json — register van de agenten die we beheren (de AgentRank/1.0-scanner) en hoe je je afmeldt.
• /llms.txt — platte-tekstoverzicht voor LLM's; /robots.txt bevat ons Content-Signal (zoeken, AI-input en training toegestaan).
• /changelog.txt — datumstempel-API- en tariefwijzigingen voor agenten, met links naar de nieuwste OpenAPI-spec.

Programmatische toegang op schaal

Bureaus: bekijk het Agency-plan voor klant-scans en white-label rapporten. Voor integraties en MCP-vragen: mail naar leon@jannick.io.. Een machineleesbaar overzicht van AgentRank zelf staat op /llms.txt. Scans lezen alleen openbare pagina's, zie het privacybeleid.