afrikyol/workyol

workyol 是做什么的？

Workyol 是一款在用户本地计算机上运行的程序。它与 Meta 官方平台（WhatsApp Business Platform、Instagram、Messenger）、LinkedIn API 以及（在开放的地方）YouTube API 配合使用。本技能将指导你如何使用其 MCP 工具。

何时使用

当用户想要执行以下操作时，请使用此技能：

• 向已选择加入的联系列表发送 WhatsApp 模板活动；
• 读取未读回复（WhatsApp、Instagram、Messenger）并回复；
• 添加关键词自动回复或评论转私信规则；
• 安排 Reels、照片或轮播图（Instagram 和 Facebook）、LinkedIn 帖子或 YouTube 视频；
• 检查其 Workyol 设置或号码。

请勿将其用于未同意被联系的用户。

要求

1. Workyol 已安装并在计算机上运行（在 localhost:4747 打开）。
2. Workyol 的 MCP 服务器已连接到此助手（请参阅 README：在 Workyol 中，前往 Connections，AI assistants，点击应用旁边的 Connect）。

每次会话第一步： 调用 check_setup（查看哪些已完成/缺少）和 get_overview（联系人、消息、未读回复、等待中的帖子）。如果这些工具不存在或回复“Workyol is not running”，请停止并告知用户启动 Workyol 并连接 MCP 服务器。不要猜测。

大多数工具接受可选的 account 参数（名称、Facebook 页面或 @instagram）；未提供时使用默认账户。如果有多个品牌或客户，请先使用 list_accounts。

工具

概览与设置

• list_accounts：账户（品牌/客户）及其连接的内容。
• get_overview：联系人、已发送/已送达/已读消息、未读回复、已连接的页面/Instagram/WhatsApp、等待中的帖子。
• check_setup：设置中已完成和缺失的内容（许可证、实时模式、Meta 应用、WhatsApp、页面 + Instagram、Webhooks）。用于告知用户下一步。
• quick_connect：一步连接客户的 Facebook 页面（及其 Instagram）作为 Workyol 账户，使用用户在 Graph API Explorer 中复制的令牌。参数：token、name、business_type（general、dental、realestate、wholesale、restaurant、salon、school、none）、page_id、language（en、fr、tr、ar、es）、confirm。将添加预制的自动化规则，但处于关闭状态。

收件箱

• list_replies：用户发送的消息，按最新排列，按人分组。参数：unread_only、limit。
• send_reply：在相同渠道上回复一人。参数：channel（whatsapp、instagram、messenger）、to（来自 list_replies 的值）、text、confirm。WhatsApp 仅在用户最后一条消息的 24 小时内允许自由文本。

自动化

• list_automations：关键词自动回复和评论转私信规则。
• add_automation：参数 type（auto_reply 或 comment_to_dm）、keywords、channel、reply（auto_reply）、file_link（可选的 https 图片、视频、音频或 PDF 链接）、private_message 和 public_reply（comment_to_dm）、name、confirm。文本中的 {name} 会被替换为用户的名字。

WhatsApp 活动

• list_contact_lists：已同意接收消息的联系人列表。
• list_templates：经 Meta 批准的 WhatsApp 模板（活动只能使用这些），包含变量。
• list_campaigns：活动，包含已发送/已送达/已读/失败。
• create_campaign：向已选择加入的列表发送或安排已批准的模板。参数：list_id、template_name、template_language、name、mapping、scheduled_at、confirm。不含 confirm 则返回预览（多少人接收、多少人被跳过及其原因）。

Instagram 和 Facebook 帖子

• list_posts：已安排和已发布的帖子（过滤 status：waiting、published、failed、all）。
• schedule_post：Reel（video_path：竖屏 MP4，9:16，最大 100 MB，可选 cover_path）或图片（image_paths：1 张为照片，2 到 10 张为轮播图；Instagram 仅接受 JPG）。还有 caption（最多 2200 字符）、at（含时区的 ISO 8601）、platforms（instagram、facebook）、from_workyol_com、confirm。
• import_content_plan：从包含 CSV 表格（列：日期、时间、标题、文件、可选渠道）和媒体文件的文件夹导入整个计划。不含 confirm 则列出每一行及其状态。一行永远不会被安排两次。
• delete_post：删除已安排的帖子（已发布的帖子将保留在线）。

LinkedIn（用户自己的个人资料）

