VibeMKT Hub

内容与创意 · api-page-generator

API 产品介绍页策划 Skill

面向开发者和技术决策者，完成 API 产品介绍页的信息架构、API 价值主张、API 使用场景、开发文档与注册 CTA，以及面向开发者搜索需求的 SEO 元数据。

API 产品介绍页常把接口名称、认证方式、SDK 和功能术语堆在一起，开发者看不出能解决什么问题，技术决策者也找不到评估所需的文档入口。这个 Skill 先确认 API 类型、读者和文档位置，再组织 API 价值主张、核心能力与 API 使用场景，安排快速开始、认证概览、如适用的价格或限制、如有的 SDK 与工具，以及通往文档或注册的开发者 CTA。团队会拿到 API 落地页结构、关键文案、用例与 CTA、Title、Description 和 H1，方便产品营销、开发者关系、内容、设计和开发继续完成页面。

WHAT IT SOLVES

解决的营销问题

面向开发者和技术决策者，完成 API 产品介绍页的信息架构、API 价值主张、API 使用场景、开发文档与注册 CTA，以及面向开发者搜索需求的 SEO 元数据

面向开发者和技术决策者，完成 API 产品介绍页的信息架构、API 价值主张、API 使用场景、开发文档与注册 CTA，以及面向开发者搜索需求的 SEO 元数据。跑完你拿到的是API 产品介绍页结构：价值主张、核心能力、使用场景、快速开始、认证概览，以及如适用的价格或限制、如有的 SDK 或工具，中间一共 4 步。

最适合的真实场景

  • 01

    SaaS 产品已经开放 REST API，官网只有端点文档，潜在客户看不出适用场景和接入价值

  • 02

    企业采购与开发者共同评估 API，需要在同一页面分别看到业务价值、核心能力、认证概览和文档入口

  • 03

    API 页面列出了 SDK、认证和限额，却缺少清楚的使用场景、快速开始路径和注册 CTA

  • 04

    网站改版需要同时准备 API 产品介绍页结构、价值主张、Title、Description、H1 和内部链接

你要先准备的资料

  • API 类型、产品能力、目标行业、典型集成场景，以及开发者和技术决策者各自关心的问题
  • 现有 API 页面 URL、截图或页面稿，开发文档、API Reference、快速开始与注册入口
  • 认证方式、如适用的公开价格与使用限制、如有的 SDK 与工具清单，以及已经确认的示例和产品术语
  • 品牌语气、目标产品词或行业 API 关键词、首页与功能页链接、SEO 和结构化数据要求

跑完你会拿到什么

  • API 产品介绍页结构：价值主张、核心能力、使用场景、快速开始、认证概览，以及如适用的价格或限制、如有的 SDK 或工具
  • 关键文案：H1、副标题、核心能力说明、典型用例，以及通往开发文档或注册入口的 CTA
  • 内部链接建议：首页、功能页和资源页通往 API 页面，API 页面通往快速开始、API Reference 或注册入口
  • API SEO 元数据：Title、Description、产品词或行业词加 API，以及 WebPage 或 SoftwareApplication Schema 候选字段

METHOD

Skill 工作流程

确认 API 类型、页面读者与文档位置 → 提炼价值主张、核心能力与典型用例 → 安排快速开始、认证概览、SDK 与 CTA 等 4 个环节

一共 4 步。其中 5 项能力决定了换个 AI 会不会更麻烦。

  1. 确认 API 类型、页面读者与文档位置先确认 REST、GraphQL 或其他 API 形态，区分负责实际集成的开发者和负责选型的技术决策者，再记录快速开始、API Reference、认证说明与注册入口的当前 URL。
  2. 提炼价值主张、核心能力与典型用例根据已确认的产品能力说明 API 帮谁完成什么任务，将功能名称改写成清楚的 API 价值主张和 API 使用场景，并为开发者与决策者分别安排需要优先看到的信息。
  3. 安排快速开始、认证概览、SDK 与 CTA用高层说明介绍认证、如适用的价格或限制、如有的 SDK 与工具，把完整端点、参数、响应与错误码留在开发文档，并设置通往快速开始、API Reference 或注册的清楚入口。
  4. 完成 API SEO 元数据与内部链接准备包含产品词或行业词与 API 的 Title、Description 和 H1，从首页、功能页与资源页规划内部链接，并按页面内容列出 WebPage 或 SoftwareApplication Schema 候选字段。

