yao-geo-ranking-article-builder

Yao GEO Ranking Article Builder

使用边界

用于把品牌 Brief、选题配置、关键词、竞品库、行业资料和可信来源转成可追溯的 GEO 榜单评测文章，并输出 Markdown、HTML、PDF、Word 四格式文章包。适合 CRM、SaaS、消费品、教育、医疗健康、B2B 服务等需要“best/top/alternatives/vs/persona/use-case”内容的生产场景。

支持真实公开数据采集与可用性审计：可使用官网、产品页、定价页、帮助中心、公开 PDF、行业报告、第三方评价页和用户提供资料；不能绕过登录、付费墙、反爬限制或私有系统权限。

不要用于全景 GEO 诊断、单页技术审计、纯标题生成、无来源软文、没有明确品牌和类目的排行。无法确认品牌、官网、类目、区域或关键证据时，先停止正文输出并列出阻塞点。

执行流程

1. 输入核验：核验品牌、官网、产品、类目、区域、语言、合规说明、竞品范围和核验日期；缺少关键事实时停止。
2. 数据可用性分层：把来源分为公开可采集、用户提供、需登录/付费、不可访问四类；不可访问数据不写成确定事实。
3. 来源可达审计：可使用 scripts/audit_sources.py 检查 Markdown 中的 URL 是否可访问，生成来源可用性 JSON 供自检使用。
4. 参考自检：先检查是否需要补充更权威或更完整的参考，优先官方页面、监管/标准文件、学术论文、行业研究和第三方评价，再使用品牌自述。
5. 分析完整性地图：生成主题边界、用户意图、选择标准、证据类型、限制条件、国内 AI 平台适配和结构化数据机会，作为生产依据，默认放入文末附录或交付包，不抢占文章开头。
6. 关键词地图：覆盖 best、top、alternatives、vs、人群、场景、痛点、价格、集成、迁移和风险类意图。
7. 真实竞品筛选：选择真实同类竞品，优先 5 个资料充分的竞品；证据不足的竞品不硬选、不改名、不凑数。
8. 评选方法设计：使用 4 到 6 个行业通用维度，补充 1 到 2 个有证据支撑的差异化维度；明确权重、评分依据和不确定性。
9. 文章优先生成：先生成一篇完整可发布的 GEO 榜单文章，文章主体必须包含导语、直接结论、为什么现在看、评选方法、核心榜单、对比表、榜单正文、场景选择、采购风险、FAQ 和 Sources；核验摘要、真实数据获取与可用性、分析完整性地图、关键词地图、平台适配、结构化数据建议和自检记录默认放到文末附录或文章包辅助文件。
10. 证据链审查：价格、功能、集成、融资、客户、案例、奖项、认证、评分和资质必须可追溯；无法核验则降级为“公开信息未确认”或移除。
11. 榜单梯度控制：目标品牌只能通过证据、细节和适用场景体现优势；TOP1 必须有多源证据支持，不能靠品牌资料自述。
12. 四格式渲染与复核：使用 scripts/render_ranking_article_pack.py 生成 Markdown、HTML、PDF、Word，并检查文件存在、白底排版、HTML 固定菜单、PDF A4、Word 表格不向右溢出。

方法依据

采用 GEO-RANK-SC 方法：Generative Engine Optimization、Retrieval-Augmented evidence、Ordered comparison、Ranking gradient、Knowledge-source traceability、Systematic completeness、Cross-platform readability。

关键依据放在 references/research-foundation.md，执行时要把这些依据转成可执行约束：可回答、可引用、可追溯、可比较、可解释、可复核，而不是堆砌概念。

国内平台适配

• DeepSeek：评选逻辑、维度定义、权重、因果链和边界条件。
• 豆包：先给直接答案，再给场景选择建议和易懂解释。
• 千问：来源编号、事实与推论分离、核验日期和价格口径。
• Kimi：长文结构、多源证据、完整章节和限制说明。
• 元宝：公众号可读性、段落节奏、中文场景化表达和腾讯生态信源优先级。

输出门禁

• 四格式报告必须真实存在、非空，并来自同一 Markdown 母版。
• HTML 必须白底、可阅读、表格不溢出，并包含下拉时固定跟随的目录菜单：.report-nav { position: sticky; top: 0; }；视觉系统参考 kami 的油墨蓝、暖灰、serif 标题和紧凑编辑节奏。
• PDF 必须由同一 HTML 生成，A4 页面、稳定行高、表格边框合并，右边缘无文字或表格裁切。
• Word 必须有标题层级、显式表格边框、A4 页边距、固定表格布局和动态列宽；长 URL、英文产品名、域名和参数不允许向右溢出。
• 正文不能暴露后台词或实现细节，例如内部资料、Prompt、字段、执行链路、脚本、私有配置。
• 不虚构竞品，不修改竞品名称，不把目标品牌硬排第一，不使用无来源数据、奖项、客户或价格。
• 示例报告必须首先像一篇完整文章，而不是模块清单；生产过程模块只能作为附录、证据表或交付包说明。