# Wechat Send File

> Send a file or image to WeChat via TeamMCP. Use when the user wants to send a file, image, or document to WeChat.

- Skill: `cookjohn/wechat-send-file` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cookjohn/wechat-send-file`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cookjohn/wechat-send-file/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cookjohn (https://skillmd.com/u/cookjohn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/cookjohn/wechat-send-file

---


# Send File to WeChat

Send a local file (image, document, video) to WeChat via the TeamMCP WeChat bridge.

## Arguments

$ARGUMENTS contains the file path to send. If not provided, ask the user which file to send.

## Steps

### 1. Validate File

Check the file exists and get its size:

```
Use the Bash tool to run: ls -la "$ARGUMENTS"
```

If the file doesn't exist, tell the user and ask for a correct path.

### 2. Check WeChat Connection

Call the TeamMCP API to verify WeChat is connected:

```
Use the Bash tool to run:
curl -s http://localhost:3100/api/wechat/status -H "Authorization: Bearer $TEAMMCP_KEY"
```

If `connected` is false, tell the user to connect WeChat first via the Dashboard.

### 3. Send File

Call the send-file API:

```
Use the Bash tool to run:
node -e "
fetch('http://localhost:3100/api/wechat/send-file', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer $TEAMMCP_KEY' },
  body: JSON.stringify({ file_path: '$ARGUMENTS' })
}).then(r=>r.json()).then(d => {
  if (d.ok) console.log('File sent:', d.fileName, '(' + d.size + ' bytes)');
  else console.error('Failed:', d.error);
});
"
```

### 4. Report Result

Tell the user whether the file was sent successfully, including the filename and size.

## Supported File Types

| Type | Extensions | WeChat Display |
|------|-----------|----------------|
| Image | jpg, jpeg, png, gif, bmp, webp | Inline image |
| Video | mp4, avi, mov, wmv, mkv | Video player |
| File | All others (pdf, doc, md, txt, etc.) | File attachment |

## How It Works

1. File is encrypted with AES-128-ECB (random key)
2. Encrypted data is uploaded to WeChat CDN via `getuploadurl` + POST
3. CDN returns a download parameter
4. `sendmessage` sends the media reference to the WeChat user

## Prerequisites

- WeChat bridge must be connected (scan QR code via Dashboard)
- A recent WeChat message from the user is needed (provides context_token, valid 24h)