这个 Skill 用到的能力： 读本地资料打开网页取正文中文办公文档写本地文件产物区审阅 。不同 AI 对这些能力的支持程度不一样，所以同一个 Skill 换个 AI，有几步做法会变。

WORKED EXAMPLE

业务示例

示例：为数据处理 SaaS 规划 API 产品介绍页

假设一家数据处理 SaaS 已有 REST API、快速开始、API Reference 和三种 SDK，但官网只在页脚放了开发文档链接。团队提供产品能力、典型集成场景、认证说明、限额资料、SDK 清单与现有 URL。

  1. 确认页面同时服务准备集成的开发者和评估方案的技术负责人
  2. 用数据接入、任务触发和结果回传三个已确认场景组织价值主张与核心能力
  3. 安排快速开始、认证概览、如适用的限额、如有的 SDK 与工具模块，并保留文档链接
  4. 将查看快速开始设为开发者主 CTA，并保留注册入口
  5. 完成 Title、Description、H1、内部链接和 Schema 字段建议

预期结果：交付 API 产品介绍页结构、关键文案、用例与 CTA、开发者入口清单和 API SEO 元数据。此为假设场景，API 开发、端点验证、页面实现和正式发布仍需团队继续完成。

PITFALLS · VERIFICATION

使用限制与常见问题

首页只列 API 名称、端点数量或技术术语

最常踩的坑

  • 首页只列 API 名称、端点数量或技术术语，开发者和决策者看不出实际使用场景
  • 把完整参数表、响应字段和错误码复制到介绍页，导致概览与 API Reference 重复
  • 把未确认的认证方式、价格、限额、SDK、支持范围或调用效果写进公开页面
  • 页面只有查看文档一个入口，没有为评估、试用、注册和企业采购安排适合的下一步
  • 只准备页面文案，没有核对首页、功能页、资源页与开发文档之间的内部链接

怎么确认这次跑对了

  • 已经形成可检查的API 产品介绍页结构：价值主张、核心能力、使用场景、快速开始、认证概览，以及如适用的价格或限制、如有的 SDK 或工具，关键判断能回到输入资料或过程证据。
  • 已经形成可检查的关键文案：H1、副标题、核心能力说明、典型用例，以及通往开发文档或注册入口的 CTA，关键判断能回到输入资料或过程证据。
  • 已经形成可检查的内部链接建议：首页、功能页和资源页通往 API 页面，API 页面通往快速开始、API Reference 或注册入口，关键判断能回到输入资料或过程证据。
  • 已逐项检查「首页只列 API 名称、端点数量或技术术语，开发者和决策者看不出实际使用场景」等高频问题，并记录需要人工确认的下一步。
API 产品介绍页策划 Skill适合哪些岗位使用？

产品营销经理、开发者关系团队、技术内容团队、增长营销、API 产品负责人、官网编辑、UX 设计师与前端开发。典型场景包括SaaS 产品已经开放 REST API，官网只有端点文档，潜在客户看不出适用场景和接入价值；企业采购与开发者共同评估 API，需要在同一页面分别看到业务价值、核心能力、认证概览和文档入口；API 页面列出了 SDK、认证和限额，却缺少清楚的使用场景、快速开始路径和注册 CTA。

开始前需要准备什么资料？

至少需要API 类型、产品能力、目标行业、典型集成场景，以及开发者和技术决策者各自关心的问题、现有 API 页面 URL、截图或页面稿，开发文档、API Reference、快速开始与注册入口、认证方式、如适用的公开价格与使用限制、如有的 SDK 与工具清单，以及已经确认的示例和产品术语。资料越具体，结果越能直接用于决策。

