API i servidor MCP d'AISeeWhy
Envia un POST amb una URL al punt d'accés d'auditoria i rep un informe JSON: una puntuació de 0 a 100, troballes amb prioritat, proves i correccions a punt per enganxar, en qualsevol de 60 idiomes. Els agents d'IA es connecten al punt d'accés MCP i criden audit_url. Sense la clau d'un pla de pagament obtens una vista prèvia.
POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp
Com crido l'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": "ca"}' Camps: url (obligatori; s'afegeix https:// si falta), language (codi de l'idioma de l'informe, per defecte en), bots (llista opcional de noms de rastrejadors), markdown (afegeix un informe en Markdown). Envia la clau a la capçalera x-api-key. Els lots per sitemap fan servir POST /v1/sitemap i necessiten una clau. Descripció OpenAPI.
Com connecto un agent d'IA per MCP?
Afegeix un servidor MCP remot amb la URL de sota (HTTP en streaming) i envia la clau a la capçalera x-api-key. Eines: audit_url, audit_sitemap (fins a 10 pàgines) i explain_finding. Documentació del Model Context Protocol.
{
"mcpServers": {
"aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
"headers": { "x-api-key": "asw_…" } }
}
} Eines MCP: audit_url, audit_sitemap, compare_urls, crawl_site, watch_site, list_watched_sites, explain_finding.
Com el faig servir des de Claude Code, Codex o Cursor?
Connecta el servidor MCP al teu agent amb un dels fragments de sota. Sense clau obtens la vista prèvia gratuïta; amb clau, informes complets. Després demana, per exemple: «ChatGPT i Perplexity poden llegir example.com/pricing? Troba què els bloqueja i corregeix-ho.»
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}" } } } }Punts d'accés del compte
Amb una sessió iniciada o una clau d'API del compte: tornar a comprovar i comparar informes, monitoratge, auditories massives, enllaços de només lectura i la comprovació de registres del servidor. Tots apareixen a la descripció 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 Com comprovo pàgines a la CI?
La GitHub Action comprova un desplegament de previsualització a cada pull request i fa fallar la compilació quan un rastrejador d'IA queda bloquejat o la puntuació baixa. Sense clau fa servir la vista prèvia gratuïta. 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 Com mostro la puntuació al meu lloc?
Afegeix la pàgina al monitoratge del teu compte i copia'n la insígnia: una imatge petita amb la puntuació en directe que enllaça a AISeeWhy. Monitoratge.
<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>
Com és una troballa?
{
"id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
"evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
"fixes": [ { "kind": "cloudflare", "body": "…" } ]
} Prioritats: P1 vol dir que les respostes d'IA no poden llegir ni citar la pàgina, P2 és important, P3 és recomanable o una decisió de política, per exemple bloquejar un rastrejador d'entrenament. robots.txt es llegeix tal com el defineix l'RFC 9309. RFC 9309.
Quins són els límits?
| Accés | Límit |
|---|---|
| Sense clau ni compte | Vista prèvia (primera troballa), 1 comprovació al dia per xarxa |
| Pla de pagament (lloc web) | Informes complets i historial: 30 comprovacions al dia amb Pro, 100 amb Business, 200 amb Agency, 300 amb Enterprise |
| Clau d'API d'un pla de pagament (API i MCP) | Informes complets: 100 auditories al dia amb Pro, 300 amb Business, 650 amb Agency, 1.000 amb Enterprise; lots per sitemap de fins a 50 URL |
| Auditories per lots amb sitemap | Fins a 5.000 URL per execució, es paga per URL auditada |
Es rebutgen les peticions a adreces privades o internes. Les pàgines que no es poden auditar es marquen amb una troballa fetch.error o fetch.status.
Preguntes sobre plans, facturació o les teves dades: support@aiseewhy.com