{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tencent-cloud-cos",
    "name": "腾讯云COS存储",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/ShawnMinh/tencent-cloud-cos",
    "canonicalUrl": "https://clawhub.ai/ShawnMinh/tencent-cloud-cos",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/tencent-cloud-cos",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tencent-cloud-cos",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/setup.sh",
      "scripts/cos_node.mjs",
      "references/api_reference.md",
      "references/config_template.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tencent-cloud-cos"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/tencent-cloud-cos",
    "agentPageUrl": "https://openagent3.xyz/skills/tencent-cloud-cos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tencent-cloud-cos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tencent-cloud-cos/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "腾讯云 COS 技能",
        "body": "通过 cos-mcp MCP 工具 + Node.js SDK 脚本 + COSCMD 管理腾讯云对象存储和数据万象。"
      },
      {
        "title": "首次使用 — 自动设置",
        "body": "当用户首次要求操作 COS 时，按以下流程操作："
      },
      {
        "title": "步骤 1：检查当前状态",
        "body": "{baseDir}/scripts/setup.sh --check-only\n\n如果输出显示一切 OK（cos-mcp 已安装、凭证已配置），跳到「执行策略」。"
      },
      {
        "title": "步骤 2：如果未配置，引导用户提供凭证",
        "body": "告诉用户：\n\n我需要你的腾讯云凭证来连接 COS 存储服务。请提供：\n\nSecretId — 腾讯云 API 密钥 ID\nSecretKey — 腾讯云 API 密钥 Key\nRegion — 存储桶区域（如 ap-guangzhou）\nBucket — 存储桶名称（格式 name-appid，如 mybucket-1250000000）\nDatasetName（可选） — 数据万象数据集名称（仅智能搜索需要）\nDomain（可选） — 自定义域名，用于替换默认的 COS 访问域名（如 cdn.example.com）\nServiceDomain（可选） — 自定义服务域名，用于自定义 COS API 请求域名\nProtocol（可选） — 协议，如 https 或 http\n\n你可以在 腾讯云控制台 > 访问管理 > API密钥管理 获取密钥，\n在 COS 控制台 查看存储桶信息。"
      },
      {
        "title": "步骤 3：用户提供凭证后，运行自动设置",
        "body": "{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\"\n\n如有 DatasetName：\n\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --dataset \"<DatasetName>\"\n\n如需自定义域名（可选参数按需添加）：\n\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --domain \"<Domain>\" --service-domain \"<ServiceDomain>\" --protocol \"<Protocol>\"\n\n脚本会自动：\n\n检查并安装 mcporter（MCP 命令行工具）\n检查并安装 cos-mcp 和 cos-nodejs-sdk-v5\n创建/更新 ~/.mcporter/mcporter.json，写入 cos-mcp 服务器配置\n将凭证写入 shell 配置文件（~/.zshrc 或 ~/.bashrc），重启后仍可用\n配置 coscmd（如有 Python 环境）\n验证 COS 连接\n\n设置完成后即可开始使用。"
      },
      {
        "title": "执行策略",
        "body": "三种方式按优先级降级，确保操作始终可完成：\n\n方式一：cos-mcp MCP 工具（优先） — 功能最全，支持存储 + 图片处理 + 智能搜索 + 文档媒体处理\n方式二：Node.js SDK 脚本 — 通过 scripts/cos_node.mjs 执行存储操作\n方式三：COSCMD 命令行 — 通过 shell 命令执行存储操作\n\nmcporter + cos-mcp 可用？（which mcporter && 配置存在）\n  ├─ 是 → 使用方式一 mcporter 调用（全部功能）\n  └─ 否 → cos-mcp MCP 工具可直接调用？（getCosConfig 返回结果）\n              ├─ 是 → 使用方式一直接调用（全部功能）\n              └─ 否 → Node.js + cos-nodejs-sdk-v5 可用？\n                        ├─ 是 → 使用方式二（存储操作）\n                        └─ 否 → coscmd 可用？（which coscmd）\n                                  ├─ 是 → 使用方式三（存储操作）\n                                  └─ 否 → 运行 setup.sh 安装\n\n判断方式一(mcporter)：which mcporter 且 cat ~/.mcporter/mcporter.json | grep cos-mcp 有输出。\n判断方式一(直接)：尝试调用 getCosConfig MCP 工具，若返回结果则可用。\n判断方式二：node -e \"require('cos-nodejs-sdk-v5')\" 成功则可用。\n判断方式三：which coscmd 有输出则可用。"
      },
      {
        "title": "方式一：cos-mcp MCP 工具（优先）",
        "body": "GitHub: https://github.com/Tencent/cos-mcp\n\nMCP 配置模板见 references/config_template.json。"
      },
      {
        "title": "调用格式",
        "body": "通过 mcporter 命令行调用 cos-mcp MCP 工具：\n\nmcporter call cos-mcp.<tool_name> --config ~/.mcporter/mcporter.json --output json [--args '<JSON>']\n\n列出所有可用工具：\n\nmcporter list cos-mcp --config ~/.mcporter/mcporter.json --schema\n\n判断 mcporter 是否可用：which mcporter 且 ~/.mcporter/mcporter.json 包含 cos-mcp 配置。\n如果 mcporter 不可用，可回退到客户端直接调用 MCP 工具（getCosConfig 等）。"
      },
      {
        "title": "工具总览",
        "body": "类别说明存储操作上传、下载、列出、获取签名URL图片处理质量评估、超分辨率、抠图、二维码识别、水印智能搜索以图搜图、文本搜图（需预建数据集）文档媒体文档转PDF、视频智能封面（异步任务）"
      },
      {
        "title": "常用操作",
        "body": "以下示例同时展示两种调用格式。mcporter 格式省略公共前缀 mcporter call cos-mcp. 和 --config ~/.mcporter/mcporter.json --output json。\n完整 mcporter 命令：mcporter call cos-mcp.<tool> --config ~/.mcporter/mcporter.json --output json --args '<JSON>'\n\n存储\n\n# 上传本地文件（mcporter 格式）\nmcporter call cos-mcp.putObject --config ~/.mcporter/mcporter.json --output json --args '{\"filePath\":\"/path/to/file.jpg\",\"targetDir\":\"images\"}'\n\n# 上传本地文件（客户端直接调用格式）\nputObject  filePath=\"/path/to/file.jpg\"  targetDir=\"images\"\n\n# 上传字符串内容\nputString  content=\"hello world\"  fileName=\"test.txt\"  targetDir=\"docs\"\n\n# 通过 URL 上传\nputObjectSourceUrl  sourceUrl=\"https://example.com/image.png\"  targetDir=\"images\"\n\n# 列出文件\ngetBucket  Prefix=\"images/\"\n\n# 下载文件\ngetObject  objectKey=\"images/photo.jpg\"\n\n# 获取签名下载链接\ngetObjectUrl  objectKey=\"images/photo.jpg\"\n\n图片处理\n\n# 图片质量评估\nassessQuality  objectKey=\"images/photo.jpg\"\n\n# AI 超分辨率\naiSuperResolution  objectKey=\"images/photo.jpg\"\n\n# AI 智能抠图\naiPicMatting  objectKey=\"images/photo.jpg\"\n\n# 二维码识别\naiQrcode  objectKey=\"images/qrcode.jpg\"\n\n# 添加文字水印\nwaterMarkFont  objectKey=\"images/photo.jpg\"  text=\"版权所有\"\n\n# 获取图片元信息\nimageInfo  objectKey=\"images/photo.jpg\"\n\n智能搜索（需预建数据集）\n\n# 以图搜图\nimageSearchPic  uri=\"https://example.com/query.jpg\"\n\n# 文本搜图\nimageSearchText  text=\"蓝天白云\"\n\n文档与媒体处理（异步任务）\n\n# 文档转 PDF\ncreateDocToPdfJob  objectKey=\"docs/report.docx\"\n# 查询任务结果\ndescribeDocProcessJob  jobId=\"<jobId>\"\n\n# 视频智能封面\ncreateMediaSmartCoverJob  objectKey=\"videos/demo.mp4\"\n# 查询任务结果\ndescribeMediaJob  jobId=\"<jobId>\"\n\n工具详细参数定义见 references/api_reference.md。"
      },
      {
        "title": "方式二：Node.js SDK 脚本",
        "body": "官方文档: https://www.tencentcloud.com/zh/document/product/436/8629\n\n当 cos-mcp 不可用时，通过 scripts/cos_node.mjs 执行存储操作。凭证从环境变量读取。\n\n支持的环境变量：\n\nTENCENT_COS_SECRET_ID / TENCENT_COS_SECRET_KEY / TENCENT_COS_REGION / TENCENT_COS_BUCKET（必需）\nTENCENT_COS_DOMAIN / TENCENT_COS_SERVICE_DOMAIN / TENCENT_COS_PROTOCOL（可选，自定义域名）"
      },
      {
        "title": "常用命令",
        "body": "以下省略 node {baseDir}/scripts/cos_node.mjs 前缀。完整格式：node {baseDir}/scripts/cos_node.mjs <action> [options]\n\n# 上传文件\nupload --file /path/to/file.jpg --key remote/path/file.jpg\n\n# 上传字符串\nput-string --content \"文本内容\" --key remote/file.txt --content-type \"text/plain\"\n\n# 下载文件\ndownload --key remote/path/file.jpg --output /path/to/save/file.jpg\n\n# 列出文件\nlist --prefix \"images/\"\n\n# 获取签名 URL\nsign-url --key remote/path/file.jpg --expires 3600\n\n# 查看文件信息\nhead --key remote/path/file.jpg\n\n# 删除文件\ndelete --key remote/path/file.jpg\n\n所有命令输出 JSON 格式，success: true 表示成功，退出码 0。"
      },
      {
        "title": "限制",
        "body": "仅支持存储操作，不支持图片处理、智能搜索、文档转换。"
      },
      {
        "title": "方式三：COSCMD 命令行",
        "body": "官方文档: https://www.tencentcloud.com/zh/document/product/436/10976\n\n当方式一和方式二均不可用时使用。配置持久化在 ~/.cos.conf。\n\n自定义域名支持（有限）：\n\nServiceDomain — 对应 coscmd 的 -e ENDPOINT 参数，设置后 Region 失效\nProtocol — 若为 http，对应 coscmd 的 --do-not-use-ssl 参数\nDomain — COSCMD 不支持 CDN 自定义域名"
      },
      {
        "title": "常用命令",
        "body": "# 上传\ncoscmd upload /path/to/file.jpg remote/path/file.jpg\ncoscmd upload -r /path/to/folder/ remote/folder/\n\n# 下载\ncoscmd download remote/path/file.jpg /path/to/save/file.jpg\ncoscmd download -r remote/folder/ /path/to/save/\n\n# 列出文件\ncoscmd list images/\n\n# 删除\ncoscmd delete remote/path/file.jpg\ncoscmd delete -r remote/folder/ -f\n\n# 签名 URL\ncoscmd signurl remote/path/file.jpg -t 3600\n\n# 文件信息\ncoscmd info remote/path/file.jpg\n\n# 复制/移动\ncoscmd copy <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\ncoscmd move <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg"
      },
      {
        "title": "限制",
        "body": "仅支持存储操作，不支持图片处理、智能搜索、文档转换。"
      },
      {
        "title": "功能对照表",
        "body": "功能方式一 cos-mcp方式二 Node SDK方式三 COSCMD上传文件✅✅✅上传字符串/Base64✅✅❌通过 URL 上传✅❌❌下载文件✅✅✅列出文件✅✅✅获取签名 URL✅✅✅删除文件❌✅✅查看文件信息❌✅✅递归上传/下载目录❌❌✅图片处理（CI）✅❌❌智能搜索✅❌❌文档转 PDF✅❌❌视频智能封面✅❌❌"
      },
      {
        "title": "使用规范",
        "body": "首次使用先运行 {baseDir}/scripts/setup.sh --check-only 检查环境\nmcporter 调用必须带 --config ~/.mcporter/mcporter.json 和 --output json\n凭证不明文展示：引导用户自行通过 setup.sh 或编辑配置文件设置\n所有文件路径（objectKey/cospath/--key）为存储桶内的相对路径，如 images/photo.jpg\n图片处理/智能搜索/文档转换仅方式一可用，不可用时明确告知用户\n异步任务（文档转换、视频封面）需通过 jobId 轮询结果\n上传后主动获取链接：上传完成后调用 getObjectUrl 或 sign-url 返回访问链接\n错误处理：调用失败时先用 setup.sh --check-only 诊断环境问题\n方式二脚本源码见 scripts/cos_node.mjs\nMCP 工具详细参数见 references/api_reference.md\nMCP 配置模板见 references/config_template.json"
      }
    ],
    "body": "腾讯云 COS 技能\n\n通过 cos-mcp MCP 工具 + Node.js SDK 脚本 + COSCMD 管理腾讯云对象存储和数据万象。\n\n首次使用 — 自动设置\n\n当用户首次要求操作 COS 时，按以下流程操作：\n\n步骤 1：检查当前状态\n{baseDir}/scripts/setup.sh --check-only\n\n\n如果输出显示一切 OK（cos-mcp 已安装、凭证已配置），跳到「执行策略」。\n\n步骤 2：如果未配置，引导用户提供凭证\n\n告诉用户：\n\n我需要你的腾讯云凭证来连接 COS 存储服务。请提供：\n\nSecretId — 腾讯云 API 密钥 ID\nSecretKey — 腾讯云 API 密钥 Key\nRegion — 存储桶区域（如 ap-guangzhou）\nBucket — 存储桶名称（格式 name-appid，如 mybucket-1250000000）\nDatasetName（可选） — 数据万象数据集名称（仅智能搜索需要）\nDomain（可选） — 自定义域名，用于替换默认的 COS 访问域名（如 cdn.example.com）\nServiceDomain（可选） — 自定义服务域名，用于自定义 COS API 请求域名\nProtocol（可选） — 协议，如 https 或 http\n\n你可以在 腾讯云控制台 > 访问管理 > API密钥管理 获取密钥， 在 COS 控制台 查看存储桶信息。\n\n步骤 3：用户提供凭证后，运行自动设置\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\"\n\n\n如有 DatasetName：\n\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --dataset \"<DatasetName>\"\n\n\n如需自定义域名（可选参数按需添加）：\n\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --domain \"<Domain>\" --service-domain \"<ServiceDomain>\" --protocol \"<Protocol>\"\n\n\n脚本会自动：\n\n检查并安装 mcporter（MCP 命令行工具）\n检查并安装 cos-mcp 和 cos-nodejs-sdk-v5\n创建/更新 ~/.mcporter/mcporter.json，写入 cos-mcp 服务器配置\n将凭证写入 shell 配置文件（~/.zshrc 或 ~/.bashrc），重启后仍可用\n配置 coscmd（如有 Python 环境）\n验证 COS 连接\n\n设置完成后即可开始使用。\n\n执行策略\n\n三种方式按优先级降级，确保操作始终可完成：\n\n方式一：cos-mcp MCP 工具（优先） — 功能最全，支持存储 + 图片处理 + 智能搜索 + 文档媒体处理\n方式二：Node.js SDK 脚本 — 通过 scripts/cos_node.mjs 执行存储操作\n方式三：COSCMD 命令行 — 通过 shell 命令执行存储操作\nmcporter + cos-mcp 可用？（which mcporter && 配置存在）\n  ├─ 是 → 使用方式一 mcporter 调用（全部功能）\n  └─ 否 → cos-mcp MCP 工具可直接调用？（getCosConfig 返回结果）\n              ├─ 是 → 使用方式一直接调用（全部功能）\n              └─ 否 → Node.js + cos-nodejs-sdk-v5 可用？\n                        ├─ 是 → 使用方式二（存储操作）\n                        └─ 否 → coscmd 可用？（which coscmd）\n                                  ├─ 是 → 使用方式三（存储操作）\n                                  └─ 否 → 运行 setup.sh 安装\n\n\n判断方式一(mcporter)：which mcporter 且 cat ~/.mcporter/mcporter.json | grep cos-mcp 有输出。 判断方式一(直接)：尝试调用 getCosConfig MCP 工具，若返回结果则可用。 判断方式二：node -e \"require('cos-nodejs-sdk-v5')\" 成功则可用。 判断方式三：which coscmd 有输出则可用。\n\n方式一：cos-mcp MCP 工具（优先）\n\nGitHub: https://github.com/Tencent/cos-mcp\n\nMCP 配置模板见 references/config_template.json。\n\n调用格式\n\n通过 mcporter 命令行调用 cos-mcp MCP 工具：\n\nmcporter call cos-mcp.<tool_name> --config ~/.mcporter/mcporter.json --output json [--args '<JSON>']\n\n\n列出所有可用工具：\n\nmcporter list cos-mcp --config ~/.mcporter/mcporter.json --schema\n\n\n判断 mcporter 是否可用：which mcporter 且 ~/.mcporter/mcporter.json 包含 cos-mcp 配置。 如果 mcporter 不可用，可回退到客户端直接调用 MCP 工具（getCosConfig 等）。\n\n工具总览\n类别\t说明\n存储操作\t上传、下载、列出、获取签名URL\n图片处理\t质量评估、超分辨率、抠图、二维码识别、水印\n智能搜索\t以图搜图、文本搜图（需预建数据集）\n文档媒体\t文档转PDF、视频智能封面（异步任务）\n常用操作\n\n以下示例同时展示两种调用格式。mcporter 格式省略公共前缀 mcporter call cos-mcp. 和 --config ~/.mcporter/mcporter.json --output json。 完整 mcporter 命令：mcporter call cos-mcp.<tool> --config ~/.mcporter/mcporter.json --output json --args '<JSON>'\n\n存储\n# 上传本地文件（mcporter 格式）\nmcporter call cos-mcp.putObject --config ~/.mcporter/mcporter.json --output json --args '{\"filePath\":\"/path/to/file.jpg\",\"targetDir\":\"images\"}'\n\n# 上传本地文件（客户端直接调用格式）\nputObject  filePath=\"/path/to/file.jpg\"  targetDir=\"images\"\n\n# 上传字符串内容\nputString  content=\"hello world\"  fileName=\"test.txt\"  targetDir=\"docs\"\n\n# 通过 URL 上传\nputObjectSourceUrl  sourceUrl=\"https://example.com/image.png\"  targetDir=\"images\"\n\n# 列出文件\ngetBucket  Prefix=\"images/\"\n\n# 下载文件\ngetObject  objectKey=\"images/photo.jpg\"\n\n# 获取签名下载链接\ngetObjectUrl  objectKey=\"images/photo.jpg\"\n\n图片处理\n# 图片质量评估\nassessQuality  objectKey=\"images/photo.jpg\"\n\n# AI 超分辨率\naiSuperResolution  objectKey=\"images/photo.jpg\"\n\n# AI 智能抠图\naiPicMatting  objectKey=\"images/photo.jpg\"\n\n# 二维码识别\naiQrcode  objectKey=\"images/qrcode.jpg\"\n\n# 添加文字水印\nwaterMarkFont  objectKey=\"images/photo.jpg\"  text=\"版权所有\"\n\n# 获取图片元信息\nimageInfo  objectKey=\"images/photo.jpg\"\n\n智能搜索（需预建数据集）\n# 以图搜图\nimageSearchPic  uri=\"https://example.com/query.jpg\"\n\n# 文本搜图\nimageSearchText  text=\"蓝天白云\"\n\n文档与媒体处理（异步任务）\n# 文档转 PDF\ncreateDocToPdfJob  objectKey=\"docs/report.docx\"\n# 查询任务结果\ndescribeDocProcessJob  jobId=\"<jobId>\"\n\n# 视频智能封面\ncreateMediaSmartCoverJob  objectKey=\"videos/demo.mp4\"\n# 查询任务结果\ndescribeMediaJob  jobId=\"<jobId>\"\n\n\n工具详细参数定义见 references/api_reference.md。\n\n方式二：Node.js SDK 脚本\n\n官方文档: https://www.tencentcloud.com/zh/document/product/436/8629\n\n当 cos-mcp 不可用时，通过 scripts/cos_node.mjs 执行存储操作。凭证从环境变量读取。\n\n支持的环境变量：\n\nTENCENT_COS_SECRET_ID / TENCENT_COS_SECRET_KEY / TENCENT_COS_REGION / TENCENT_COS_BUCKET（必需）\nTENCENT_COS_DOMAIN / TENCENT_COS_SERVICE_DOMAIN / TENCENT_COS_PROTOCOL（可选，自定义域名）\n常用命令\n\n以下省略 node {baseDir}/scripts/cos_node.mjs 前缀。完整格式：node {baseDir}/scripts/cos_node.mjs <action> [options]\n\n# 上传文件\nupload --file /path/to/file.jpg --key remote/path/file.jpg\n\n# 上传字符串\nput-string --content \"文本内容\" --key remote/file.txt --content-type \"text/plain\"\n\n# 下载文件\ndownload --key remote/path/file.jpg --output /path/to/save/file.jpg\n\n# 列出文件\nlist --prefix \"images/\"\n\n# 获取签名 URL\nsign-url --key remote/path/file.jpg --expires 3600\n\n# 查看文件信息\nhead --key remote/path/file.jpg\n\n# 删除文件\ndelete --key remote/path/file.jpg\n\n\n所有命令输出 JSON 格式，success: true 表示成功，退出码 0。\n\n限制\n\n仅支持存储操作，不支持图片处理、智能搜索、文档转换。\n\n方式三：COSCMD 命令行\n\n官方文档: https://www.tencentcloud.com/zh/document/product/436/10976\n\n当方式一和方式二均不可用时使用。配置持久化在 ~/.cos.conf。\n\n自定义域名支持（有限）：\n\nServiceDomain — 对应 coscmd 的 -e ENDPOINT 参数，设置后 Region 失效\nProtocol — 若为 http，对应 coscmd 的 --do-not-use-ssl 参数\nDomain — COSCMD 不支持 CDN 自定义域名\n常用命令\n# 上传\ncoscmd upload /path/to/file.jpg remote/path/file.jpg\ncoscmd upload -r /path/to/folder/ remote/folder/\n\n# 下载\ncoscmd download remote/path/file.jpg /path/to/save/file.jpg\ncoscmd download -r remote/folder/ /path/to/save/\n\n# 列出文件\ncoscmd list images/\n\n# 删除\ncoscmd delete remote/path/file.jpg\ncoscmd delete -r remote/folder/ -f\n\n# 签名 URL\ncoscmd signurl remote/path/file.jpg -t 3600\n\n# 文件信息\ncoscmd info remote/path/file.jpg\n\n# 复制/移动\ncoscmd copy <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\ncoscmd move <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\n\n限制\n\n仅支持存储操作，不支持图片处理、智能搜索、文档转换。\n\n功能对照表\n功能\t方式一 cos-mcp\t方式二 Node SDK\t方式三 COSCMD\n上传文件\t✅\t✅\t✅\n上传字符串/Base64\t✅\t✅\t❌\n通过 URL 上传\t✅\t❌\t❌\n下载文件\t✅\t✅\t✅\n列出文件\t✅\t✅\t✅\n获取签名 URL\t✅\t✅\t✅\n删除文件\t❌\t✅\t✅\n查看文件信息\t❌\t✅\t✅\n递归上传/下载目录\t❌\t❌\t✅\n图片处理（CI）\t✅\t❌\t❌\n智能搜索\t✅\t❌\t❌\n文档转 PDF\t✅\t❌\t❌\n视频智能封面\t✅\t❌\t❌\n使用规范\n首次使用先运行 {baseDir}/scripts/setup.sh --check-only 检查环境\nmcporter 调用必须带 --config ~/.mcporter/mcporter.json 和 --output json\n凭证不明文展示：引导用户自行通过 setup.sh 或编辑配置文件设置\n所有文件路径（objectKey/cospath/--key）为存储桶内的相对路径，如 images/photo.jpg\n图片处理/智能搜索/文档转换仅方式一可用，不可用时明确告知用户\n异步任务（文档转换、视频封面）需通过 jobId 轮询结果\n上传后主动获取链接：上传完成后调用 getObjectUrl 或 sign-url 返回访问链接\n错误处理：调用失败时先用 setup.sh --check-only 诊断环境问题\n方式二脚本源码见 scripts/cos_node.mjs\nMCP 工具详细参数见 references/api_reference.md\nMCP 配置模板见 references/config_template.json"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ShawnMinh/tencent-cloud-cos",
    "publisherUrl": "https://clawhub.ai/ShawnMinh/tencent-cloud-cos",
    "owner": "ShawnMinh",
    "version": "1.0.6",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tencent-cloud-cos",
    "downloadUrl": "https://openagent3.xyz/downloads/tencent-cloud-cos",
    "agentUrl": "https://openagent3.xyz/skills/tencent-cloud-cos/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tencent-cloud-cos/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tencent-cloud-cos/agent.md"
  }
}