最后能得到什么可检查的结果？

API 产品介绍页结构：价值主张、核心能力、使用场景、快速开始、认证概览，以及如适用的价格或限制、如有的 SDK 或工具、关键文案：H1、副标题、核心能力说明、典型用例，以及通往开发文档或注册入口的 CTA、内部链接建议：首页、功能页和资源页通往 API 页面，API 页面通往快速开始、API Reference 或注册入口。每项都可以逐条核对来源和数字。

哪些情况下结果会不可靠？

首页只列 API 名称、端点数量或技术术语，开发者和决策者看不出实际使用场景；把完整参数表、响应字段和错误码复制到介绍页，导致概览与 API Reference 重复。出现这些情况时需要人工复核。

支持哪些 AI Agent？

已适配 WorkBuddy、OpenClaw、Hermes Agent、Codex、Claude Code、TRAE、ZCode 共 7 种，每种都有独立的安装说明和能力对照。

ORIGINAL SOURCE

完整 Skill 内容与版本资料

2 个原始文件，10 个文档章节，来源固定在 70987bad

上游原文完整保留在加搜服务器上，可逐节查看，也可以直接下载。 当前镜像共 2 个文件、3.5 KB。

API 能力、认证方式、价格、限额、SDK、工具、支持范围、示例和所有 CTA 去向都要由产品与技术团队确认。策划完成后，API 开发、端点文档、接口测试、网页实现、埋点和正式发布继续由对应团队处理。

原始 Skill 文档 上游原文完整保留，中文概述已转换为营销任务、输入资料和交付结果。

原始方法先确认 API 类型、页面读者和文档位置，再组织价值主张、核心能力、使用场景、快速开始、认证概览、如适用的价格或限制、如有的 SDK 与工具，最后交付页面结构、CTA 和开发者搜索元数据。完整原文随安装包保留。

来源与版本声明

本页面由加搜科技整理业务说明并托管安装文件。原始 Skill 来源渠道：GitHub； 上游作者：kostja94； 原始项目名称：api-page-generator； 固定版本：70987bad4ebe； 许可证：MIT。技能包内保留完整出处和许可证说明。

各 Agent 能力说明参考对应官方文档。页面不提供外部跳转。

API 能力、认证方式、价格、限额、SDK、工具、支持范围、示例和所有 CTA 去向都要由产品与技术团队确认。策划完成后，API 开发、端点文档、接口测试、网页实现、埋点和正式发布继续由对应团队处理。

INSTALL

三种安装方式

API 产品介绍页策划 Skill v1.0.0，ZIP 带 SHA256 校验

默认做法是把提示词复制给 AI Agent，让它自己下载并安装。提示词里已经写清要用完整 ZIP、装完报告目录、并先跑一个小任务验证。

METHOD 01 · 交给 AI 自己装

复制提示词

适合大多数情况。Agent 会下载 ZIP、解压、放到正确目录，并在缺少权限时告诉你需要手工做哪一步。

请帮我把「API 产品介绍页策划 Skill」安装到我正在使用的 AI Agent。
1. 下载完整 Skill ZIP：https://www.vibemarketing.work/packages/skill-api-page/1.0.0/skill-api-page.zip
   注意：网页 HTML 不能当作 Skill 文件安装，必须使用 ZIP 里的完整文件。
2. 解压后保留 SKILL.md 及全部配套文件，按你所用 Agent 的 Skill 目录规则安装。
3. 安装完成后告诉我实际安装目录。
4. 用一个只读小任务验证 Skill 已被识别。
5. 如果你没有联网、下载或写目录权限，请直接告诉我哪几步需要我手工完成。
参考：原始 SKILL.md https://www.vibemarketing.work/raw/skill-api-page/SKILL.md；安装指南 https://www.vibemarketing.work/agent-install/skill-api-page.md

