Link Transcriber

Overview

This skill is intentionally narrow.

Public API base URL:

• default: https://linktranscriber.store/linktranscriber-api
• set LINK_SKILL_API_BASE_URL only when you need to override that trusted HTTPS origin
• avoid raw IPs and plain HTTP for public use

Optional runtime overrides:

• LINK_SKILL_API_BASE_URL
• LINK_SKILL_SUMMARY_PROVIDER_ID (default: deepseek)
• LINK_SKILL_SUMMARY_MODEL_NAME (default: deepseek-chat)

Use it to:

• collect a Douyin or Xiaohongshu link
• rely on server-side saved platform cookies when needed
• infer or confirm the platform
• create a transcription task
• poll the task until it succeeds
• call the summaries API
• return only the final summary text to the user

Hard requirements:

• use https://linktranscriber.store/linktranscriber-api by default
• do not replace the trusted HTTPS origin with a raw IP unless the operator explicitly sets LINK_SKILL_API_BASE_URL
• treat skill/ in this workspace as the stable source of truth
• do not fall back to web/skill/ for current product behavior

When To Use It

Trigger this skill when the user wants to:

• summarize a Douyin link
• summarize a Xiaohongshu link
• get a concise AI-generated summary after transcription
• receive only the final summary output instead of the raw transcription payload

Do not use this skill for:

• YouTube links
• /api/generate_note
• returning the full raw transcription JSON by default
• any workflow outside the final summary result

Required Inputs

This skill needs:

1. url
2. platform

Infer platform when possible:

• douyin for douyin.com or v.douyin.com
• xiaohongshu for xiaohongshu.com or xhslink.com

If the platform cannot be inferred reliably, ask the user to specify douyin or xiaohongshu.

Workflow

1. Check whether the user provided url.
2. Infer platform from the link when possible.
3. If url is missing, ask for it and stop.
4. If platform cannot be inferred, ask for it and stop.
5. Create a transcription task with POST /api/service/transcriptions:

Use https://linktranscriber.store/linktranscriber-api by default. If LINK_SKILL_API_BASE_URL is set, use that override instead.

{
  "url": "https://...",
  "platform": "xiaohongshu"
}

6. Extract data.task_id from the creation response.
7. Poll GET /api/service/transcriptions/{task_id} until the task reaches a final successful state. Keep polling while status is any non-final in-progress value such as: PENDING, PARSING, DOWNLOADING, TRANSCRIBING, SUMMARIZING, FORMATTING, SAVING.
8. Call POST /api/service/summaries with:

{
  "transcription_task_id": "task-id",
  "provider_id": "deepseek",
  "model_name": "deepseek-chat"
}

9. Return only data.summary_markdown to the user.

The public skill should not ask end users to provide platform cookies by default. Cookie handling belongs to the server-side configuration layer.

Output Rules