mcpField
F
feishu-voice-sender

feishu-voice-sender

github.com/wulaosijiProductivity2874 installsUpdated 2w ago
Repository

About feishu-voice-sender

A skill for Feishu automation that converts MP3 audio into Feishu voice messages and sends them to group or direct chats. Unlike an audio attachment, the resulting voice message can be played directly in the chat.

Key features

  1. 01Convert MP3 to AMR
  2. 02Send Feishu voice messages
  3. 03Target group or direct chats
  4. 04Provide Python API and CLI usage
  5. 05Return the send result

Use cases

  1. 01Send voice notifications to group chats
  2. 02Send voice messages in direct chats
  3. 03Deliver MP3 voice messages in automated workflows
  4. 04Send audio as playable chat messages instead of attachments

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wulaosiji/skills --skill feishu-voice-sender

After installing, type/feishu-voice-senderin Claude Code to confirm it loaded.

Bundled files__init__.pyfeishu_voice_sender.py

Details

From the project README

Feishu Voice Sender

飞书语音消息发送工具 — 将 MP3 音频以语音条形式发送到飞书聊天。

When to Use

  • 需要将 MP3 音频以语音条（非文件附件）形式发送到飞书时
  • 需要向群聊或私聊发送语音通知时
  • 希望用户体验类似微信语音（点击直接播放）时
  • 需要配合自动化流程发送语音消息时
Do NOT use this skill if
  • 需要发送视频消息 → 使用 feishu-video-sender
  • 需要发送普通文本或富文本消息 → 使用 feishu-group-welcome 或标准 message 工具
  • 需要发送音频文件（让用户下载后播放）→ 直接使用 file 消息类型
Typical Trigger Phrases
  • "发送一条语音到群里"
  • "Send this MP3 as a voice message in Feishu"
  • "把这段音频转成飞书语音条"
  • "群发语音通知"

Workflow

  1. Ask for inputs: 确认音频文件路径（MP3）、目标 ID（群 ID oc_xxx 或用户 ID ou_xxx）、发送类型（chat/user）
  2. Verify environment: 确认系统已安装 ffmpeg，Python 已安装 requests
  3. Convert format: MP3 → AMR（飞书语音格式）
  4. Upload audio: 上传到飞书获取 file_key
  5. Send voice message: 使用 msg_type: "voice" 发送 
    # 发送到群聊
python3 skills/feishu-voice-sender/feishu_voice_sender.py /tmp/voice.mp3 oc_xxx --chat

# 发送到私聊
python3 skills/feishu-voice-sender/feishu_voice_sender.py /tmp/voice.mp3 ou_xxx --user
  6. Confirm delivery: 返回消息发送结果

Guardrails

  • 必须安装 ffmpeg 用于格式转换
  • 语音消息与音频文件的区别在于 msg_type：voice 直接播放，file 需要下载
  • 确保飞书应用具备发送消息的权限

Python API

from skills.feishu_voice_sender import send_voice_message

# 发送到群聊
result = send_voice_message(
    audio_path="/tmp/voice.mp3",
    target_id="oc_xxx",
    target_type="chat"
)

# 发送到私聊
result = send_voice_message(
    audio_path="/tmp/voice.mp3",
    target_id="ou_xxx",
    target_type="user"
)

Voice vs File

方式消息类型用户体验
语音条msg_type: "voice"✅ 点击播放，类似微信语音
音频文件msg_type: "file"❌ 下载后播放

Related Skills

About

Part of the Feishu automation toolkit by UniqueClub. 🌐 https://uniqueclub.ai

Comments

Markdown supported