一个简单易用的 Python 消息推送库，目前支持钉钉机器人消息发送。
FunPush 是一个面向即时通讯平台的消息推送库，目前支持钉钉机器人消息推送。微信企业号机器人支持正在规划中，未来将扩展更多平台。
关键词： 消息推送 钉钉机器人 Python 即时通讯 API Webhook 自动化 通知 机器人 消息发送
- 🤖 钉钉机器人支持：完整支持钉钉机器人的所有消息类型
- 🔒 类型安全：完整的类型提示支持，提供更好的开发体验
- 🚀 消息去重：内置消息去重机制，防止重复发送
- ⚡ 速率限制：可配置的发送延迟，避免触发平台限制
- 📝 丰富的消息类型：支持文本、链接、Markdown、ActionCard、FeedCard等多种消息格式
- 🛡️ 错误处理：完善的异常处理和日志记录
- 📚 详细文档：完整的中文文档和示例
使用 pip 安装：
pip install funpush- 在钉钉群中添加自定义机器人
- 获取 Webhook URL 和密钥（如果启用了加签验证）
- 使用以下代码发送消息：
from funpush import DingTalkClient
# 初始化客户端
client = DingTalkClient()
# 配置凭据（不要把真实凭据提交到代码仓库）
# export DINGTALK_ACCESS_TOKEN="your_access_token_here"
# export DINGTALK_SECRET="your_secret_here"
client.login()
# 发送文本消息
client.send_text(content="Hello, World! 这是一条测试消息。", at_all=False)# 发送普通文本消息
client.send_text(content="这是一条普通的文本消息")
# 发送带@功能的文本消息
client.send_text(
content="重要通知：请相关人员注意！",
mobiles=["13800138000"], # @指定手机号
user_ids=["user123"], # @指定用户ID
at_all=False, # 是否@所有人
)client.send_link(
title="重要公告",
text="点击查看详细内容",
message_url="https://example.com/announcement",
pic_url="https://example.com/image.jpg",
)markdown_text = """
# 项目进度报告
## 本周完成
- ✅ 功能A开发完成
- ✅ 单元测试通过
- ✅ 代码审查完成
## 下周计划
- 📋 功能B开发
- 🧪 集成测试
- 🚀 准备发布
**负责人：** @张三
"""
client.send_markdown(title="项目进度报告", text=markdown_text, mobiles=["13800138000"])client.send_action_card(
title="系统升级通知",
text="系统将于今晚22:00-24:00进行升级维护，请提前做好准备。",
single_title="查看详情",
single_url="https://example.com/upgrade-notice",
)buttons = [
{"title": "同意", "actionURL": "https://example.com/approve"},
{"title": "拒绝", "actionURL": "https://example.com/reject"},
{"title": "查看详情", "actionURL": "https://example.com/details"},
]
client.send_action_cards(title="请假申请审批", text="张三申请请假3天，请审批。", buttons=buttons)# 方式一：使用字典列表
links = [
{
"title": "新闻1：技术突破",
"messageURL": "https://example.com/news1",
"picURL": "https://example.com/pic1.jpg",
},
{
"title": "新闻2：市场动态",
"messageURL": "https://example.com/news2",
"picURL": "https://example.com/pic2.jpg",
},
]
client.send_feed_card(links=links)
# 方式二：使用简化方法
titles = ["新闻1：技术突破", "新闻2：市场动态"]
urls = ["https://example.com/news1", "https://example.com/news2"]
pics = ["https://example.com/pic1.jpg", "https://example.com/pic2.jpg"]
client.send_feed_card_simple(titles=titles, urls=urls, pics=pics)# 自定义配置
client = DingTalkClient(
max_cache_size=200, # 消息去重缓存大小
send_delay=5.0, # 发送延迟（秒）
)from requests import RequestException
from farlog import getLogger
logger = getLogger("funpush.example")
try:
success = client.send_text(content="测试消息")
if success:
print("消息发送成功")
else:
print("消息发送失败")
except RequestException:
logger.error("发送过程中发生网络错误")funpush/
├── src/
│ └── funpush/
│ ├── __init__.py
│ ├── base/ # 基础类和接口
│ ├── dingtalk/ # 钉钉相关实现
│ │ ├── client.py # 钉钉客户端
│ │ ├── message.py # 消息类型定义
│ │ └── util.py # 工具函数
│ └── wechat/ # 微信相关（开发中）
├── pyproject.toml
└── README.md
- Fork 本项目
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
- 微信企业号机器人支持
- 飞书机器人支持
- 邮件推送支持
- 短信推送支持
- 消息模板功能
- 异步发送支持
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
- 牛哥 - 项目维护者 - niuliangtao@qq.com
- farfarfun - 项目维护者 - farfarfun@qq.com
感谢所有为这个项目做出贡献的开发者！
如果这个项目对你有帮助，请给我们一个 ⭐️！
farfarfun 是一个专注于实用工具库的开源组织， 涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。
本项目基于 MIT 协议开源。