PopNowAPI 文档
ChatGPT、Claude 与智能体
正文

智能体技能

为发布视频、幻灯片、网站或编辑风图片找到现成的风格,交给你的编程智能体。可以在对话中通过 MCP 选择,也可以用安装提示词、ZIP 或 curl 装进 Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot 或 OpenCode。

智能体技能是一份操作手册,教 AI 编程智能体用一种成品风格、做出某一类作品:例如用 HTML 渲染的产品发布视频、幻灯片、落地页或整个网站、一组编辑风格的图片。每个技能是一个文件夹 popnow-<slug>/,里面有智能体会读取的 SKILL.md,以及它需要的脚本、参考文件和素材。

技能免费。通过 API 密钥生成的素材(包括技能的 REST 辅助脚本或 API-key MCP)使用独立的 API 美元余额;通过 OAuth MCP 生成的素材使用网站积分。API 美元余额初始为 $0,请在 API 账单充值。网站积分与 API 资金不能互转,也不能相互抵用。技能需要图片、视频、音乐或配音时,会通过 PopNow 按 API 计费中的正常模型价格生成,开始前一定先告诉你价格。所有技能及预览都在 popnow.ai/skills/agent-skills。

有两种使用方式:

  • 在对话中使用(推荐)。 把 PopNow 作为 MCP 服务器接入后,说出你想做什么。助手会展示几种带预览的风格,你选定一个,PopNow 就把这个技能交给助手去执行。
  • 自己安装。 把安装提示词粘贴给你的智能体,下载 ZIP,或者用 curl 加上你的 API 密钥获取。

概览

浏览popnow.ai/skills/agent-skills,可按视频、图片、幻灯片或网页筛选
在对话中通过 MCP 使用 find_skills(带预览的风格)和 use_skill(技能本身、安装链接,以及如何用 PopNow 生成它所需的媒体)
智能体Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode
手动安装安装提示词、技能页面上的 ZIP(需已登录),或用 $POPNOW_API_KEY 执行 curl
REST APIGET /api/v1/agent-skills、GET /api/v1/agent-skills/{slug}、GET /api/v1/agent-skills/{slug}/download
价格查找、安装和使用免费。技能生成的图片、视频、音乐和配音按生成计费,开始前先报价
数量免费账户:每 24 小时可新增 5 个技能,总计 20 个。购买过任意积分后:每 24 小时可新增 30 个,没有总量上限。已经添加过的技能不会再次计数。见限制
许可供你自己的工作和客户的工作使用。请勿发布或再分发安装包

在对话中选择技能

只需连接一次 PopNow(Claude、ChatGPT、Claude Code、Cursor 等),然后说出你想要的结果。助手会使用两个免费工具:

  1. find_skills 把你的需求与目录匹配,返回最多四种风格,最匹配的在前。每种风格附带一句话的外观描述、最适合的用途、预览视频和封面图、它能通过 PopNow 生成哪些媒体、它在你的电脑上需要什么(Node.js、Python 3、FFmpeg、Chrome),以及它的页面。
  2. 你来选择一个。
  3. use_skill 返回该技能完整的操作手册(SKILL.md)、几分钟内有效的整包下载链接、把它装进你的智能体技能文件夹的确切命令,以及如何在同一连接中用 PopNow 工具生成它的图片、视频、音乐和语音。
You:        Make a product launch video for my note-taking app.
Assistant:  (calls find_skills with intent "product launch video for a note-taking app")
            Here are four styles:
            1. Device Mockup Launch Video: your real app screen on a device in a dark studio. [preview]
            2. Seamless App Promo Sting: a 10–13 second promo that flows as one camera move. [preview]
            3. AI Chat Product Demo Video: a narrated demo inside a chat app. [preview]
            4. Developer Tool Launch Reel: one prompt in four places, then your install command. [preview]
            Which one do you like?
You:        The first one.
Assistant:  (calls use_skill with slug "device-mockup-launch-video" and agent "claude-code")
            (downloads and unzips the package into ~/.claude/skills, then follows the playbook)
            I need two screenshots of your app. The background music is about 72 credits. Shall I make it?
