开源工具 OpenIngress：检测网站对 AI 智能体的可操作性

OpenIngress 是一款开源、自托管的网站「AI 智能体可操作性」检测工具。它通过浏览器模拟爬取、分析可访问性树，再借助 LLM 引导的任务探索，帮网站运营者发现哪些页面能被智能体顺利访问、哪些交互在何处中断，从而把「对搜索引擎友好」与「对 AI 智能体友好」区分开来。

背景：智能体浏览网站并不简单

随着 AI 智能体开始替用户完成浏览网页、点击按钮、填写表单等任务，网站即便在传统浏览器中显示正常，也可能对智能体并不友好：按钮缺少可读标签、内容依赖 JavaScript 异步加载、关键链接未出现在智能体可读取的页面结构中。OpenIngress 的出发点，就是把这种「看得见却点不动」的差距显式化，并以可读报告的形式呈现给运营者。

工作原理：四阶段流水线

工具整体分为四个阶段：

爬取（Crawl）：基于 Playwright 进行 BFS 式页面发现，采集 HTML、截图与 ARIA 快照，默认深度 3、最多 100 页。
分析（Analyze）：基于爬取产物做静态可操作性评估，构建导航图，并按预设分类法标注差距。
探索（Explore）：调用 BYOK（自备密钥）模式的 OpenAI 兼容 LLM，对页面目录发起可达性任务，生成执行轨迹与阻断证据。
报告（Report）：综合分析与探索结果，输出覆盖率、断点位置和 Markdown 报告。

技术栈与部署

API 层：Flask + Gunicorn
自动化层：Playwright（Chromium），Python 3.10+
探索层：支持 OpenAI、Azure、Gemini、Ollama 及本地代理等任意 OpenAI 兼容接口，默认模型 gpt-4o-mini
前端：Vue 3 + Vite
持久化：本地文件系统，可选 Supabase

部署上提供 make install、make backend、make frontend 三步启动，也支持 Docker 容器化（内置 Playwright）。仅需在 backend/.env 中配置 LLM_API_KEY 即可运行；AUTH_DISABLED 默认开启，便于本地体验。

适用场景与局限

适合：希望评估自家网站在 ChatGPT、Claude 等智能体浏览器中可访问性与可交互性的开发者与产品团队，用于发现无障碍标签缺失、关键内容未结构化、依赖 JS 的交互链路等问题。
不适合：需要实时监测大规模站点、或对内部系统（无公网入口）做黑盒测试的场景——其默认爬取边界为公网、深度有限，且探索阶段强依赖外部 LLM 完成。

项目以 MIT 协议开源，仓库内含后端、前端、文档与 Docker 镜像，完整说明见 SELF_HOST.md。