whatsapp-mcp-local-ollam

🚀 WhatsApp Python 自动化工具

这是一个基于 Python 的自动化工具，借助 WhatsApp 网页界面实现消息发送功能，能有效提升沟通效率。

🚀 快速开始

此工具允许您通过 WhatsApp 网页界面实现消息自动化发送。使用前，请确保满足先决条件，并完成安装步骤，之后即可按照使用方法操作。

✨ 主要特性

• 可向单个联系人或群组发送消息。
• 安装过程简单，易于上手使用。
• 采用 Python 实现自动化操作。
• 与 WhatsApp Web 完美兼容。

📦 安装指南

先决条件

• Python 3.6 或更高版本。
• Go（版本 1.16 或更高）。
• Chrome/Firefox 浏览器。
• 活跃的 WhatsApp 账户。
• 网络连接。

Windows 特定要求

对于 Windows 用户，需要额外进行如下配置：

1. 安装 Go：
   • 从 官方网址 下载 Go。
   • 运行安装程序。
   • 若未自动添加，需将 Go 添加到系统 PATH 中。
   • 通过在命令提示符中运行 go version 验证安装情况。
2. 启用 CGO：
   • 打开命令提示符并运行：go env -w CGO_ENABLED=1。
3. 安装 C 编译器：
   • 下载并安装 MSYS2。
   • 打开 MSYS2 并运行：pacman -S mingw-w64-x86_64-gcc。
   • 将 C:\msys64\mingw64\bin 添加到系统 PATH 中。

安装步骤

1. 克隆此仓库：

git clone [your-repository-url]
cd whatsapp-python

2. 安装所需的依赖项：

pip install -r requirements.txt

💻 使用示例

基础用法

1. 切换到项目目录：

cd whatsapp-bridge

2. 运行 WhatsApp 代理程序：

go run main.go
# 这将启动 WhatsApp mcp 服务器

3. 第一次运行时，您需要：
   • 使用 WhatsApp 移动应用程序扫描 QR 码。
   • 等待身份验证完成。
   • 保持手机连接到互联网。
4. 要发送消息，请使用以下格式：

python whatsapp_message.py
# 这将运行 ai 并通过我们的 mcp 连接
send message to "接收方名称" "您的消息"

例如：向 chau 发送消息 say hi / # 请记住要手动在 json 中添加联系人才能加载它

高级用法

def send_message():
    # 在此处添加发送消息的逻辑
    pass

if __name__ == "__main__":
    send_message()

📚 详细文档

工作原理

该应用程序的工作流程如下：

1. 自动化一个网络浏览器会话。
2. 连接到 WhatsApp 网页版。
3. 通过 QR 码进行身份验证（仅限首次）。
4. 在您的联系人中查找收件人。
5. 使用 ollam 发送指定的消息。

注意事项

• 保持 WhatsApp 手机应用程序连接到互联网。
• 不要关闭终端中的服务器窗口。
• 确保收件人在您的 WhatsApp 联系人中。
• 会话需要定期重新身份验证，例如每 20 天一次。
• 对于 Windows 用户，请确保 CGO 已启用且 C 编译器已正确配置。

故障排除

如果遇到问题：

1. 确保互联网连接稳定。
2. 验证您的 WhatsApp 账户是否活跃。
3. 检查是否有足够的权限执行操作。

📄 许可证

[在此处添加许可证信息]

⚠️ 重要提示

此工具旨在提高效率，但请负责任地使用。