必须将MarsCode接口文档中“用户登录”“数据查询”等普通标题替换为含核心动词、主语、场景的SEO标题，如“获取MarsCode用户信息API｜v2.3身份服务接口文档”，并紧随其后插入JSON-LD结构化标记以提升AI识别与搜索曝光。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把MarsCode接口文档中那些只写“用户登录”“数据查询”的普通标题，替换成能被搜索引擎识别、带关键词、有点击吸引力的SEO标题，否则开发者搜不到、AI模型也抓不全。
确认原始标题是否符合SEO基础要求
打开MarsCode接口文档源文件（通常是Markdown或JSON Schema），定位所有一级/二级标题（如# 用户认证、## getToken）。逐条检查：是否含核心动词+名词组合（如“获取Token”比“认证”更明确）、是否遗漏主语（如“调用方式”应改为“MarsCode API调用方式”）、是否出现模糊词（如“相关接口”“其他操作”必须重写）。
【必须删除所有无主语、无动词、无对象的标题短语，例如“注意事项”“补充说明”，它们对SEO无效且干扰大纲结构】
用三步法批量改写标题
第一步：提取每个接口的核心功能动词与实体对象。例如原标题“获取用户信息”→动词是“获取”，对象是“用户信息”，所属系统是“MarsCode身份服务”。
第二步：套入SEO标题公式：“动词 + 对象 + 场景/系统标识 + （可选：版本号）”。生成候选标题：“获取MarsCode用户信息API｜v2.3身份服务接口文档”。
第三步：人工校验长度与关键词密度。中文标题控制在28字以内（含标点），确保首8个字符含核心词（如“获取MarsCode用户…”比“MarsCode用户信息获取…”更优），删掉冗余助词（“的”“之”“相关”）。
针对不同接口类型做差异化处理
方法一：认证类接口（login、token、oauth）→ 强制前置品牌词。示例：“MarsCode OAuth2.0授权接入指南｜支持GitHub/企业微信扫码登录”。
方法二：数据类接口（query、list、search）→ 绑定典型使用场景。示例：“MarsCode项目数据实时查询API｜适用于CI/CD状态监控与看板集成”。
方法三：错误码与状态码页→ 改为问题导向标题。原“错误码列表”改为“MarsCode API常见报错代码详解｜401未授权/429限流/503服务不可用排查手册”。
自动注入Schema标记增强AI识别
在每个改写后的标题下方，紧贴插入JSON-LD结构化代码块（无需换行），内容包含@type: "WebAPI"、name字段填入新SEO标题、description字段用一句话说明用途。这一步能让大模型在抓取时直接识别该页面为API文档页，而非普通说明页。
这一步操作起来很简单，直接把生成好的JSON-LD复制粘贴到对应标题的下一行即可。
