AISeeWhy API i MCP poslužitelj

Pošaljite jedan POST s URL-om na krajnju točku za reviziju i dobit ćete JSON izvještaj: ocjenu 0–100, nalaze s prioritetom, dokazima i gotovim ispravcima za lijepljenje, na bilo kojem od 60 jezika. AI agenti spajaju se na MCP krajnju točku i pozivaju audit_url. Bez ključa plaćenog plana dobivate pregled.

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

Kako pozvati 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": "hr"}'

Polja: url (obavezno; https:// se dodaje ako nedostaje), language (kod jezika izvještaja, zadano en), bots (neobavezan popis naziva crawlera), markdown (dodaje izvještaj u Markdownu). Ključ pošaljite u zaglavlju x-api-key. Paketi prema sitemapu koriste POST /v1/sitemap i zahtijevaju ključ. OpenAPI opis.

Kako povezati AI agenta preko MCP-a?

Dodajte udaljeni MCP poslužitelj s URL-om u nastavku (streamable HTTP) i pošaljite ključ u zaglavlju x-api-key. Alati: audit_url, audit_sitemap (do 10 stranica) i explain_finding. Dokumentacija za Model Context Protocol.

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

MCP alati: audit_url, audit_sitemap, compare_urls, crawl_site, watch_site, list_watched_sites, explain_finding.

Kako ga koristiti iz Claude Codea, Codexa ili Cursora?

Povežite MCP poslužitelj u svom agentu jednim od isječaka u nastavku. Bez ključa dobivate besplatni pregled; s ključem, potpune izvještaje. Zatim pitajte, na primjer: „Mogu li ChatGPT i Perplexity pročitati example.com/pricing? Pronađi što ih blokira i ispravi 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

Krajnje točke računa

S prijavljenom sesijom ili API ključem računa: ponovna provjera i usporedba izvještaja, praćenje, skupne revizije, poveznice samo za čitanje i provjera zapisnika poslužitelja. Sve su navedene u OpenAPI opisu.

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

Kako provjeravati stranice u CI-ju?

GitHub Action provjerava pretpregledno postavljanje (preview deployment) na svakom pull requestu i ruši build kad je neki AI crawler blokiran ili ocjena padne. Bez ključa koristi besplatni pregled. 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

Kako prikazati ocjenu na svojoj web-stranici?

Dodajte stranicu u praćenje u svom računu i kopirajte njezinu značku: malu sliku s trenutačnom ocjenom koja vodi na AISeeWhy. Praćenje.

<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>

Kako izgleda nalaz?

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

Prioriteti: P1 znači da AI odgovori ne mogu pročitati ni citirati stranicu, P2 je važno, P3 je poželjno ili stvar pravila, na primjer blokiranje crawlera za treniranje. robots.txt se čita kako je definirano u RFC 9309. RFC 9309.

Koja su ograničenja?

PristupOgraničenje
Bez ključa ili računaPregled (prvi nalaz), 1 provjera dnevno po mreži
Plaćeni plan (web-stranica)Potpuni izvještaji i povijest: 30 provjera dnevno na planu Pro, 100 na planu Business, 200 na planu Agency, 300 na planu Enterprise
API ključ plaćenog plana (API i MCP)Potpuni izvještaji: 100 revizija dnevno na planu Pro, 300 na planu Business, 650 na planu Agency, 1.000 na planu Enterprise; paketi prema sitemapu do 50 URL-ova
Paketne revizije prema sitemapuDo 5.000 URL-ova po pokretanju, plaćanje po revidiranom URL-u

Zahtjevi prema privatnim ili internim adresama se odbijaju. Stranice koje se ne mogu revidirati prijavljuju se nalazom fetch.error ili fetch.status.

Pitanja o planovima, naplati ili vašim podacima: support@aiseewhy.com