API a MCP server AISeeWhy

Pošlite jeden POST s URL na endpoint auditu a dostanete správu v JSON: skóre 0–100, zistenia s prioritou, dôkazmi a hotovými opravami na vloženie, v ktoromkoľvek zo 60 jazykov. AI agenti sa pripájajú k MCP endpointu a volajú audit_url. Bez kľúča plateného plánu dostanete ukážku.

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

Ako volať 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": "sk"}'

Polia: url (povinné; ak chýba https://, doplní sa), language (kód jazyka správy, predvolene en), bots (voliteľný zoznam názvov crawlerov), markdown (pridá správu v Markdowne). Kľúč pošlite v hlavičke x-api-key. Hromadné audity podľa sitemapy používajú POST /v1/sitemap a vyžadujú kľúč. Popis OpenAPI.

Ako pripojiť AI agenta cez MCP?

Pridajte vzdialený MCP server s URL uvedenou nižšie (streamable HTTP) a kľúč pošlite v hlavičke x-api-key. Nástroje: audit_url, audit_sitemap (až 10 stránok) a explain_finding. Dokumentácia Model Context Protocol.

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

MCP nástroje: audit_url, audit_sitemap, compare_urls, crawl_site, watch_site, list_watched_sites, explain_finding.

Ako to použiť z Claude Code, Codexu alebo Cursoru?

Pripojte MCP server vo svojom agentovi jedným z úryvkov nižšie. Bez kľúča dostanete ukážku zadarmo, s kľúčom úplné správy. Potom sa opýtajte napríklad: „Dokážu ChatGPT a Perplexity prečítať example.com/pricing? Zisti, čo ich blokuje, a oprav to.“

Claude Code

# plugin: MCP server and skills (github.com/aiseewhy/aiseewhy-plugin)
/plugin marketplace add aiseewhy/aiseewhy-plugin
/plugin install aiseewhy@aiseewhy
claude mcp add --transport http aiseewhy https://api.aiseewhy.com/mcp   --header "x-api-key: asw_…"

Codex

# ~/.codex/config.toml
[mcp_servers.aiseewhy]
url = "https://api.aiseewhy.com/mcp"
http_headers = { "x-api-key" = "asw_…" }

Cursor

// .cursor/mcp.json
{ "mcpServers": { "aiseewhy": { "url": "https://api.aiseewhy.com/mcp",
  "headers": { "x-api-key": "${env:AISEEWHY_API_KEY}" } } } }

mcptry

Endpointy účtu

S prihlásenou reláciou alebo API kľúčom účtu: opakovaná kontrola a porovnanie správ, monitorovanie, hromadné audity, odkazy len na čítanie a kontrola serverových logov. Všetky sú uvedené v popise OpenAPI.

POST https://api.aiseewhy.com/v1/me/reports/{id}/recheck     GET  https://api.aiseewhy.com/v1/me/reports/{id}/diff/{other}
POST https://api.aiseewhy.com/v1/compare                     POST https://api.aiseewhy.com/v1/me/sites
POST https://api.aiseewhy.com/v1/me/bulk                     GET  https://api.aiseewhy.com/v1/me/bulk/{id}/csv
POST https://api.aiseewhy.com/v1/me/crawl                    GET  https://api.aiseewhy.com/v1/me/crawl/{id}/csv
POST https://api.aiseewhy.com/v1/me/reports/{id}/share       POST https://api.aiseewhy.com/v1/me/logs
POST https://api.aiseewhy.com/v1/me/keys                     POST https://api.aiseewhy.com/v1/me/visibility
GET  https://api.aiseewhy.com/v1/me/visibility/{id}/csv      POST https://api.aiseewhy.com/v1/me/seo/keywords
POST https://api.aiseewhy.com/v1/me/seo/rank                 POST https://api.aiseewhy.com/v1/me/seo/domain
POST https://api.aiseewhy.com/v1/me/seo/backlinks            POST https://api.aiseewhy.com/v1/me/gsc/query
POST https://api.aiseewhy.com/v1/me/links                    GET  https://api.aiseewhy.com/v1/me/links/{id}/csv
POST https://api.aiseewhy.com/v1/me/seo/offsite              POST https://api.aiseewhy.com/v1/me/seo/business

Ako kontrolovať stránky v CI?

GitHub Action skontroluje náhľadové nasadenie pri každom pull requeste a zastaví build, keď je zablokovaný AI crawler alebo klesne skóre. Bez kľúča používa ukážku zadarmo. GitHub Marketplace.

- uses: aiseewhy/check-action@v1
  with:
    url: ${{ steps.deploy.outputs.preview-url }}
    api-key: ${{ secrets.AISEEWHY_API_KEY }}  # optional
    fail-on: P1        # P1, P2, P3 or none
    min-score: 70

Ako zobraziť skóre na svojom webe?

Pridajte stránku do monitorovania vo svojom účte a skopírujte jej odznak: malý obrázok s aktuálnym skóre, ktorý odkazuje na AISeeWhy. Monitorovanie.

<a href="https://aiseewhy.com/"><img src="https://api.aiseewhy.com/v1/badge/….svg" alt="AI-readable score by AISeeWhy" width="128" height="20"></a>

Ako vyzerá zistenie?

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

Priority: P1 znamená, že AI odpovede nemôžu stránku prečítať ani citovať, P2 je dôležité, P3 je užitočné vylepšenie alebo vec politiky, napríklad blokovanie tréningového crawlera. robots.txt sa číta podľa RFC 9309. RFC 9309.

Aké sú limity?

PrístupLimit
Bez kľúča a účtuUkážka (prvé zistenie), 1 kontrola denne na sieť
Platený plán (web)Úplné správy a história: 30 kontrol denne v Pro, 100 v Business, 200 v Agency, 300 v Enterprise
API kľúč plateného plánu (API a MCP)Úplné správy: 100 auditov denne v Pro, 300 v Business, 650 v Agency, 1 000 v Enterprise; hromadné audity podľa sitemapy až do 50 URL
Hromadné audity podľa sitemapyAž 5 000 URL na jedno spustenie, platba za každú auditovanú URL

Požiadavky na súkromné alebo interné adresy sa odmietajú. Stránky, ktoré nie je možné auditovať, sa vykážu so zistením fetch.error alebo fetch.status.

Otázky k plánom, platbám alebo vašim údajom: support@aiseewhy.com