无水印媒体解析助手

技能文档

---
name: nologo-open-api
title: 无水印媒体解析助手
category: 内容创作
description: 解析抖音、小红书、豆包、千问等平台分享链接，获取无水印图片/视频直链，支持配置自有解析服务端点、直链提取与批量保存。当用户需要去除视频/图片水印、保存无水印素材、获取无水印直链、调用解析接口时使用此技能。
version: 1.1.0
---

# 无水印媒体解析助手

解析主流内容平台（抖音、小红书、豆包、千问等）的分享链接，获取无水印图片/视频直链，用于个人备份与创作素材整理。

## 前置配置

本技能通过通用 HTTP 接口对接解析服务，使用前需准备：

1. **服务端点**：自建或第三方解析服务的接口地址（`base_url`），接口契约见下方「响应格式」
2. **访问凭证**：解析服务的 Token，写入 `references/config.json`：

```json
{
  "base_url": "https://你的解析服务地址/api/parse",
  "token": "你的Token"
}
```

配置方式（任选其一）：

```bash
# 方式一：使用客户端脚本写入配置
node references/api-client.js set-config

# 方式二：直接编辑 references/config.json
```

## 技能工作流

### 步骤1：获取分享链接

让用户从内容 App 的分享功能复制链接（如 `https://v.douyin.com/xxxxx`）。链接必须先做 URL 编码再传参。

### 步骤2：判断媒体类型

- 视频笔记/作品 → 解析后返回单个无水印视频直链
- 图文笔记 → 解析后返回全部无水印原图直链数组

### 步骤3：调用解析接口

```bash
node references/api-client.js parse "https://v.douyin.com/xxxxx"
```

或直接请求：`GET {base_url}?url={URL编码后的链接}`，请求头 `Authorization: {token}`。

### 步骤4：整理并交付结果

- 向用户展示标题、描述与直链清单（多条目逐一列出）
- 提示直链有时效性，建议尽快下载保存
- 展示套餐剩余次数（响应 `usage` 字段），次数不足时提醒用户到服务提供方续费

## 响应格式

### 成功响应 - 图片

```json
{
  "code": 200,
  "message": "success",
  "data": {
    "type": "img",
    "urls": ["xx", "xx"],
    "title": "xx",
    "desc": "xx",
    "usage": { "totalLimit": "xxx", "usedCount": "xxx", "remainingCount": "xxx" }
  }
}
```

### 成功响应 - 视频

```json
{
  "code": 200,
  "message": "请求成功",
  "data": {
    "type": "video",
    "url": "xx",
    "title": "xx",
    "desc": "xx",
    "usage": { "totalLimit": "xxx", "usedCount": "xxx", "remainingCount": "xxx" }
  }
}
```

## 错误码

| 错误码 | 含义 |
|--------|------|
| 400 | URL 参数为空或格式不正确 |
| 401 | 缺少 Token，未在 Authorization 请求头传递 |
| 403 | Token 无效 / 已禁用 / 调用次数耗尽 |
| 404 | 资源未找到或解析失败 |
| 500 | 服务端内部错误 |

## 使用边界

- 仅用于用户有权保存的内容（自己的作品、已获授权或平台允许保存的内容），尊重原创作者版权
- 不得用于批量爬取、二次分发他人作品或去除版权标识后商用
- 解析能力依赖所配置的服务端点，本技能不内置任何具体服务商

使用说明

# 无水印媒体解析助手

解析抖音、小红书、豆包、千问等平台分享链接，获取无水印图片/视频直链。

## 功能

- 视频解析：分享链接 → 无水印视频直链
- 图集解析：图文笔记 → 全部无水印原图直链
- 可配置端点：对接自建或第三方解析服务，Token 本地保存

## 快速使用

```bash
# 首次使用：配置解析服务端点与 Token
node references/api-client.js set-config

# 解析链接
node references/api-client.js parse "https://v.douyin.com/xxxxx"
```

## 说明

- 直链有时效性，解析后请尽快下载
- 仅用于有权保存的内容，请尊重原创作者版权
- 接口契约与错误码见 SKILL.md

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。