You:        Yes.
Assistant:  (calls create_music, renders the video locally, saves launch.mp4)
工具返回什么参数
find_skills最多 limit 个风格,最匹配的在前:slug、名称、外观、最适合的用途、预览视频、封面图、PopNow 媒体、本地条件、页面intent(必填,用你自己的话描述想做什么)、type(video、image、slides 或 web)、limit(1–6,默认 4)
use_skill操作手册(SKILL.md)、整包的签名下载链接、你的智能体的安装命令,以及其媒体对应的 PopNow 工具slug(必填,来自 find_skills)、agent(claude-code、codex、cursor、gemini-cli、github-copilot、opencode 或 chat)
  • 通过 PopNow 生成媒体。 技能附带一个用于 REST API 的小型辅助脚本。通过 MCP 不需要 API 密钥:只要操作手册要调用该脚本,助手就改用 create_image、edit_image、create_video、create_music、create_speech、add_sound、compose_video、upscale、remove_background、extend_video、edit_video、copy_motion、create_video_from_references、transcribe_audio、create_sound_effects、split_layers、erase_object、expand_image、change_camera_angle、change_pose、relight_photo、remove_shadow 或 anime_to_real。每一个都会先报价,超过自动确认上限的部分要等你同意,见 MCP 的价格与确认。
  • 用哪个智能体。 不填 agent 时,PopNow 会根据你连接时使用的应用来猜。在 ChatGPT 或 Claude.ai(agent: "chat")中没有文件系统:图片类技能仍可通过 create_image 在那里使用,而网站、幻灯片和渲染好的视频需要编程智能体;助手可以和你一起规划并制作媒体,并给你一个之后可用的下载链接。
  • 限额。 find_skills 每个账户每小时 240 次,use_skill 每小时 120 次。两者都免费且只读。通过 use_skill 选中的新技能,和下载一样计入你的技能上限;使用你已经有的技能则永远不计入。

自己安装

用安装提示词

每个技能页面都有 Copy install prompt。把它粘贴给你的智能体;智能体会读取安装指南,选择自己的技能文件夹,并用你的密钥获取安装包:

Install the PopNow skill "Dark SaaS Landing Page" (dark-saas-landing-page) for me by following https://popnow.ai/skills/install.md. My PopNow API key is in the POPNOW_API_KEY environment variable.

下载 ZIP

在 popnow.ai 上登录后,技能页面上的 Download ZIP 会保存 popnow-<slug>.zip。把它解压到下面列出的某个文件夹中。

用 curl

在 API 控制台创建一个密钥,把它导出为 POPNOW_API_KEY,然后执行:

Install for Claude Code
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fL -H "Authorization: Bearer $POPNOW_API_KEY" \
  https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download -o popnow-dark-saas-landing-page.zip
unzip -o popnow-dark-saas-landing-page.zip && rm popnow-dark-saas-landing-page.zip

压缩包里只有一个文件夹 popnow-<slug>/,里面是 SKILL.md。有些智能体只在新会话中加载新技能。

智能体个人文件夹项目文件夹调用方式
Claude Code~/.claude/skills.claude/skills/popnow-<slug>
Codex~/.agents/skills.agents/skills$popnow-<slug>
Cursor~/.cursor/skills.cursor/skills/popnow-<slug>
Gemini CLI~/.gemini/skills.gemini/skillspopnow-<slug>
GitHub Copilot~/.copilot/skills.github/skills/popnow-<slug>
OpenCode~/.config/opencode/skills.opencode/skillspopnow-<slug>

个人文件夹会让技能在每个项目中都可用;项目文件夹则只在该代码仓库中可用。

限制

技能免费,但每个账户能添加的不同技能数量有上限。下列网站积分购买条件仅用于判断技能下载资格,不是 API 充值条件,也不代表网站积分能用于 API 调用。网站上的 Download ZIP、下载接口和 MCP 的 use_skill 共用这一限额。

