wecomcli-media

Original：🇨🇳 Chinese

Translated

WeCom Media File Upload/Download Skill. Handles two types of operations: downloading media files to local based on media_id, and uploading local files to obtain media_id. When other skills (such as WeCom Disk, Email, etc.) return a media_id that needs to be saved as a local file, or when an existing local file needs to be converted to a media_id for use by other skills, you must first read this skill to get complete guidelines and not handle it based on memory. This skill does not parse/identify file content, only responsible for file transfer.

11installs

Sourcewecomteam/wecom-cli

Added on2026-08-17

NPX Install

npx skill4agent add wecomteam/wecom-cli wecomcli-media

SKILL.md Content (Chinese)

View Translation Comparison →

WeCom Media Files

Before executing any
wecom-cli
command, you must first read and complete the common pre-checks of the
wecomcli-shared
skill.

A resource-type skill responsible for downloading media files to local based on

media_id

and uploading local files to generate

media_id

. It is a basic dependency for other skills (such as WeCom Disk, Email, etc.) to handle

media_id

-related operations:

upload

will generate a new

media_id

, but this skill does not search/discover existing

media_id

in other business scenarios (e.g.,

media_id

of email attachments or WeCom Disk files are generated by corresponding business skills), nor does it parse file content.

Scope of Application

Applicable Scenarios

Download media files to local based on
```
media_id
```
provided by other skills or users
Upload local files (with known local path) to obtain
```
media_id
```
for subsequent use by other skills (such as uploading materials to WeCom Disk)

Inapplicable Scenarios

Parse/identify file content (text extraction, OCR, image Q&A, PDF/Word/Excel parsing, etc.) → This skill only downloads files to local to get
```
file_path
```
. If you need to view the content, please directly read the local file via
```
file_path
```
Search/discover existing
```
media_id
```
in other business scenarios (such as email attachments, WeCom Disk file list/search, etc.) → Corresponding business skills are responsible for generating and returning
```
media_id
```
. This skill only accepts existing
```
media_id
```
for download; for converting local files to
```
media_id
```
, still use the
```
upload
```
function of this skill
Fabricate or guess
```
media_id
```
/ local file path → Both must come from other skills' returns or be clearly provided by users. Fabrication is prohibited

Interface Details

Download Media File

Download media files to local based on

media_id

and return the local file path.

Command

bash

wecom-cli media download --json '{"media_id": "MEDIA_ID"}'

Input Parameters

Field	Type	Required	Description
`media_id`	string	Yes	`media_id` of the file, obtained after file upload or returned by other skills (such as email attachments/embedded images, etc.)

Return

Field	Type	Description
`file_path`	string	Local file path after successful download

Usage Rules

If you need to view the file content after download, directly read the local file via
```
file_path
```
.
Return error code and error message when download fails.
media_id
must be a real media_id, no URLs of any form are accepted: If you get a link (such as
```
attach_url
```
, image/attachment link in the text), do not pass this URL as
```
media_id
```
to this interface, as it will directly report an error. Especially for anti-leakage encrypted links with the feature
```
work.weixin.qq.com/filepreview/security/
```
, which are encrypted resources bound to user identity, this interface cannot download or decrypt them. You should directly inform the user that the file is protected by anti-leakage policies, guide them to click the link and open/view/save it in the WeCom client, and do not attempt to bypass it using this interface or other means.

Upload Media File

Upload local files to obtain

media_id

.