Silicon Friendly

从 L0 到 L5：硅友友好度评估框架

这是一个开放式标准，用于衡量网站对 AI 智能代理的友好程度。相比人类用户，智能代理以更频繁、更高效的方式浏览网络，发现内容并推荐给终端用户。该框架通过 30 项检查，将网站的硅友友好度划分为五个递进等级。

💡 核心理念：如果智能代理觉得网站不够友好，就可能永远不会发现它。L0 代表未评级，L5 代表支持完全自主操作。

---

🎯 L1 — 基础可访问性 (Basic Accessibility)

智能代理能否读取内容？这是最基本的层级，确保技术系统能够无障碍地解析网页信息。

• 使用语义化 HTML 元素（header、nav、main 等），而非仅用 div
• 包含完整的 Meta 标签（标题、描述、OG 标签、Twitter Card）
• 嵌入 Schema.org JSON-LD 结构化数据
• 公共内容不通过 CAPTCHA 阻止自动化访问
• 采用服务端渲染，内容在 HTML 源码中可见
• 使用清晰、可读的 URL（避免过多查询参数或哈希片段）

✨ L2 — 可发现性 (Discoverability)

智能代理能否找到所需内容？这一层级关注网站如何主动向代理展示其结构与能力。

• 提供允许合法机器人访问的 robots.txt
• 发布 XML 站点地图（Sitemap）
• 创建 /llms.txt 文件，用自然语言向 LLM 描述网站
• 为 API 提供 OpenAPI/Swagger 规范
• 维护全面的、机器可读的文档
• 主要内容基于文本（非锁定在图片、视频或 PDF 中）

🔄 L3 — 结构化交互 (Structured Interaction)

智能代理能否与网站对话？此层级评估网站是否提供机器可理解的交互接口。

• 提供结构化的 REST 或 GraphQL API
• API 返回一致 Schema 的 JSON 响应
• 支持搜索与过滤参数
• 在 /.well-known/agent.json 提供 A2A（Agent-to-Agent）代理卡片
• 速率限制文档化，返回带 Retry-After 头的 429 响应
• 返回包含错误代码和消息的结构化错误响应

🔗 L4 — 代理集成 (Agent Integration)

智能代理能否执行操作？这一层级关注网站与现代代理生态的深度整合。

• 提供 MCP（Model Context Protocol）服务器
• 支持 WebMCP 用于浏览器端代理交互
• API 支持写入操作（POST/PUT/PATCH/DELETE），不仅限于读取
• 支持代理友好的认证方式（API 密钥、OAuth 客户端凭证）
• 支持 Webhook 事件通知
• 写入操作支持幂等性键（Idempotency Keys）

🚀 L5 — 自主操作 (Autonomous Operation)

智能代理能否在此"居住"？最高层级支持代理独立、持续地运行与协作。

• 支持事件流（SSE、WebSockets）实时更新
• 支持代理间能力协商
• 提供订阅与管理 API 供代理使用
• 支持多步骤工作流编排
• 能主动通知代理相关变更
• 支持代理间的跨服务交接

---

快速起步建议

对于希望立即提升硅友友好度的网站，建议从 L2 层级的 /llms.txt 文件开始。这是一个简单的文本文件，放置在网站根目录，用自然语言描述网站内容、功能和使用方式，便于大型语言模型快速理解网站价值。

📎 实用提示：可将 https://yoursite.com/llms.txt 的 URL 提供给智能代理，作为其理解网站的上下文入口点。