🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › 抖音文案解析
🦀 ClawHub

抖音文案解析

by @kyriswu

Call the coze-js-api Douyin transcription endpoint and return transcript-ready results from Douyin URLs or share-text. Use this skill whenever the user asks...

Versionv0.1.1
Downloads617
#api#writing#video#legal#communication
TERMINAL
clawhub install douyin-transcribe-api

📖 About This Skill

name: douyin-transcribe-api description: Call the coze-js-api Douyin transcription endpoint and return transcript-ready results from Douyin URLs or share-text. Use this skill whenever the user asks to transcribe, extract speech, or get subtitles from Douyin/TikTok China links, including messy copied share text with embedded URLs, API key handling, shell command execution, and response troubleshooting. metadata: {"openclaw":{"requires":{"bins":["bash","curl","python3"]}}} user-invocable: true

Douyin Transcribe API Skill

Use this skill to reliably call the API endpoint:

  • POST https://coze-js-api.devtool.uk/transcribe-douyin

    • Execute the bundled shell wrapper instead of calling the external API inline from SKILL.md.

    When to use

    Use this skill if the user asks for any of the following:

  • Transcribe a Douyin video
  • Extract speech/subtitles/text from a Douyin URL
  • Use copied Douyin share text that contains a short link
  • Build a curl request for the transcribe-douyin endpoint
  • Debug failed transcribe-douyin calls

    • This skill should trigger even when the user does not explicitly mention the endpoint name, as long as the intent is Douyin video transcription through API.

    Inputs

    Collect or infer these inputs:

  • url (required):
    • - Ask the user to provide Douyin share text or share link content. - Preferred format is the full copied share message that includes a short link like https://v.douyin.com/.../. - Example input style: - 2.89 zTl:/ ... https://v.douyin.com/UxkQpDSVMFE/ 复制此链接，打开Dou音搜索，直接观看视频！ - A direct link like https://v.douyin.com/.../ is also accepted.

    API key resolution

    Resolve api_key in this order: 1. Read environment variable DOUYIN_TRANSCRIBE_API_KEY. 2. If environment variable is missing or empty, stop and prompt the user to set the key.

    Prompt message when key is missing:

  • 未检测到环境变量 DOUYIN_TRANSCRIBE_API_KEY，请先设置 key 后再重试。可前往 https://devtool.uk/plugin 申请或反馈。

    • Input normalization

    Before calling the API: 1. If url includes free text, extract the first https://... URL. 2. Keep the original text if no URL can be extracted and explain the issue. 3. Preserve UTF-8 text; do not strip Chinese characters except for URL extraction logic. 4. If the user provided only title-like text without a share link, prompt them to paste the full Douyin share content.

    Request format

    Always send JSON body with:

  • url
  • api_key

    • Command to run:

    export DOUYIN_TRANSCRIBE_API_KEY=""
    exec bash scripts/transcribe_douyin.sh ""

    If DOUYIN_TRANSCRIBE_API_KEY is not set, do not call the API. Prompt the user to set it first.

    Do not construct a raw curl command in the final answer unless the user explicitly asks for it. Prefer executing the bundled script.

    Response handling

    After the call: 1. Show status outcome clearly (success or failed). 2. Return important response fields directly. 3. If request fails, provide likely causes and a corrected command.

    Common failure causes:

  • Invalid or expired API key
  • Malformed JSON quoting
  • URL missing from copied share text
  • Upstream video access or parsing issues

    • If response indicates invalid token/key (for example code: -1 and message like 令牌无效), guide the user to:

  • https://devtool.uk/plugin
  • Apply for a valid key or submit feedback there.

    • Output format

    Use this structure in responses:

    # Douyin Transcription Request

  • Endpoint: https://coze-js-api.devtool.uk/transcribe-douyin
    • 

  • URL input: 
    • 

  • API key source: 
    • Request
    

    Result
    

    Next Step

    Examples

    Example 1: Input: "Transcribe this: https://v.douyin.com/gtSMSkIh3p0/" Output behavior: Read key from DOUYIN_TRANSCRIBE_API_KEY, run exec bash scripts/transcribe_douyin.sh "https://v.douyin.com/gtSMSkIh3p0/", then summarize response.

    Example 2: Input: "4.12 ... https://v.douyin.com/gtSMSkIh3p0/ ... 打开Dou音搜索 ..." Output behavior: Pass the full share text into scripts/transcribe_douyin.sh, let the script send the JSON request, and report result.

    Safety and privacy

  • Never leak full secret keys in logs when not required.
  • If sharing command output, redact sensitive key values unless user explicitly asks for full raw output.
  • Do not invent successful transcripts when the API fails; report the failure honestly.

    • ⚡ When to Use

    TriggerAction
    - Transcribe a Douyin video
    - Extract speech/subtitles/text from a Douyin URL
    - Use copied Douyin share text that contains a short link
    - Build a curl request for the `transcribe-douyin` endpoint
    - Debug failed `transcribe-douyin` calls
    This skill should trigger even when the user does not explicitly mention the endpoint name, as long as the intent is Douyin video transcription through API.

    💡 Examples

    Example 1: Input: "Transcribe this: https://v.douyin.com/gtSMSkIh3p0/" Output behavior: Read key from DOUYIN_TRANSCRIBE_API_KEY, run exec bash scripts/transcribe_douyin.sh "https://v.douyin.com/gtSMSkIh3p0/", then summarize response.

    Example 2: Input: "4.12 ... https://v.douyin.com/gtSMSkIh3p0/ ... 打开Dou音搜索 ..." Output behavior: Pass the full share text into scripts/transcribe_douyin.sh, let the script send the JSON request, and report result.