• linkedin_status：是否已连接、剩余访问天数（60 天，之后用户需点击重新连接）、等待中的帖子。
• linkedin_schedule_posts：一个或多个帖子。每个：text（最多 3000 字符，纯文本，允许标签）、at、可选 media_path（JPG/PNG 图片或 MP4）、可选 lang。每次调用最多 60 个帖子。
• linkedin_list_posts：已安排、已发布和失败的帖子。
• linkedin_delete_post：删除已安排的帖子（已发布的将保留在 LinkedIn 上）。

YouTube（仅当该许可证的 YouTube 功能开放时才可用；撰写本文时尚未向客户开放，此时工具会回复“YouTube is not open yet”）

• youtube_status、youtube_playlists、youtube_list、youtube_schedule（MP4/MOV，最大 2 GB；标题、描述、标签、publish_at、privacy、thumbnail_path、playlist、first_comment；每个频道每天 3 次上传，额外视频等待第二天）、youtube_delete。

工作流程

准备 WhatsApp 活动

1. check_setup，然后 list_contact_lists 和 list_templates。
2. 与用户一起选择列表和已批准的模板。仅显示已选择加入的列表。
3. 调用 create_campaign不带 confirm。显示预览：谁接收、谁被跳过及原因。
4. 仅当用户同意后，再次调用并带上 confirm: true。如果用户希望稍后发送，可提供 scheduled_at。
5. 稍后：使用 list_campaigns 报告已发送/已送达/已读/失败。

回复未读消息

1. 使用 unread_only: true 调用 list_replies。
2. 按人和渠道汇总。为每条消息草拟回复。
3. 显示每个草稿。仅当用户批准后，使用 send_reply 和 confirm: true 发送每条。
4. 在 WhatsApp 上，如果最后一条消息超过 24 小时，自由文本将失败：告知用户需要模板。

添加关键词自动回复或评论转私信

1. 调用 list_automations 以避免重复。
2. 以表格形式显示规则（关键词、渠道、回复）。
3. 获得同意后，使用 confirm: true 调用 add_automation。

安排一周的 Reels

1. 请用户提供视频文件、标题和时间（含时区）。
2. 使用 list_posts 查看已经等待的内容。
3. 显示完整计划。获得同意后，为每个帖子调用 schedule_post 并带上 confirm: true。或者，对于带 CSV 表格的文件夹，使用 import_content_plan（先预览）。

安排一个月的 LinkedIn 帖子

1. linkedin_status：如果未连接或剩余天数太少，告知用户在 Workyol 中连接或重新连接。
2. 用纯文本撰写帖子（无 Markdown 或粗体）。显示所有帖子及其日期。
3. 获得同意后，使用 confirm: true 调用 linkedin_schedule_posts。

安全规则（始终遵守）

• 直到用户明确同意之前，什么都不会发送、发布或更改。 先不带 confirm 调用工具，显示摘要，仅在用户明确同意该特定操作后，再传递 confirm: true。
• 仅限已选择加入的列表。 活动仅发送给在 Workyol 中导入并勾选了选择加入框的联系人列表。没有工具可以添加电话号码。绝不向未询问的用户发送消息。
• 不得发送垃圾信息，不得向陌生人发送批量消息。尊重 STOP：回复 STOP 的用户会被 Workyol 跳过。
• 你永远不会看到访问令牌、应用密钥或许可证密钥。不要询问它们。
• Workyol 自身的规则仍然适用：24 小时 WhatsApp 窗口、退订、已批准的模板、许可证限制以及 Meta 的每日限制。
• Meta 仅允许企业回复在 Instagram 和 Messenger 上首先发送消息的用户。这些渠道上没有活动。
• 不要承诺结果，例如“不会被封”。只能说 Workyol 使用官方 API。

示例提示

• "检查我的 Workyol 设置，告诉我缺少什么。"
• "我有多少未读回复？汇总它们并草拟回复。"
• "为我的 'Customers 2026' 列表准备一个使用已批准模板 'order_ready' 的 WhatsApp 活动。先显示预览。"
• "添加自动回复：当有人写 CATALOG 时，用这段文本回复并发送我的 PDF。"
• "当有人在我的帖子下评论 PRICE 时，给他们发送一条包含我们价格的私信。"
• "将这 5 个视频安排为 Instagram 和 Facebook 上的 Reels，每天一个，时间 18:00。"
• "从文件夹 C:\plans\november 导入内容计划并显示预览。"
• "安排 12 篇关于牙科护理的 LinkedIn 帖子，每周两篇，先显示给我看。"