API и MCP сървър на AISeeWhy

Изпратете един 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": "bg"}'

Полета: 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 заявка и проваля компилацията, когато 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, 1000 в Enterprise; пакети по карта на сайта до 50 URL адреса
Пакетни одити по карта на сайтаДо 5000 URL адреса на изпълнение, плащане за всеки проверен URL

Заявките към частни или вътрешни адреси се отказват. Страниците, които не могат да бъдат проверени, се отчитат с находка fetch.error или fetch.status.

Въпроси за плановете, плащанията или данните ви: support@aiseewhy.com