AISeeWhy API 및 MCP 서버

감사 엔드포인트에 URL을 담아 POST를 한 번 보내면 0~100점 점수와 우선순위, 증거, 바로 붙여 넣을 수 있는 수정안이 담긴 발견 사항을 JSON 보고서로 30개 언어 중 원하는 언어로 받을 수 있습니다. AI 에이전트는 MCP 엔드포인트에 연결해 audit_url을 호출합니다. Pro 또는 체험 키가 없으면 미리보기만 제공됩니다.

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": "ko"}'

필드: url(필수, 없으면 https:// 자동 추가), language(보고서 언어 코드, 기본값 en), bots(크롤러 이름 목록, 선택), markdown(Markdown 보고서 추가). 키는 x-api-key 헤더로 보내세요. 사이트맵 일괄 감사는 POST /v1/sitemap을 사용하며 키가 필요합니다. OpenAPI 설명.

MCP로 AI 에이전트를 연결하려면 어떻게 하나요?

아래 URL로 원격 MCP 서버(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_…" } }
  }
}

발견 항목은 어떤 모습인가요?

{
  "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.

한도는 어떻게 되나요?

비공개 주소나 내부 주소로의 요청은 거부됩니다. 감사할 수 없는 페이지는 fetch.error 또는 fetch.status 항목으로 보고됩니다.