API 接口文档

左侧选择接口,右侧查看说明与示例。所有对外接口都需要 API Key。

OSS 文件上传

调用方直接上传文件到优资快报 OSS。可只存文件拿公开 URL,也可指定 purpose 走与 /admin/file-upload 相同的 Semrush Excel 异步处理。

POST /api/admin/oss/upload

用途

后台「文件上传」会把 Excel 存到 OSS,再创建 upload_tasks 异步解析。本接口把同一能力开放给 API / MCP 调用方。

  • purpose=general(默认):只上传 OSS,返回 url / key
  • purpose=backlinks:Semrush 外链 Excel/CSV,后台处理逻辑与 file-upload 一致,返回 taskId
  • purpose=seo_ranking:Semrush 关键词 Excel/CSV,同上

认证

Authorization: Bearer <API_KEY> 或登录 Token;亦可 X-API-Key。

方式一:JSON + Base64(适合 MCP)

POST /api/admin/oss/upload
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "fileName": "semrush-backlinks.xlsx",
  "contentBase64": "<BASE64>",
  "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
  "purpose": "backlinks"
}

方式二:multipart(适合大文件 / 脚本)

curl -X POST "https://youzikuaibao.com.cn/api/admin/oss/upload" \
  -H "Authorization: Bearer <API_KEY>" \
  -F "file=@./semrush-keywords.xlsx" \
  -F "purpose=seo_ranking"

参数

字段说明
fileNameJSON 必填;multipart 用文件名
contentBase64JSON 必填;可带 data:...;base64, 前缀
contentType可选 MIME
purposegeneral|backlinks|seo_ranking,默认 general
category仅 general:OSS 子目录,默认 api
filemultipart 文件字段名

大小限制:general 20MB;backlinks 50MB;seo_ranking 10MB(与后台上传一致)。

响应示例(Semrush 任务)

{
  "success": true,
  "message": "外链文件上传成功,正在后台处理",
  "data": {
    "purpose": "backlinks",
    "taskId": 1234,
    "url": "https://....aliyuncs.com/uploads/backlinks/...",
    "key": "uploads/backlinks/...",
    "fileName": "semrush-backlinks.xlsx",
    "size": 204800
  }
}

进度可在后台「上传任务」查看,或沿用现有 upload-tasks 接口按 taskId 查询。

MCP

工具名 upload_oss_file。传 fileName + contentBase64 + 可选 purpose。大文件请改用 HTTP multipart。