MSSA (Mindsun Site Signal Audit) 是浙江思阳广告有限公司开源的 GEO 官网 AI 可读性体检工具。
别让精美官网在 AI 眼里变成空白页。
git clone https://github.com/AceSun0872/mindsun-mssa.git
cd mindsun-mssa
python3 -m mssa https://example.com --brand "Example Brand" --report zh你会立刻得到一份中文诊断：
- AI 爬虫是否进得来；
- 官网是不是 AI 眼里的空白页；
- 品牌核心事实是否能被提取；
- 结构化数据、
llms.txt、时效信号是否完善； - 哪些问题应该按 P0/P1/P2 优先修复。
Developers can keep the default JSON output:
python3 -m mssa https://example.com --brand "Example Brand"在 AI 全域普及的当下，很多品牌都忽略了一个隐形但关键的营销短板：
你的官网看似精美、合规、内容充足，却未必能被大模型精准读取、有效萃取核心信息，并作为权威来源引用。
传统 SEO 解决的是「用户能不能搜到你」。MSSA 聚焦的是 AI 时代的新命题：AI 会不会读懂你、信任你、引用你、推荐你。
传统 SEO 的核心服务对象是搜索引擎与人；GEO（Generative Engine Optimization，生成式引擎优化）面向的是 AI 问答、智能推荐和生成式流量入口。现实中，很多品牌官网视觉体验很好、SEO 指标达标、内容体量充足，但在 GPT、Claude、文心一言等大模型眼中，仍可能是「隐形、残缺、不可信」的。
脚本拦截、爬虫规则限制、结构化数据缺失、信息零散、时效模糊等问题，会让品牌官方阵地失去 AI 时代的核心话语权。MSSA 的价值，就是把这些 AI 难以识别的隐形漏洞，转化为可量化、可复盘、可落地修复的标准化信号，为品牌 GEO 布局打好底层基础。
如果你的品牌正面临以下困境，MSSA 是开启 GEO 诊断的第一步：
- AI 问答、智能推荐中频繁出现竞品品牌，自家品牌缺位或曝光不足；
- 大模型优先引用第三方旧资讯、小众平台内容，而不是品牌官网权威内容；
- 官网内容丰富、品类齐全，但 AI 萃取出的品牌总结空洞、片面，甚至出现信息偏差；
- 传统 SEO 工具检测达标，但大模型依旧无法精准识别、抓取、解读官网核心信息；
- 计划布局 GEO，却无法定位官网底层短板，不知道该从哪里优化。
MSSA 不制造虚假增长预期，也不承诺即时流量暴涨。它只做最基础也最关键的事：精准溯源 AI 读不懂、读不准、不引用品牌官网的根本原因，为后续 GEO 优化、内容升级、权威资产搭建提供数据支撑。
Most brands already have complete official websites, optimized SEO pages, official press releases, and product content, yet still face invisible brand loss in the AI era:
- AI prioritizes outdated third-party content instead of authoritative official website information;
- core brand assets, including latest products, parameters, pricing, qualifications, and positioning, are missed by LLMs;
- AI summarizes brand features with vague, generic, or wrong descriptions;
- valid website content is hidden by JavaScript rendering, WAF access rules, or weak page structure, causing LLM parsing failure;
- traditional SEO checks pass, but AI readability and citation capability remain weak.
MSSA helps brand, marketing, SEO, content, and technical teams locate AI visibility bottlenecks before they spend more money producing content that AI systems cannot reliably read or cite.
单次 MSSA 体检会输出标准化 JSON 检测结果，回答品牌官网 AI 适配中的关键问题：
- 主流 AI 爬虫（GPTBot、ClaudeBot 等）是否可正常访问、抓取官网页面；
- 官网内容是否依赖客户端 JavaScript 渲染，存在 AI 抓取空白或内容加载失效风险；
- 品牌名称、产品参数、定价体系、资质证书、品牌动态等核心事实是否可被机器萃取；
- Schema、JSON-LD、Open Graph 等结构化数据是否完善；
robots.txt、llms.txt、llms-full.txt等 AI 相关配置文件是否友好；- 官网内容时效性、权威性是否具备被 AI 引用的基础条件；
- 哪些问题属于 measurement gap，不能被假装成 0 分或满分。
MSSA 搭建了适配全球大模型、兼顾国内互联网生态的多维检测体系，覆盖官网 AI 适配的关键场景：
- AI crawler access 爬虫适配检测：覆盖 GPTBot、ClaudeBot、Bytespider、Baiduspider、PerplexityBot 等主流国内外 AI 爬虫访问行为与抓取权限；
- Parseability 内容可解析性：检测页面有效内容是否可独立读取，规避脆弱客户端渲染导致的内容抓取失效；
- Structured data 结构化数据检测：校验 JSON-LD、Schema.org、Open Graph 数据完整性与实体信息丰富度；
- Quotability 权威可引用性：判断页面内容是否具备清晰、独立、可溯源的 AI 引用级事实素材；
- Freshness 内容时效性：综合校验站点地图时间、
Last-Modified、结构化数据时间戳等时效信号； - Fact density 核心信息密度：检测品牌核心事实、产品参数、权威背书等关键信息的机器可提取密度；
- AI governance & agent readiness AI 生态适配：检测合规文件配置、WebMCP 端点及面向智能代理的前置信号；
- China-specific signals 国内生态专属检测：适配国内爬虫规则、ICP 站点信号、主流国内网站架构场景。
支持仓库直接运行检测，轻量部署，快速出结果。
基础检测命令：
python3 -m mssa https://example.com --brand "Example Brand"输出包含：综合得分、细分维度评分、优势加分项、核心测量缺口、探针检测数量，帮助你快速掌握官网 AI 适配全貌。
中文可读诊断：
python3 -m mssa https://example.com --brand "Example Brand" --report zh全量证据检测：
python3 -m mssa https://example.com --brand "Example Brand" --fullPython 程序化调用：
from mssa import audit_website
result = audit_website("https://example.com", brand="Example Brand")
print(result["score"], result["subscores"])回归测试套件运行：
python3 tests/test_mssa_http_visible_text.py
python3 tests/test_mssa_d5_score.py
python3 tests/test_mssa_v147_b_pack.pyMSSA 不只是一个 Python 检测包，也是一支即插即用的 Agent Skill。
这不是又一个传统 SEO checker，而是把思阳的 GEO 官网 AI 可读性诊断流程装进 Agent：用户只需要给出官网 URL，Agent 就能运行 MSSA，把 JSON 证据转成市场、内容、SEO、技术团队都能执行的 P0/P1/P2 修复清单。
本仓库根目录内置 SKILL.md，支持任何遵循 SKILL.md 目录约定的 Agent 使用；也可以将仓库打包为自定义 Skill 上传使用。
示例：
用 Mindsun MSSA 体检 https://example.com，看这个官网对 AI 友好吗
我们选择把 Skill 一起开源，是因为 GEO 需要一把公开、透明、可校验的体检尺子。工具免费开放，专业价值体现在基于诊断结果继续完成策略、内容、结构化资产与复测闭环。
GEO 作为 AI 时代全新的品牌流量运营赛道，目前行业尚未形成足够标准化、透明化的检测体系，大量品牌仍处在「盲目投入、无效优化、无法复盘」的阶段。
浙江思阳广告开源 MSSA，核心目的是为行业提供一套公开、透明、可校验的 GEO 官网诊断工具，帮助品牌看见「内容做了、钱花了、AI 不认」背后的技术与内容原因。
我们坚持开源透明，拒绝黑盒评分、拒绝模糊诊断，让每一项检测指标、每一个评分逻辑都可追溯、可校验、可优化。
清晰的价值边界，是我们的行业诚意：
- 免费开源的是「标准化体检尺子」：用户可以免费检测、自主排查官网 AI 适配问题，低成本建立 GEO 优化认知；
- 思阳广告的核心专业价值是「落地闭环服务」：依托 MSSA 诊断数据，为品牌提供策略定制、内容升级、结构化资产搭建、AI 权威引用布局、全周期复测优化的完整 GEO 解决方案；
- 开源赋能行业，专业创造价值：推动 GEO 行业标准化、规范化发展，让品牌 AI 营销的投入更精准、回报更可控。
严谨的工程工具，从不标榜完美。MSSA 的核心优势是贴合真实商业场景、可落地、可校验、尽量避免虚标。
核心优势：
- 统一 HTTP 底层处理逻辑，适配 Cookie、重定向、分段读取、异常状态码等复杂场景；
- 精准可视文本萃取，避免将空白 SPA 框架、冗余空白页面判定为有效内容；
- 聚焦 GEO 高风险漏洞与核心爬虫信号场景，规避无效检测；
- 标准化 JSON 输出格式，可对接 GEO 工作流、自动化系统，兼顾机器调用与人工复盘。
适用边界：
- 非浏览器环境下 JavaScript 渲染校验偏保守，对复杂渲染场景会如实反馈测量缺口，避免虚假高分误导用户；
- 评分权重是来自实战经验的实用框架，不是通用硬性行业准则；
- 工具聚焦品牌官网 AI 可读性体检，不覆盖全链路 AI 曝光、竞品对标、第三方权威舆情等完整 GEO 生态场景。
MSSA 是品牌入局 GEO 的免费诊断入口。完整的 AI 品牌曝光、权威引用、流量增长体系，仍需专业策略、落地执行与全周期迭代优化。
- 品牌市场部：快速排查官网是否为 GEO 流量增长的核心短板，为营销预算投放提供数据依据；
- SEO / 内容运营团队：挖掘传统 SEO 工具无法识别的 AI 适配漏洞，精准优化内容结构；
- 技术开发团队：将抽象的「AI 读取异常」转化为具象的技术优化清单，落地整改有据可依；
- GEO 行业从业者：依托透明化、标准化的检测工具，建立行业统一沟通语言，降低黑盒工具误差。
mssa/：MSSA 独立核心检测包，完整实现全维度体检能力；tests/：聚焦型回归测试用例，保障工具检测稳定性与准确性；examples/minimal_audit.py：极简程序化调用示例，方便二次开发；mssa/_http.py：统一 HTTP 底层调度核心文件，支撑爬虫检测。
MindSun（浙江思阳广告有限公司 / Zhejiang Siyang Advertising Co., Ltd.）长期深耕品牌 AI 全域营销与 GEO 生成式引擎优化领域，专注帮助品牌解决「AI 无曝光、无引用、负面解读、信息错位」等核心问题，打造品牌 AI 时代的权威身份体系。
我们的核心服务覆盖：GEO 全域策略规划、AI 品牌曝光测量、官网 AI 可读性优化、权威内容资产搭建、品牌 AI 引用追踪、商业化定制报告输出。
MSSA 是我们开放给行业的标准化工具，也是思阳完整 GEO 服务体系中的基础模块之一。
MSSA 采用 MIT License 开源协议发布。
你可以自由地使用、复制、修改、合并、发布、分发、再许可和/或出售本软件的副本，只需在所有副本或重要部分中包含版权声明和许可声明。
完整许可证文本请查看仓库根目录的 LICENSE 文件。