Az AISeeWhy API-ja és MCP-szervere

Küldjön egy POST-ot egy URL-lel az audit végpontnak, és JSON-jelentést kap: 0–100-as pontszámot, prioritással, bizonyítékkal és beilleszthető javításokkal ellátott találatokat a 30 nyelv bármelyikén. Az AI-ügynökök az MCP végponthoz csatlakoznak, és hívják az audit_url-t. Pro vagy próbakulcs nélkül előnézetet kap.

POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp

Hogyan hívom az API-t?

curl -s https://api.aiseewhy.com/v1/audit \
  -H 'content-type: application/json' \
  -H 'x-api-key: asw_…' \
  -d '{"url": "https://example.com/pricing", "language": "hu"}'

Mezők: url (kötelező; a hiányzó https:// előtagot hozzáadjuk), language (a jelentés nyelvkódja, alapértelmezés en), bots (crawlernevek opcionális listája), markdown (Markdown-jelentés hozzáadása). A kulcsot az x-api-key fejlécben küldje. A sitemap-alapú tömeges kérések a POST /v1/sitemap végpontot használják, és kulcsot igényelnek. OpenAPI-leírás.

Hogyan csatlakoztatok AI-ügynököt MCP-n keresztül?

Adjon hozzá egy távoli MCP-szervert az alábbi URL-lel (streamable HTTP), és küldje a kulcsát az x-api-key fejlécben. Eszközök: audit_url, audit_sitemap (legfeljebb 10 oldal) és explain_finding. Model Context Protocol dokumentáció.

{
  "mcpServers": {
    "aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
                  "headers": { "x-api-key": "asw_…" } }
  }
}

Hogyan néz ki egy találat?

{
  "id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
  "evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
  "fixes": [ { "kind": "cloudflare", "body": "…" } ]
}

Prioritások: a P1 azt jelenti, hogy az AI-válaszok nem tudják olvasni vagy idézni az oldalt, a P2 fontos, a P3 kívánatos vagy szabályzati döntés, például egy tanítási crawler blokkolása. A robots.txt-t az RFC 9309 szerint olvassuk. RFC 9309.

Melyek a korlátok?

A privát vagy belső címekre irányuló kéréseket elutasítjuk. Az nem auditálható oldalakat fetch.error vagy fetch.status találattal jelezzük.