linkfox-echotik-get-video-download-url — Claude Code skill
linkfox-echotik-get-video-download-url — a skill for Claude Code, Codex, and Cursor that parses TikTok URLs into direct download links, preview streams, and covers. It requires an existing video link to trigger extraction.
MIT 232 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a claude-codeWhat linkfox-echotik-get-video-download-url does
Supported across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It takes a full TikTok link or a short sharing URL and fetches watermark-free downloads, standard video links, playback streams, plus static and dynamic cover images. It does not handle product discovery or downloads from other networks.
Execution runs either through an API endpoint or the helper script python scripts/echotik_get_video_download_url.py. The tool writes local session data to linkfox/<YYYY-MM-DD>/<session>/data/ and rejects writes to /tmp. Results sit in a 24-hour local cache, which can be bypassed via --no-cache whenever temporary media URLs expire.
Each API lookup consumes an estimated 5 compute credits. If LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY is missing, the request halts immediately with a 401 error.
What it helps with
- fetch watermark-free TikTok videos for promotional asset backup
- extract static and dynamic video thumbnails
- obtain playable preview streams from TikTok share links
- archive marketing creative assets before URLs expire
Example prompts for the agent
- Extract the watermark-free download URL for this TikTok video link
- Get the static and dynamic cover images for this TikTok clip
- Parse this TikTok share link and give me the direct playback URL
How to install linkfox-echotik-get-video-download-url
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-echotik-get-video-download-url/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-echotik-get-video-download-url/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a codex2Manually: put the files in place
.agents/skills/linkfox-echotik-get-video-download-url/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a cursor2Manually: put the files in place
.cursor/skills/linkfox-echotik-get-video-download-url/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-echotik-get-video-download-url2Manually: put the files in place
.github/skills/linkfox-echotik-get-video-download-url/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-echotik-get-video-download-urlManually: put the files in place
.devin/skills/linkfox-echotik-get-video-download-url/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-echotik-get-video-download-url
How to install linkfox-echotik-get-video-download-url in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-get-video-download-url -a claude-code. The tool definition installs to ~/.claude/skills/linkfox-echotik-get-video-download-url/SKILL.md.
What does linkfox-echotik-get-video-download-url do?
It queries the EchoTik interface to extract watermark-free downloads, standard video links, preview addresses, and thumbnail graphics from specific TikTok URLs.
Which environment variables are required?
You must define either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY and maintain sufficient account compute units for the calls.
Source text
SKILL.md · MIT
--- name: linkfox-echotik-get-video-download-url description: 解析指定 TikTok 视频链接,获取无水印或含水印下载地址、播放地址及静态和动态封面,适用于保存带货视频素材、离线分析、视频预览和封面提取。用户已有具体 TikTok 视频链接,希望下载、保存或提取媒体地址时使用,无需明确提及 EchoTik。不适用于按商品发现关联视频、商品搜索或新品排行、直播数据、视频剪辑创作和其他平台视频下载。 --- # EchoTik TikTok 视频下载地址解析 ## 适用范围 ### 适用 从用户提供的具体 TikTok 视频链接提取可用媒体地址,帮助保存达人带货或推广视频素材、离线分析与预览。 **场景速查** | 用户表达 | 查询场景 | |----------|----------| | 下载或保存这个 TikTok 视频 | 解析指定视频的下载地址。 | | 获取这个 TikTok 视频的无水印版本 | 优先展示可用的无水印下载地址。 | | 保存这个达人的带货视频素材 | 解析已知视频链接以便归档。 | | 给我一个能播放的 TikTok 视频地址 | 展示播放地址供预览。 | | 提取这个视频的封面或缩略图 | 展示静态与动态封面。 | ### 边界 用户已有具体视频链接并希望保存、下载或提取地址时使用本技能;若用户只有商品编号并想查找推广该商品的视频,转交 `linkfox-echotik-product-video`。商品搜索使用 `linkfox-echotik-list-product`,新品排行使用 `linkfox-echotik-list-new-product-rank`。直播数据、视频剪辑或创作建议及非 TikTok 平台下载不在本技能范围内。 ## 前置条件 **先取得具体视频链接**:用户尚未提供链接时先补充,不以商品编号代替。支持的格式及参数要求见 `references/api.md`。 ## 视频解析流程 1. 判断用户需要解析已知视频,还是发现商品关联视频;仅对已取得的具体视频链接继续。 2. 按 `references/api.md` 准备请求,复用同一会话同一参数的已有结果或本地缓存,执行一次解析。 3. 按接口定义判断响应;解析失败时依据实际错误说明原因,不自动反复试探。 4. 按下方“约束与建议”展示实际返回的媒体地址。 ## 执行方式 - **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。 - **脚本调用(推荐)**:`python scripts/echotik_get_video_download_url.py '<JSON 参数>' [--inline]`。 - **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。 ### 输出策略 - 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-get-video-download-url-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。 - 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。 - 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。 先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。 ## 执行规则 ### 算力消耗预估 5 算力 / 次 **声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。 用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。 ### 解决认证和算力问题 出现以下情况时,按 `references/onboarding.md` 的指引处理: - 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。 - 响应状态码为 `401` 或 `402`。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。 ### 约束与建议 - **区分媒体用途**:无水印和含水印地址用于下载,播放地址用于预览,静态与动态封面用于缩略图展示。 - **优先无水印**:存在无水印地址时,将其列为首选下载项;同时展示实际返回的含水印版本供用户选择。 - **不补造下载地址**:未返回下载地址时,明确说明该视频暂无直接下载地址,改为展示播放预览;不要把播放地址标成已取得的下载地址。条件返回约定见 `references/api.md`。 - **完整展示可用素材**:补充播放地址、静态封面和动态封面;仅展示真实返回的数据,不附加主观素材使用建议。 - **说明时效**:解析后的下载及播放地址可能过期,应及时使用;失效后需要重新解析时,脚本使用 `--no-cache` 跳过可能仍在 24 小时有效期内的旧缓存,避免再次返回已失效地址;不自动重试,后续调用遵守成本约束。 - **解释错误**:根据实际响应说明原因并建议核对视频链接;具体业务码与处理方式见 `references/api.md`。 ## 使用示例 ### 解析完整视频链接 用户:下载这个 TikTok 视频,优先给我无水印版本。 取得用户提供的完整视频链接后执行解析,按返回情况展示无水印、含水印及预览地址,提醒及时使用。 ### 解析短链接并提取封面 用户:从这个 TikTok 分享短链提取视频和封面。 将用户提供的短链用于解析,展示可用下载地址、播放地址和静态、动态封面;没有下载地址时明确说明并提供播放预览。 ## 使用反馈 当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。 --- 更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills