699pic OpenAPI

使用该技能执行 699pic 企业资产的查询与下载相关工作流。

前置条件

使用该技能前，请确认以下事项：

• node 必须已安装。当前环境中本仓库已提供本地可用的 Node.js。
• 如需使用 MCP 路径，则必须安装 mcporter。当前环境未预装 mcporter，因此所有 MCP 命令须在目标机器上预先验证后方可使用。
• SERVICE_API_KEY 必须通过环境变量提供，禁止硬编码或依赖共享默认密钥。
• 仅当您信任目标 699pic 企业服务时，才应提供您自己的 SERVICE_API_KEY。
• 若您的部署未使用脚本默认地址（https://pre-st-api.699pic.com），则需通过环境变量提供 SERVICE_API_BASE_URL。
• 任何本地配置的 mcporter 或服务端点，均须经审查与授权后方可使用。

本仓库推荐的本地脚本路径：

• scripts/openapi.js

可信性与审计要求

在运行打包脚本或任何指向同一服务的 MCP 注册项之前，请完成以下检查：

1. 请自行检查 scripts/openapi.js 源码。
2. 确认脚本向 SERVICE_API_BASE_URL 发起 POST 请求，并在 x-api-key 请求头中携带 API 密钥。
3. 确认是否存在名为 st-mcp 的本地 mcporter 注册项，并全面审查其配置、命令、环境变量及权限设置。
4. 若发布方可更新注册表元数据，请要求其同步在元数据中声明所需的环境变量与二进制依赖。

快速工作流

1. 若用户需要候选素材，应首先执行搜索。
2. 对每个搜索结果，默认输出 Markdown 格式的图像文档，而非纯链接或原始 JSON 数据。每项候选内容均须以实际 Markdown 图像形式渲染其预览图/缩略图。
3. 在声明某资产“已下载”前，须调用已下载检查接口（downloaded-check endpoint）进行确认。
4. 在生成下载链接前，须明确资产类型（photo 或 video）及资产 ID。
5. 若 MCP 路径不稳定，应直接使用打包脚本，避免因 MCP 问题阻塞流程。

推荐执行顺序

选项 A：通过 mcporter 注册的 MCP

当需要以工具化方式调用 MCP 时，请优先尝试此路径：

mcporter config get st-mcp --json
mcporter call st-mcp.search_photos keywords=春节 limit=5 --output json
mcporter call st-mcp.search_videos keywords=城市航拍 limit=5 --output json
mcporter call st-mcp.check_downloaded content_id=701095246 type=1 --output json

运行 MCP 命令前，请确认：

• 本地 mcporter 项目配置文件所在路径。
• 该配置中是否存在服务器名称 st-mcp。
• 对该注册项的命令、参数、环境变量及权限设置进行全面审查。

已注册的服务器名称：

• st-mcp

选项 B：打包脚本直连回退方案

若 mcporter/MCP 出现超时，请直接使用打包脚本：

node /absolute/path/to/st-ent-skills/scripts/openapi.js search-photos 春节 5
node /absolute/path/to/st-ent-skills/scripts/openapi.js search-videos 城市航拍 5
node /absolute/path/to/st-ent-skills/scripts/openapi.js check-downloaded 701095246 1
node /absolute/path/to/st-ent-skills/scripts/openapi.js download-asset photo 701095246
node /absolute/path/to/st-ent-skills/scripts/openapi.js download-records 1 1 10

使用回退脚本前，请确认：

• 已在 shell 或进程环境中导出 SERVICE_API_KEY。
• 若当前环境不应使用默认基础 URL，请显式设置 SERVICE_API_BASE_URL。
• 在将脚本指向内部服务前，请审阅 scripts/openapi.js 源码。
• 禁止使用未知的共享 API 密钥。

任务说明

图片搜索

当用户需要图像素材、海报元素、插画、摄影图等资源时，使用图片搜索功能。

返回 Markdown 格式的图像文档。

每项候选内容须包含以下字段：

• 以 Markdown 图像形式渲染预览图/缩略图，例如 ![标题](https://...)
• asset_id
• 标题
• 扩展名
• 如可获取，须包含 premium/AIGC 等基础标识

若存在预览图 URL，不得默认返回纯 URL 列表。

视频搜索

当用户需要视频素材、航拍镜头、动态背景、片头片尾等资源时，使用视频搜索功能。

只要存在预览图/缩略图，即应采用与图片搜索一致的 Markdown 图像文档格式返回结果；若为视频资产且仅有缩略图，则仍以 Markdown 图像形式渲染该缩略图。

检查是否已下载

在声明“已购买/已下载”或提示用户重新下载前，必须调用此功能进行确认。

输入参数：

• content_id
• type（1 表示图片，2 表示视频）
• 可选 year

生成下载链接

仅在明确以下信息后方可调用：

• 资产类型
• 资产 ID
• 如调用方指定了文件类型，则一并传入（可选）

若用户尚未明确指定目标资产，禁止猜测上述字段。

查看下载记录

适用于企业级历史查询类需求，例如：

• 最近下载了哪些内容
• 某一年度的下载记录
• 图片/视频下载明细

响应风格

优先采用紧凑摘要形式，避免直接输出完整 JSON。

所有 search_* 类操作的结果，默认输出必须为嵌入图像的 Markdown 文档。

默认格式要求如下：

• 先返回 3–5 条候选结果
• 每条候选均以 Markdown 图像开头，例如 ![标题](图片URL)
• 图像下方补充 asset_id、标题、扩展名、必要标签等信息
• 若图片 URL 以 // 开头，需补全为 https://...
• 仅当用户明确要求 JSON 或原始数据时，才输出纯字段列表

推荐模板：

**1. 标题**  
![标题](https://example.com/preview.jpg)

- asset_id: `123456`
- extension: `psd`
- is_aigc: `0`
- is_premium: `0`

当用户要求查看或搜索图像时，禁止默认返回裸 URL。

参考资料

如需了解本地集成细节或参考示例命令，请查阅：

• references/api.md