账户任意 24 小时内新增的技能总计
免费(从未购买过积分)520
购买过至少一次积分(价格)30无上限
  • 重新下载不受限制。 你已经添加过的技能,可以随时重新下载、重新安装,或用 use_skill 再次选择,在任何设备上都行,并且永远不会再次计数。
  • 24 小时滚动计算。 每个新技能会在你添加后 24 小时释放一个名额。达到上限时,提示会告诉你下一个名额何时开放。
  • 你的副本归你所有。 你下载的每个安装包都带有属于你账户的许可 ID(写在 LICENSE.txt 和 popnow-<slug>/.popnow-license.json 中)。它不会改变技能的工作方式,只是用来区分你的正版副本和外泄的副本,所以请不要发布这些安装包。

超过上限时,下载接口返回 429,业务码为 42901:

Response (429)
{
  "code": 42901,
  "msg": "You've added 5 new skills in the last 24 hours, the daily limit for free accounts. You can add another in about 3 hours (at 13:00 on Oct 23 UTC). Skills you already added can be downloaded again anytime. Accounts that have bought credits can add 30 a day: popnow.ai/pricing",
  "data": {
    "reason": "skill_quota",
    "scope": "daily",
    "limit": 5,
    "used": 5,
    "paid": false,
    "retryAfter": 10800,
    "resetAt": "2026-10-23T13:00:00Z",
    "upgradeUrl": "https://popnow.ai/pricing"
  },
  "request_id": "req_..."
}

scope 为 daily 时,附带以秒计的 retryAfter、resetAt 和 Retry-After 响应头;为 lifetime 时,表示免费账户的 20 个总量已满,没有需要等待的时间。通过 MCP 使用时,use_skill 会用大白话说明同样的情况,而不是返回技能。

REST API

这三个接口都用你的 API 密钥作为 Bearer 令牌。它们返回目录和安装步骤;操作手册本身随安装包一起提供(或者通过 MCP 的 use_skill 获取)。

列出与搜索

Find slide deck skills
curl "https://api.popnow.ai/api/v1/agent-skills?type=slides&q=pitch%20deck" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

所有筛选条件都是可选的。type 可以是 video、image、slides 或 web;task 保留带有某个任务标签的技能(例如 landing-page 或 pitch-deck);q 按自由文本的相关度排序,并去掉一个词也不匹配的技能。不加筛选条件时,返回整个目录,最匹配的在前。

Response
{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [
      {
        "slug": "dark-saas-landing-page",
        "name": "Dark SaaS Landing Page",
        "summary": "A dark, motion-rich marketing site for a software product, delivered as one self-contained HTML file.",
        "bestFor": ["Launch pages for SaaS and developer tools", "A full marketing site that has to look shipped on day one"],
        "type": "web",
        "tasks": ["landing-page"],
        "popnow": ["image"],
        "popnowRequired": false,
        "requires": ["node", "python3", "chrome"],
        "version": "1.0.0",
        "updated": "2026-10-22",
        "url": "https://popnow.ai/skills/dark-saas-landing-page",
        "preview": {
          "video": "https://media.popnow.ai/skills/library/dark-saas-landing-page/cover.9cfd8efc.mp4",
          "image": "https://popnow.ai/skills/library/media/dark-saas-landing-page/poster.webp"
        },
        "distribution": "popnow"
      }
    ],
    "total": 1
  }
}

popnow 列出该技能可以通过 PopNow 生成的媒体;当没有这些媒体技能就无法完成时,popnowRequired 为 true。requires 列出它要在你的电脑上运行的工具。

单个技能及其安装步骤

Get one skill
curl https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page \
  -H "Authorization: Bearer $POPNOW_API_KEY"

返回结果包含相同的字段,外加 install:安装包内的文件夹名、下载路径、安装提示词、安装指南,以及每个智能体一条记录,内含它的文件夹、调用方式,以及一条可直接运行的个人文件夹安装命令。

