AISeeWhy API ja MCP-palvelin

Lähetä yksi POST-pyyntö, jossa on URL, tarkistuspäätepisteeseen, ja saat takaisin JSON-raportin: pistemäärän 0–100 sekä kaikki havainnot tärkeysluokkineen, todisteineen ja valmiine korjauksineen, millä tahansa 30 kielestä. Tekoälyagentit yhdistävät MCP-päätepisteeseen ja kutsuvat audit_url-työkalua. Ilman Pro- tai kokeiluavainta saat vain esikatselun, jossa näkyy ensimmäinen havainto.

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

Miten kutsun API:a?

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

Kentät: url (pakollinen; https:// lisätään, jos puuttuu), language (raportin kielikoodi, oletus en), bots (valinnainen lista robottien nimistä), markdown (lisää Markdown-raportti). Lähetä avaimesi x-api-key-otsakkeessa. Sivustokarttaerät käyttävät POST /v1/sitemap ja vaativat avaimen. OpenAPI-kuvaus.

Miten yhdistän tekoälyagentin MCP:n kautta?

Lisää etä-MCP-palvelin alla olevalla URL:lla (streamable HTTP) ja lähetä avaimesi x-api-key-otsakkeessa. Työkalut: audit_url, audit_sitemap (enintään 10 sivua) ja explain_finding. Model Context Protocolin dokumentaatio.

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

Miltä havainto näyttää?

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

Tärkeysluokat: P1 tarkoittaa, että tekoälyvastaukset eivät voi lukea tai lainata sivua, P2 on tärkeä, P3 on hyvä lisä tai linjausvalinta, esimerkiksi koulutusrobotin estäminen. robots.txt luetaan RFC 9309:n määrittelemällä tavalla. RFC 9309.

Mitkä ovat rajat?

Pyynnöt yksityisiin tai sisäisiin osoitteisiin hylätään. Sivut, joita ei voi tarkistaa, raportoidaan fetch.error- tai fetch.status-havainnolla.