afrikyol/workyol

workyol は何をしますか？

Workyolはユーザーのコンピュータ上で動作するプログラムです。Meta公式プラットフォーム（WhatsApp Business Platform、Instagram、Messenger）、LinkedIn API、およびYouTube API（利用可能な場合）と連携します。このスキルは、そのMCPツールの使用方法を説明します。

使用するタイミング

以下のことをユーザーが希望する場合にこのスキルを使用します：

• オプトイン済みの連絡先リストにWhatsAppテンプレートキャンペーンを送信する
• 未読の返信（WhatsApp、Instagram、Messenger）を読み、回答する
• キーワード自動返信、またはコメント-to-プライベートメッセージルールを追加する
• 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：連絡先、送信済み/配信済み/既読メッセージ、未読返信、接続済みのPage/Instagram/WhatsApp、保留中の投稿を取得します。
• check_setup：セットアップで完了していることと不足していること（ライセンス、ライブモード、Metaアプリ、WhatsApp、Page + Instagram、ウェブフック）を確認します。ユーザーに次のステップを伝えるために使用します。
• 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。既製の自動化はOFFの状態で追加されます。

受信トレイ

• list_replies：ユーザーが送信したメッセージを、新しいものから順に、ユーザーごとにグループ化して表示します。パラメータ：unread_only、limit。
• send_reply：同じチャンネルで一人のユーザーに返信します。パラメータ：channel（whatsapp、instagram、messenger）、to（list_repliesからの値）、text、confirm。WhatsAppでは、ユーザーの最後のメッセージから24時間以内のみ自由形式のテキストが許可されます。

自動化

• list_automations：キーワード自動返信とコメント-to-DMルールを一覧表示します。
• add_automation：パラメータ：type（auto_reply または comment_to_dm）、keywords、channel、reply（auto_reply）、file_link（オプションの画像、動画、音声、PDFへのhttpsリンク）、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：スケジュール済みおよび公開済みの投稿（ステータスでフィルタリング：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 なしで呼び出すと、各行のステータスを一覧表示します。同じ行が2回スケジュールされることはありません。
• delete_post：スケジュール済みの投稿を削除します（公開済みの投稿はそのまま残ります）。

LinkedIn（ユーザー自身のプロフィール）

• linkedin_status：接続状態、残りのアクセス日数（60日、その後ユーザーがReconnectをクリック）、保留中の投稿。
• linkedin_schedule_posts：1つまたは複数の投稿。各投稿：text（最大3000文字、プレーンテキスト、ハッシュタグ可）、at、オプションの media_path（JPG/PNG画像またはMP4）、オプションの lang。1回の呼び出しで最大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；チャンネルあたり1日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時間以上前の場合、自由形式のテキストは失敗します：テンプレートが必要であることをユーザーに伝えます。

キーワード自動返信またはコメント-to-DMの追加

1. list_automations を呼び出して重複を避けます。
2. ルール（キーワード、チャンネル、返信）を表形式で表示します。
3. 承諾後、add_automation を confirm: true で呼び出します。

1週間分のReelsのスケジュール

1. 動画ファイル、キャプション、時間（タイムゾーン付き）を尋ねます。
2. list_posts を呼び出して、すでに保留中の投稿を確認します。
3. 完全なスケジュールを表示します。承諾後、各投稿に対して schedule_post を confirm: true で呼び出します。または、CSVシート付きのフォルダの場合は import_content_plan を使用します（最初にプレビュー）。

1ヶ月分のLinkedIn投稿のスケジュール

1. linkedin_status：接続されていない場合、または残り日数が少なすぎる場合は、Workyolで接続または再接続するようユーザーに伝えます。
2. 投稿をプレーンテキスト（マークダウンや太字なし）で作成します。すべてを日付とともに表示します。
3. 承諾後、linkedin_schedule_posts を confirm: true で呼び出します。

安全ルール（常に従うこと）

• ユーザーが承諾するまで、何も送信、公開、変更されません。 最初に confirm なしでツールを呼び出し、概要を表示し、その特定のアクションに対して明確な承諾を得た場合のみ confirm: true を渡します。
• オプトインリストのみ。 キャンペーンは、Workyolでオプトインボックスにチェックが入った状態でインポートされた連絡先リストにのみ送信されます。電話番号を追加できるツールはありません。依頼していない人にメッセージを送信しないでください。
• スパムや知らない人への大量メッセージは禁止です。STOPを尊重してください：STOPと返信した人はWorkyolによってスキップされます。
• アクセストークン、アプリシークレット、ライセンスキーは絶対に表示しません。それらを要求しないでください。
• Workyol独自のルールも適用されます：24時間のWhatsAppウィンドウ、オプトアウト、承認済みテンプレート、ライセンス制限、Metaの日次制限。
• Metaでは、ビジネスはInstagramとMessengerで最初にメッセージを送ってきた人にのみ返信できます。これらのチャンネルでのキャンペーンはありません。
• 「禁止されない」などの結果を約束しないでください。Workyolが公式APIを使用していることのみを伝えてください。

プロンプト例

• 「Workyolのセットアップを確認して、何が不足しているか教えて。」
• 「未読の返信はいくつある？要約して、回答案を作成して。」
• 「承認済みテンプレート'order_ready'を使って、'Customers 2026'リストにWhatsAppキャンペーンを準備して。最初にプレビューを見せて。」
• 「自動返信を追加：誰かがCATALOGと書いたら、このテキストで返信して、私のPDFを送って。」
• 「誰かが私の投稿にPRICEとコメントしたら、私たちの料金をプライベートメッセージで送って。」
• 「これらの5本の動画をReelsとしてInstagramとFacebookに、1日1本ずつ18:00にスケジュールして。」
• 「C:\plans\novemberフォルダからコンテンツプランをインポートして、プレビューを見せて。」
• 「歯科ケアについてのLinkedIn投稿を12件、週2件ずつスケジュールして。最初にそれらを見せて。」