用途：修复 IsAgentReady.com 扫描中 Category 4（Agent Protocols，15% 权重）的问题，让 AI 智能体可通过标准化协议发现并使用网站功能。适用于含表单或交互功能、需被智能体调用的 API、需对外声明能力的智能体服务，或扫描得分偏低时。纯静态无交互站点不适用；安全头、结构化数据、语义 HTML、robots.txt 等应使用其他技能。
主要能力与检查点：4.1 WebMCP 声明式 API（25 分），表单需同时含 tool-name 与 tool-description 属性，仅页面清单得 15 分，仅命令式 API 得 10 分；4.2 WebMCP 清单（10 分），需在 /.well-known/webmcp 或 /.well-known/webmcp.json 提供有效 JSON；4.3 A2A Agent Card（25 分），/.well-known/agent.json 需含 name、description、url、capabilities 四个字段，缺 capabilities 降至 15 分；4.4 MCP 发现（10 分），/.well-known/mcp.json 需为非空 JSON 对象；4.5 OpenAPI（20 分），OpenAPI 3.x 满分，Swagger 2.x 得 15 分，HTML 响应不计；4.6 agents.json（10 分），/.well-known/agents.json 或 /agents.json 需为非空 JSON。
使用方式：先根据扫描结果定位失败检查点，判断适用协议，按各检查点工作流修改代码，将文件部署到对应 well-known 路径并确保返回 Content-Type: application/json，且不被 WAF、CDN 或中间件拦截，最后重新扫描验证。
限制与注意：tool-name 单独存在不得分；空 JSON 对象或数组会失败；API 端点返回 HTML 会被忽略；Swagger 2.x 仅部分得分。具体命令与完整代码示例见原文，本处不重复。