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

mcptry

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ésLímit
Sense clau ni compteVista 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 sitemapFins 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