API và máy chủ MCP của AISeeWhy

Gửi một POST kèm URL đến endpoint kiểm tra để nhận báo cáo JSON: điểm từ 0–100, phát hiện có mức ưu tiên, bằng chứng và cách khắc phục sẵn dùng, bằng 30 ngôn ngữ. Tác nhân AI kết nối endpoint MCP và gọi audit_url. Không có khóa Pro hoặc khóa dùng thử, bạn chỉ xem được bản xem trước.

POST https://api.aiseewhy.com/v1/audit · https://api.aiseewhy.com/mcp

Gọi API như thế nào?

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

Các trường: url (bắt buộc; tự thêm https:// nếu thiếu), language (mã ngôn ngữ báo cáo, mặc định en), bots (danh sách tên trình thu thập, tùy chọn), markdown (thêm báo cáo Markdown). Gửi khóa trong header x-api-key. Kiểm tra hàng loạt theo sitemap dùng POST /v1/sitemap và cần khóa. Mô tả OpenAPI.

Kết nối tác nhân AI qua MCP như thế nào?

Thêm máy chủ MCP từ xa với URL bên dưới (streamable HTTP) và gửi khóa trong header x-api-key. Công cụ: audit_url, audit_sitemap (tối đa 10 trang) và explain_finding. Tài liệu Model Context Protocol.

{
  "mcpServers": {
    "aiseewhy": { "type": "http", "url": "https://api.aiseewhy.com/mcp",
                  "headers": { "x-api-key": "asw_…" } }
  }
}

Một phát hiện trông như thế nào?

{
  "id": "access.blocked", "priority": "P1", "bot": "OAI-SearchBot", "bot_class": "search",
  "evidence": { "status": 403, "control_status": 200, "waf": "cloudflare" },
  "fixes": [ { "kind": "cloudflare", "body": "…" } ]
}

Mức ưu tiên: P1 nghĩa là câu trả lời AI không thể đọc hoặc trích dẫn trang, P2 là quan trọng, P3 là nên có hoặc là lựa chọn chính sách, ví dụ chặn một trình thu thập huấn luyện. robots.txt được đọc theo định nghĩa trong RFC 9309. RFC 9309.

Giới hạn là gì?

Yêu cầu đến địa chỉ riêng tư hoặc nội bộ sẽ bị từ chối. Các trang không thể kiểm tra được báo cáo bằng phát hiện fetch.error hoặc fetch.status.