AISeeWhy API и MCP сервер

Пошаљите један POST са URL-ом на крајњу тачку за аудит и добијте JSON извештај: оцену од 0 до 100, налазе са приоритетом, доказе и готове исправке за лепљење, на било ком од 60 језика. AI агенти се повезују на MCP крајњу тачку и позивају audit_url. Без кључа плаћеног плана добијате преглед.

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

Како да позовем 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": "sr"}'

Поља: url (обавезно; https:// се додаје ако недостаје), language (код језика извештаја, подразумевано en), bots (необавезна листа назива краулера), markdown (додаје извештај у Markdown-у). Пошаљите свој кључ у заглављу x-api-key. Групне провере мапе сајта користе POST /v1/sitemap и захтевају кључ. OpenAPI опис.

Како да повежем AI агента преко MCP-а?

Додајте удаљени MCP сервер са URL-ом испод (streamable HTTP) и пошаљите свој кључ у заглављу x-api-key. Алати: audit_url, audit_sitemap (до 10 страница) и explain_finding. Документација за Model Context Protocol.

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

MCP алати: audit_url, audit_sitemap, compare_urls, crawl_site, watch_site, list_watched_sites, explain_finding.

Како да га користим из Claude Code, Codex или Cursor?

Повежите MCP сервер у свом агенту помоћу једног од исечака испод. Без кључа добијате бесплатни преглед; са кључем, потпуне извештаје. Затим питајте, на пример: „Могу ли ChatGPT и Perplexity да прочитају example.com/pricing? Пронађи шта их блокира и исправи то.”

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

Крајње тачке налога

Са пријављеном сесијом или API кључем налога: поновна провера и поређење извештаја, надгледање, групни аудити, линкови само за читање и провера серверског лога. Све су наведене у 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

Како да проверавам странице у CI-ју?

GitHub Action проверава preview деплој на сваком pull request-у и обара билд када је AI краулер блокиран или када оцена падне. Без кључа користи бесплатни преглед. 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

Како да прикажем оцену на свом сајту?

Додајте страницу у надгледање у свом налогу и копирајте њен беџ: малу слику са оценом уживо која води на AISeeWhy. Надгледање.

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

Како изгледа налаз?

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

Приоритети: P1 значи да AI одговори не могу да прочитају или цитирају страницу, P2 је важно, P3 је пожељно или ствар политике, на пример блокирање краулера за обуку. robots.txt се чита онако како је дефинисано у RFC 9309. RFC 9309.

Која су ограничења?

ПриступОграничење
Без кључа или налогаПреглед (први налаз), 1 провера дневно по мрежи
Плаћени план (сајт)Потпуни извештаји и историја: 30 провера дневно у плану Pro, 100 у плану Business, 200 у плану Agency, 300 у плану Enterprise
API кључ плаћеног плана (API и MCP)Потпуни извештаји: 100 аудита дневно у плану Pro, 300 у плану Business, 650 у плану Agency, 1.000 у плану Enterprise; групне провере мапе сајта до 50 URL-ова
Групни аудити према мапи сајтаДо 5.000 URL-ова по покретању, плаћање по провереном URL-у

Захтеви ка приватним или интерним адресама се одбијају. Странице на којима аудит није могућ пријављују се налазом fetch.error или fetch.status.

Питања о плановима, наплати или вашим подацима: support@aiseewhy.com