API i serwer MCP AISeeWhy

Wyślij jedno żądanie POST z adresem URL do punktu końcowego audytu i odbierz raport JSON: wynik w skali 0–100 oraz znaleziska z priorytetem, dowodami i gotowymi poprawkami, w dowolnym z 30 języków. Agenci AI łączą się z punktem końcowym MCP i wywołują audit_url. Bez klucza Pro lub próbnego dostajesz podgląd.

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

Jak wywołać API?

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

Pola: url (wymagane; https:// jest dodawane, gdy go brak), language (kod języka raportu, domyślnie en), bots (opcjonalna lista nazw crawlerów), markdown (dodaje raport w Markdown). Klucz wysyłaj w nagłówku x-api-key. Audyty zbiorcze według mapy witryny używają POST /v1/sitemap i wymagają klucza. Opis OpenAPI.

Jak połączyć agenta AI przez MCP?

Dodaj zdalny serwer MCP z poniższym adresem URL (streamable HTTP) i wysyłaj klucz w nagłówku x-api-key. Narzędzia: audit_url, audit_sitemap (do 10 stron) i explain_finding. Dokumentacja Model Context Protocol.

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

Jak wygląda znalezisko?

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

Priorytety: P1 oznacza, że odpowiedzi AI nie mogą odczytać ani zacytować strony, P2 jest ważny, P3 to rzecz opcjonalna lub kwestia polityki, na przykład blokada crawlera trenującego. Plik robots.txt jest odczytywany zgodnie z RFC 9309. RFC 9309.

Jakie są limity?

Żądania do adresów prywatnych lub wewnętrznych są odrzucane. Strony, których nie można sprawdzić, są zgłaszane jako znalezisko fetch.error lub fetch.status.