Client onboarding proposal 是一个面向代理机构的启动提案生成技能，用于在新客户合作开始时，产出一份基于真实数据的提案文档。其核心是把 SE Ranking 的 SEO + AI 搜索审计，与 Planable 的社交表现分析结合起来，形成对客户现状的诚实评估，以及清晰、有范围界定的服务计划。
用途
该技能定位为“启动/早期合作提案”，而非冷启动推销。它假设客户社交页面已连接到 Planable 工作区，以便分析真实表现。若没有该访问权限，社交部分无法基于数据产出，只能做 SE Ranking 侧的分析。
前置条件
使用前需要满足以下条件：
- SE Ranking MCP 已连接（Data API 用于研究与审计；项目可选，可通过 PROJECT_listAudits 复用已完成的审计，而无需重新爬取）。
- Planable MCP 已连接，且客户工作区与已连接的社交页面可用。
- 用户需提供：客户域名 + 品牌、市场/国家（默认 us）、2–4 个竞争对手、Planable 工作区。可选提供合作目标（例如线索获取、品牌、本地）。
连接器健康检查
开始前先验证两个 MCP 是否可达：
- SE Ranking：调用 DATA_getSubscription。若失败或返回认证错误，立即停止并告知用户：
“The SE Ranking connector isn't responding — please reconnect it before we continue. Setup guide: https://seranking.com/api/integrations/mcp/”
- Planable：调用 list_workspaces。若失败或返回认证错误，立即停止并告知用户：
“The Planable connector isn't responding — please reconnect it before we continue. Setup guide: https://help.planable.io/hc/en-us/articles/27538577098780-How-to-connect-Planable-MCP-to-your-AI-tools”
只有当两个调用都成功返回后，才继续执行后续步骤。
流程
- 确定提案范围
确认客户域名、竞争对手、Planable 工作区，以及合作目标。通过 list_pages 验证工作区确实连接了客户页面，并检查 get_workspace_details 的 hasAnalytics，这会决定社交部分能否生成。
- SEO + AI 搜索分析（SE Ranking）
- 自然搜索足迹：DATA_getDomainOverviewWorldwide + DATA_getDomainKeywords，获取流量、热门词、趋势。突出“ striking-distance ”词（高搜索量、排名 11–30），它们是最快的突破口。
- 竞争差距：DATA_getDomainCompetitors + DATA_getDomainKeywordsComparison，找出竞争对手获取而客户没有的词（剔除垃圾/偏离品牌的词）。
- 站点健康：复用已有审计（PROJECT_listAudits → getAuditReport），或执行 DATA_createStandardAudit → DATA_getAuditReport，获取健康分与阻碍页面的问题。
- AI 可见性：DATA_getAiSearchBrand 解析品牌，然后 DATA_getAiSearchOverview 和 DATA_getAiSearchLeaderboard 对比竞争对手（查询排行榜时范围要窄，参见 ai-search 技能的 timeout 说明）。
- 内容需求：DATA_getKeywordQuestions + DATA_getRelatedKeywords，证明存在可争取的受众。
将发现分为快速见效项（低投入、近期）与战略举措（高投入、复利效应）。
- 社交基线（Planable）
- list_pages(workspaceId)：已连接渠道。
- get_page_metrics_summary(workspaceId, pageIds, startDate, endDate)：账号级触达——受众（粉丝）、总页面曝光、互动率。这是“存在规模”的数字。
- get_post_metrics_summary(workspaceId, pageIds, startDate, endDate)：窗口期内已发布内容表现（帖子的曝光/互动）。这两个曝光数字范围不同（页面触达 vs 帖子触达），应分开报告，不要相加或混为一谈。
- get_post_metrics(workspaceId, pageIds, ..., limit: 5)：当前热门帖子（已经引起共鸣的内容）。
- list_posts(workspaceId, ...)：当前发布节奏，以及实际已排期与闲置的比例。
将其作为基线来解读：发布节奏、互动率、平台组合和明显差距。
- 综合提案
结构为：你现在在哪里（SEO 健康 + AI 可见性 + 社交基线，带真实数字）→ 机会（竞争对手差距、AI 差距、未充分利用的渠道、内容需求）→ 我们的计划（覆盖 SEO、AI 搜索优化，以及在 Planable 中运行的社交媒体管理）→ 前 90 天（具体、按序的启动计划）→ 我们将如何衡量（需要复盘的指标）。保持所有论断与所拉取的数据挂钩——这正是让启动提案落地的关键。
- 产出文档
默认生成干净的 outputs/proposal.md。若用户需要演示就绪的交付物，可用 docx 技能（正式文档）或 pptx 技能（提案演示）来构建——先阅读该技能，再把综合内容格式化进去。
输出
一份客户可直接使用的提案，包含：
- 执行摘要：最重要的三到四个发现。
- 当前状态：SEO 健康、AI 搜索可见性、社交基线，带数字。
- 机会：竞争对手/关键词/AI 差距，以及社交增长空间。
- 建议范围：SEO + AI + SMM，以及 Planable 如何运行社交工作流（规划、审批、发布）。
- 前 90 天与衡量计划。
提示
- 对弱点保持诚实——可信的基线（包括不好看的数字）比夸大的基线更能建立信任，也使未来的成果可衡量。
- 每条建议都要与一个发现挂钩。“竞争对手 X 排名了 240 个你没有的商业词”胜过“改善你的 SEO”。
- 不要编造指标。若 SE Ranking 或 Planable 返回空值/空结果，标记为未知，而不是猜测。
边界情况与限制
- 社交部分需要已连接页面。若客户页面尚未在 Planable 工作区中，则产出 SE Ranking 侧，并将社交基线明确标记为待获取访问权限（将其框定为启动步骤）。
- 页面级分析有限：部分平台不通过连接器返回页面级分析——常见的有 Twitter/X、Pinterest、Threads 和 Google Business Profile。它们会出现在 unsupportedPages 下；应列为“数据不可用”而非零，并以受支持渠道为基础计算总数。
- 审计需要套餐中的爬取额度；有近期审计时复用，并对大型站点限制 max_pages。
- 该技能只做分析与提案；不创建或发布内容（合作开始后可使用 seo-gaps-to-social-campaign 或 site-audit-to-social-distribution）。
适用场景
适用于代理机构在新客户启动或早期合作阶段，需要结合 SEO、AI 搜索与社交数据，产出诚实、有据可依的提案文档。