FURTHER READING

API 产品介绍页策划 Skill 相关的实操文章

继续查看这套 API 产品介绍页策划方法：先区分开发者与技术决策者，再组织价值主张、用例、快速开始和文档入口，最后补齐开发者 SEO 与内部链接。

免费工具访问量很高，为什么销售还是收不到好线索

假设一家 SaaS 公司上线了 ROI 计算器。三个月后，工具页的自然流量和使用次数都在涨，市场团队把它当作新的获客入口，销售却说收到的邮箱很难跟进：有人只想算一道题，有人来自目标行业之外，还有人留下

  • SEO
  • B2B获客
  • 增长策略
  • 营销分析

SaaS 定价页有三档套餐，客户为什么还是选不出来

定价页已经把 Starter、Professional、Enterprise 排成三张卡，价格、功能和“最受欢迎”角标也都在，销售仍然反复收到同一个问题：我们该买哪一档？这时团队很容易删一档套餐、放大

  • 转化文案
  • 产品营销
  • 转化率
  • 落地页

官网菜单越改越简，定价和文档为什么更难找

假设一家 SaaS 公司把官网从六个一级栏目收成“产品、解决方案、资源”三个下拉菜单。价格页和文档页仍在，只是从页头可见入口移到了第二层。改版后如果销售频繁收到“有没有公开价格”“API 文档在哪里”

  • SEO
  • 内容策略
  • 产品营销
  • 信息架构

竞品对比页写满功能，买家为什么还是不信

买家搜索“A 对比 B”时，通常已经知道品类，也看过其他产品。他打开供应商的对比页，看到自家产品每一行都是绿色勾，竞品则处处受限；再打开竞品的网站，结论正好反过来。两张页面都写了很多功能，却没有帮助他

  • SEO
  • 竞品分析
  • 产品营销
  • B2B营销

产品那句话客户复述不出来，销售和市场就会各写一套

市场部改官网，销售改话术，投放改广告，三边各自有一套说法，在不少团队里已经算日常。语气不同还能凑合用。客户听完三遍，仍然复述不出你们到底解决哪一件事，这才麻烦。功能清单越长，这句话越容易丢。产品营销要

  • 定位
  • 销售赋能
  • 产品营销

搭配使用

API 产品介绍页负责概览、价值表达、使用场景和文档或注册入口；官网首页负责品牌主入口，功能页解释单项能力，开发文档与 API Reference 负责端点、参数、响应和代码示例。

SEO 与 GEO#01

导航站收录 Skill

把产品基础信息转为分层的导航站收录档案，按梯队分发到 Product Hunt 与 AI 工具集，获取外链与曝光。

来源项目 · coreyhaines31/marketingskills ★ 52,924 · Fork 7,914
社媒与红人#02

海外社区搭建 Skill

把空白的海外 Discord 或 Reddit 群组，整理成有新人引导路径、版规和活跃度指标的社区运营手册。

来源项目 · coreyhaines31/marketingskills ★ 52,924 · Fork 7,914
内容与创意#04

高转化营销文案 Skill

把模糊的产品卖点写成符合 PAS 或 AIDA 模型的广告语、落地页标题和邮件文案，并附带 A/B 测试选项。

来源项目 · kostja94/marketing-skills ★ 1,012 · Fork 140
内容与创意#06

FAQ 页面内容策划 Skill

围绕真实用户问题、购买疑虑与搜索问题，完成 FAQ 选题、分组、回答、独立页或页面内区块安排，以及与可见内容一致的 FAQPage Schema 建议。

来源项目 · kostja94/marketing-skills ★ 1,012 · Fork 140

VibeMKT COMMUNITY

加入 VibeMKT 社群

微信扫码，交流营销 Skill 的选择、安装、试用与业务化改造。

加入 VibeMKT 社群的微信二维码

二维码会持续显示，关闭弹窗后返回当前页面。