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}" } } } }Крайни точки за профила
С активна сесия или 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