Claude GitHub Copilot Skill

kuaishou

Publish video to the user's own 快手 (Kuaishou) account and read their works via the Kuaishou open platform. Use when the user mentions 快手, Kuaishou, 发快手, 发布到快手, 我的快手作品, or wants to post a generated video to their Kuaishou account.

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Download acedatacloud-skills-skills_kuaishou-c3d1703.zip · 9 KB

Install

skills CLI npx skills add https://github.com/AceDataCloud/Skills/tree/main/skills/kuaishou
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install acedatacloud-skills@llmmart
Git git clone https://github.com/AceDataCloud/Skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole acedatacloud/skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

All calls go through scripts/kuaishou.py (stdlib-only). The user's OAuth token arrives as $KUAISHOU_TOKEN and the app id as $KUAISHOU_APP_ID (injected from the connector's metadata.platform_env); the script reads both and fails fast with a clear message if either is missing — never print either.

Resolve the script first ($SKILL_DIR may point at a different skill loaded the same turn), and repeat this preamble in every Bash block:

KS="$SKILL_DIR/scripts/kuaishou.py"; [ -f "$KS" ] || KS=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/kuaishou.py' 2>/dev/null | head -1)
[ -f "$KS" ] || { echo "kuaishou script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }

Read

python3 "$KS" whoami                  # nickname, avatar, fans, follows, city
python3 "$KS" works --limit 20        # works + play/like/comment counts
python3 "$KS" works --limit 20 --cursor <photo_id>   # next page
python3 "$KS" work <photo-id>         # one work
python3 "$KS" counts                  # public / friend / private / total

Publish a video

This posts publicly to the user's real account — there is no draft mode. Before publishing, confirm with the user in chat:

  1. the caption (required by 快手), and
  2. that the video is their own original work — 快手 bans accounts that publish non-original video, and the ban lands on the user's account.

Without a trailing --confirm the command only dry-runs and publishes nothing. --confirm must be the last argument.

# 1) Dry run — show the user exactly what will be posted
python3 "$KS" publish --caption "标题" --video-url "https://cdn.acedata.cloud/....mp4" \
  --cover-url "https://cdn.acedata.cloud/....jpg"

# 2) After they confirm in chat
python3 "$KS" publish --caption "标题" --video-url "https://cdn.acedata.cloud/....mp4" \
  --cover-url "https://cdn.acedata.cloud/....jpg" --confirm

A cover image is required (--cover-url or --cover-file, < 10MB). Local files work too via --video-file / --cover-file. Optional: --stereo-type for 360/180 panoramic video, --product-id to attach a 小黄车 product.

Remote --*-url inputs must live on cdn.acedata.cloud (or Kuaishou's own image hosts). Anything else is rejected — upload it to our CDN first, or pass a local path. This blocks a hostile URL from turning the upload step into an SSRF.

After a successful publish, record the deliverable once (see _shared/artifacts.md):

publish_artifact(kind="video", channel="kuaishou", title="<caption>",
                 url="<the url returned by the script>", status="delivered")

Gotchas

  • Upload success ≠ playable video. The upload step only confirms bytes arrived; a malformed file fails later at transcode with 视频发布失败 (120003) or 视频未上传成功 (120002). Report those verbatim.
  • Rate limits: 1000 calls/day per user, 100k/day per app. 100100402 means the limit was hit or the account is banned.
  • ACCESS_DENIED = the authorization is missing that endpoint's scope → reconnect 快手 and grant it. Token expiry (100200108) also means reconnect.
  • Kuaishou answers HTTP 200 even on failure — the script already checks result != 1, so trust its error field rather than the exit status alone.
  • Connections need re-authorizing roughly every 180 days: the refresh token does not extend on refresh. If the user hits an auth error, have them reconnect.
Files (skills)
  • scripts
    • kuaishou.py 13.7 KB
      Loading…
  • tests
    • test_kuaishou.py 9.4 KB
      Loading…
  • SKILL.md 4.2 KB
    ---
    name: kuaishou
    description: Publish video to the user's own 快手 (Kuaishou) account and read their works via the Kuaishou open platform. Use when the user mentions 快手, Kuaishou, 发快手, 发布到快手, 我的快手作品, or wants to post a generated video to their Kuaishou account.
    when_to_use: |
      Trigger for anything on the user's own 快手 account through the official
      open platform: publishing a video (e.g. one generated by the video
      skills), listing their works with play/like/comment counts, inspecting
      one work, or checking their account. Publishing is a real, immediately
      public post — always confirm the caption AND that the video is the
      user's own original work before running with --confirm.
    connections: [kuaishou]
    allowed_tools: [Bash]
    license: Apache-2.0
    metadata:
      author: acedatacloud
      version: "1.0"
    ---
    
    All calls go through `scripts/kuaishou.py` (stdlib-only). The user's OAuth token
    arrives as `$KUAISHOU_TOKEN` and the app id as `$KUAISHOU_APP_ID` (injected from
    the connector's `metadata.platform_env`); the script reads both and fails fast
    with a clear message if either is missing — never print either.
    
    Resolve the script first (`$SKILL_DIR` may point at a different skill loaded the
    same turn), and repeat this preamble in every Bash block:
    
    ```bash
    KS="$SKILL_DIR/scripts/kuaishou.py"; [ -f "$KS" ] || KS=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/kuaishou.py' 2>/dev/null | head -1)
    [ -f "$KS" ] || { echo "kuaishou script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
    ```
    
    ## Read
    
    ```bash
    python3 "$KS" whoami                  # nickname, avatar, fans, follows, city
    python3 "$KS" works --limit 20        # works + play/like/comment counts
    python3 "$KS" works --limit 20 --cursor <photo_id>   # next page
    python3 "$KS" work <photo-id>         # one work
    python3 "$KS" counts                  # public / friend / private / total
    ```
    
    ## Publish a video
    
    **This posts publicly to the user's real account — there is no draft mode.**
    Before publishing, confirm with the user in chat:
    
    1. the caption (required by 快手), and
    2. that the video is **their own original work** — 快手 bans accounts that
       publish non-original video, and the ban lands on *the user's* account.
    
    Without a trailing `--confirm` the command only dry-runs and publishes nothing.
    `--confirm` must be the **last** argument.
    
    ```bash
    # 1) Dry run — show the user exactly what will be posted
    python3 "$KS" publish --caption "标题" --video-url "https://cdn.acedata.cloud/....mp4" \
      --cover-url "https://cdn.acedata.cloud/....jpg"
    
    # 2) After they confirm in chat
    python3 "$KS" publish --caption "标题" --video-url "https://cdn.acedata.cloud/....mp4" \
      --cover-url "https://cdn.acedata.cloud/....jpg" --confirm
    ```
    
    A cover image is **required** (`--cover-url` or `--cover-file`, < 10MB). Local
    files work too via `--video-file` / `--cover-file`. Optional: `--stereo-type`
    for 360/180 panoramic video, `--product-id` to attach a 小黄车 product.
    
    Remote `--*-url` inputs must live on **`cdn.acedata.cloud`** (or Kuaishou's own
    image hosts). Anything else is rejected — upload it to our CDN first, or pass a
    local path. This blocks a hostile URL from turning the upload step into an SSRF.
    
    After a successful publish, record the deliverable once (see
    `_shared/artifacts.md`):
    
    ```
    publish_artifact(kind="video", channel="kuaishou", title="<caption>",
                     url="<the url returned by the script>", status="delivered")
    ```
    
    ## Gotchas
    
    - **Upload success ≠ playable video.** The upload step only confirms bytes
      arrived; a malformed file fails later at transcode with `视频发布失败`
      (120003) or `视频未上传成功` (120002). Report those verbatim.
    - Rate limits: **1000 calls/day per user**, 100k/day per app. `100100402` means
      the limit was hit *or* the account is banned.
    - `ACCESS_DENIED` = the authorization is missing that endpoint's scope →
      reconnect 快手 and grant it. Token expiry (`100200108`) also means reconnect.
    - Kuaishou answers HTTP 200 even on failure — the script already checks
      `result != 1`, so trust its `error` field rather than the exit status alone.
    - Connections need re-authorizing roughly every 180 days: the refresh token does
      not extend on refresh. If the user hits an auth error, have them reconnect.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.