PopNowAPI 文件
ChatGPT、Claude 與 AI 代理
主要內容

代理技能

為產品發表影片、投影片、網站或編輯風格圖片找到現成的風格,交給你的程式代理。可以在對話中透過 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 與開源工具。

本頁內容