Response (shortened)
{
  "code": 200,
  "msg": "success",
  "data": {
    "slug": "dark-saas-landing-page",
    "name": "Dark SaaS Landing Page",
    "type": "web",
    "url": "https://popnow.ai/skills/dark-saas-landing-page",
    ...
    "install": {
      "folder": "popnow-dark-saas-landing-page",
      "downloadPath": "/api/v1/agent-skills/dark-saas-landing-page/download",
      "downloadUrl": "https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download",
      "prompt": "Install the PopNow skill \"Dark SaaS Landing Page\" (dark-saas-landing-page) for me by following https://popnow.ai/skills/install.md. My PopNow API key is in the POPNOW_API_KEY environment variable.",
      "guide": "https://popnow.ai/skills/install.md",
      "agents": [
        {
          "id": "claude-code",
          "name": "Claude Code",
          "personalDir": "~/.claude/skills",
          "projectDir": ".claude/skills",
          "invoke": "/popnow-dark-saas-landing-page",
          "docs": "https://docs.claude.com/en/docs/claude-code/skills",
          "command": "mkdir -p ~/.claude/skills && cd ~/.claude/skills\ncurl -fL -H \"Authorization: Bearer $POPNOW_API_KEY\" \\\n  https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download -o popnow-dark-saas-landing-page.zip\nunzip -o popnow-dark-saas-landing-page.zip && rm popnow-dark-saas-landing-page.zip"
        },
        ...
      ]
    }
  }
}

要只为某一个代码仓库安装,把命令中的 personalDir 换成 projectDir 即可。

下载

Download a package
curl -fL https://api.popnow.ai/api/v1/agent-skills/dark-saas-landing-page/download \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -o popnow-dark-saas-landing-page.zip

该接口返回 302,指向 ZIP 的签名链接,几分钟后失效。所以务必跟随重定向(-L),并且永远不要保存这个链接。

错误与限制

状态码出现时机
400type 不是 video、image、slides 或 web,或者 q 超过 200 个字符
401缺少 API 密钥,或密钥错误
403该账户已关闭技能下载;请发邮件到 support@popnow.ai
404没有该 slug 对应的技能
429请求过多(每个账户每分钟 60 次目录请求或 30 次下载),或者业务码为 42901、data.reason 为 skill_quota 时,即触发了技能上限
503下载暂时不可用;一分钟后再试

智能体技能要花钱吗?

不用。查找、安装和运行技能都是免费的。只有技能通过 PopNow 生成的图片、视频、音乐和配音才收费:API 密钥调用使用 API 美元余额,OAuth MCP 使用网站积分,按相同模型价格计费。每次生成都会先报价,等你确认后再运行。

我能获得多少个技能?

免费账户每天可以新增 5 个技能,总计 20 个;购买过积分后,每天可以新增 30 个,没有总量上限。下载你已经有的技能永远不计数。见限制。

我需要编程智能体吗?

做网站、幻灯片和渲染视频时需要:技能要在你的电脑上运行脚本并生成文件。图片类技能在 PopNow 通过 MCP 接入 ChatGPT 或 Claude.ai 后也能用,因为图片直接在对话中用 create_image 生成。

我需要 API 密钥吗?

通过 MCP 不需要:连接本身已经登录,use_skill 会提供下载链接,媒体通过 PopNow 工具生成。使用 REST API 时,curl 用来安装,技能自带的辅助脚本需要把 POPNOW_API_KEY 设为 API 控制台中的一个密钥。

我可以分享技能或把它放进我的代码仓库吗?

请将技能用于你自己的工作和客户的工作,并保留你用它做出的成果。不要发布、转售或再分发安装包本身;把技能页面发给同事,让他们安装自己的副本。每个下载的安装包都带有下载它的账户的许可 ID。

它和 GitHub 上的 popnow-skills 有什么不同?

popnow-skills 是一套开源技能,教智能体通用地调用 PopNow API。智能体技能则是成品风格,每种都针对一类结果,附带预览,从 popnow.ai 上的目录中挑选。见 SDK、CLI 与开源工具。

本页内容