KLS

Showing 25 of 139 from the live probe.

• Friend Search

  友だちを条件検索して一覧取得 Args: keyword: 名前の部分一致検索（LINE表示名・登録名(姓/名)・ニックネーム横断） tag_ids: タグIDリスト（AND条件、全タグを保持する友だちのみ） tag_exclude_ids: 除外タグIDリスト（これらのタグを持たない友だちのみ） registered_after: 登録日以降（ISO日付 例: "2026-01-01"） registered_before: 登録日以前（ISO日付 例: "2026-12-31"） route_id: 登録経路ID has_purchased: True=購入済みのみ、False=未購入のみ、None=全員 unfollow_after: ブロック日時以降（ISO日付）— admin filter_unfollow_date 相当 unfollow_before: ブロック日時以前（ISO日付） is_blocked: True=ブロック中のみ / False=未ブロックのみ / None=全員

• Friend Summary

  friend_summary: 友だちセグメントの件数を集計（friend_search の集計版・クロス集計） friend_search と同じフィルタで「行リスト」ではなく「件数」を group_by 次元別に返す。 登録経路 × タグ等のクロス集計が 1 コールで取得でき、friend_get の連打を不要にする。 Args: (フィルタは friend_search と同じ。registered_after/before で友達登録日の範囲、 applied_fform_ids/applied_sform_ids/applied_consultation_form_ids で申込者を絞れる) group_by: 集計の次元（0〜2個、許可値 'route' / 'tag'）。 []→総数のみ / ['route']→経路別 / ['tag']→タグ別 / ['route','tag']→経路×タグ Returns: total: フィルタ後の distinct 友だち総数 group_by: 適用された次元

• Friend Get

  friend_get: 友だち詳細取得（購入履歴・サブスクリプション含む） Args: friend_id: 友だちID Returns: friend: 友だち基本情報（PII マスク済み） purchases: 購入履歴リスト（order_id, item_name, amount, status, created_at） subscriptions: サブスクリプションリスト（subscr_id, item_name, amount, interval, status, created_at）

• Friend Update

  友だち情報更新 Args: friend_id: 友だちID memo: メモ（上書き。None は変更なし） add_tag_ids: 追加するタグIDリスト remove_tag_ids: 削除するタグIDリスト richmenu_id: リッチメニューID（DB のみ更新、LINE API 連携は Step 6） Returns: success: bool friend: 更新後の友だち基本情報 purchases: 購入履歴 subscriptions: サブスクリプション

• Tag List

  タグ一覧を友だち数付きで取得 Args: keyword: タグ名の部分一致フィルタ（省略可） Returns: tags: タグリスト（id, name, friend_count）

• Tag Get

  タグ詳細を友だち数・アクション情報付きで取得 Args: tag_id: タグID Returns: tag: タグ詳細（id, name, friend_count） action: アクション情報（tag_action, tag, senario_action, senario）または None

• Tag Create

  タグを新規作成 Args: name: タグ名 Returns: tag: 作成されたタグ（id, name）

• Tag Delete

  タグを削除（users_tags の関連レコードも削除） Args: tag_id: 削除するタグID Returns: success: bool

• Tag Update

  タグ名およびウェビナー視聴タグトリガーを変更 Args: tag_id: 変更するタグID name: 新しいタグ名（省略可、既存値維持） webinar_id: ウェビナー紐付け - 省略: 変更しない - 0: ウェビナー紐付けを解除（webinar_minute も 0 にリセット） - 正数: 指定ウェビナー ID に紐付け webinar_minute: ウェビナー視聴タグ付与タイミング（分単位、-1=視聴開始時点） - 省略: 変更しない - -1: 視聴開始時点でタグ付与 - 正数 (1〜): 視聴開始から N 分後にタグ付与 Returns: tag: 更新後のタグ（id, name, webinar_id, webinar_minute） Notes: - 同じアカウント内で (webinar_id, webinar_minute) の組は一意 - ウェビナー視聴タグはフロント視聴ログ連携時にタグ自動付与されます

• Tag Set Action

  タグ追加時に発火するステップ/リマインドシナリオアクションを設定 タグ付与の瞬間にステップシナリオへ move/remove/end を自動実行させる。 tag_update で webinar_id/webinar_minute を設定したタグと組み合わせると 「ウェビナー N 分視聴 → ステップシナリオ Y へ自動送客」が実現できる。 Args: tag_id: 対象タグID（既存タグ、author_id 必須一致） senario_id: ステップ/リマインド senarios.id（author_id 必須一致） senario_action: アクション種別 - "move": ステップ Y に参加/移動（最も一般的） - "remove": ステップ Y から離脱（キャンペーン離脱判定など） - "end": ステップ Y を終端まで強制進行 clear: True で紐付け解除（tags.action_id=NULL + actions 行削除） senario_id

• Friend Message List

  友だちとの送受信メッセージ一覧を取得（時系列降順） Args: friend_id: 友だちID limit: 取得件数（最大50、デフォルト30） Returns: messages: メッセージリスト（id, direction, type, content, image_url, sent_by, created_at） direction: 'out'=送信 / 'in'=受信 sent_by: 'ai'=送信 / 'friend'=受信

• Friend Message Create

  友だちに LINE メッセージを送信する Args: friend_id: 友だちID type: メッセージタイプ（'text' または 'image'） text_content: テキストメッセージ本文（type='text' の場合必須） image_url: 画像URL（type='image' の場合必須） Returns: success: bool message_id: 送信ログのID

• Product List

  商品一覧取得 Args: keyword: 商品名の部分一致検索 charge_type: 課金タイプ ("once"/"subscr"/"auth"/"optin") Returns: products: list[{id, code, name, amount, charge_type, payment_system, active, payment_url}]

• Product Get

  product_get: 商品詳細取得（注文数・収益・アクティブサブスク数含む） Args: product_id: 商品ID Returns: product: 商品基本情報 order_count: 注文総数 active_subscr_count: アクティブなサブスク数 revenue_total: 累計収益（refund 除外、決済成功分のみ）

• Product Create

  商品を新規作成 Args: name: 商品名 amount: 金額（円） charge_type: 課金タイプ ("once"/"subscr"/"auth"/"optin") payment_system: 決済システム ("stripe"/"univapay"/None) interval: サブスク周期 ("monthly" 等、charge_type="subscr" 時に使用) completion_tag_id: 決済完了時に付与するタグID Returns: product: 作成された商品情報 order_count: 0 active_subscr_count: 0 revenue_total: 0

• Product Update

  商品情報を更新 Args: product_id: 商品ID name: 商品名（None は変更なし） amount: 金額（None は変更なし） active: 有効フラグ（None は変更なし） completion_tag_id: 決済完了タグID（None は変更なし、0 で解除） Returns: product: 更新後の商品情報 order_count: 注文総数 active_subscr_count: アクティブなサブスク数 revenue_total: 累計収益

• Product Delete

  商品を削除 Args: product_id: 商品ID Returns: success: bool

• Product Set Completion Action

  商品のイベントアクション (5 slot) を設定 admin「商品編集」画面のタイムライン各 slot（LP 表示/ボタン押下/購入/ キャンセル/無料トライアル購入）に対して、タグ付与・ステップ操作・返信 メッセージ・テンプレメッセージ送信を任意に組み合わせて設定する。 slot 意味: 1: LP 表示時 2: 申込ボタン押下時 3: 購入時（決済完了） 4: キャンセル時（subscription_cancel / order_refund が自動発火） 5: 購入時（無料トライアル） Args: product_id: 商品 ID (items.id) slot: 1..5 clear: True で該当 slot を完全解除（他パラメータ無視） tag_add_ids: 付与するタグ ID リスト（最大 30） senario_id: 移動先ステップ ID（senario_action="move" 時必須） senario_action: "move" / "remove" / "end"

• Product Set Page

  商品 LP / 決済完了 / 特商法 / プライバシーポリシー ページを設定 admin「商品編集」画面のページ系セクション (かんたんページ HTML / 外部 URL リダイレクト / 特商法テンプレ / プライバシーポリシー本文) を MCP から編集。 page 別 mode 意味: page="lp": "html" → lp_flag=0 (かんたんページのみ、html 必須) "url" → lp_flag=1 (外部 URL、url 必須) "both" → lp_flag=2 (両方、url+html 必須) page="thanks": "html" → thanks_flag=0 "url" → thanks_flag=1 (外部 URL) "webinar" → thanks_flag=webinar (+ target_id=webinar_id) "item" → thanks_flag=item (+ target_id=item_id) "form"

• Order List

  注文一覧取得（admin `Orders.php` の read-only 集計） Args: friend_id: 友だちID（users.id）で絞り込み product_id: 商品ID（items.id）で絞り込み status: "paid" / "refunded" / None=全員 livemode: "live" / "test" payment_system: "stripe" / "univapay" date_after: 登録日時以降（ISO 日付 例: 2026-01-01） date_before: 登録日時以前（ISO 日付 例: 2026-12-31） limit: 取得件数（最大100、デフォルト20） offset: ページングオフセット Returns: total: 件数 total_amount: 合計金額（refund 控除済み） orders: list[{id, friend_id, friend_name, product_id, pr

• Order Refund

  注文を返金（admin `Orders::cancel` 相当） Stripe / Univapay に対し実際の返金 API を発行し、orders.refund_date をセット。 単発商品 (subscr_id なし / freetrial) は商品キャンセルイベントアクション (items.action_id4 / msg_text4) も発火。 ⚠️ **不可逆な金銭操作**。`dry_run=True` (デフォルト) で所有権・charge_id・未返金の 事前検証のみ実行し、安全を確認してから `dry_run=False` で本実行すること。 Args: order_id: orders.id dry_run: True (デフォルト) → 検証のみ (Stripe/Univapay 未呼び出し) False → 実際の返金 API を発行 Returns: success: 返金成功時 True (dry_run は False だが validation pass なら True) status:

• Subscription List

  サブスクリプション一覧取得（admin `Subscrs.php` の read-only 集計） Args: friend_id: 友だちID product_id: 商品ID status: "active" / "cancelled" / "inactive" / None=全員 livemode: "live" / "test" payment_system: "stripe" / "univapay" interval: "yearly"/"6monthly"/"3monthly"/"monthly"/"weekly"/"daily"/"none" registered_after: 加入日以降（ISO 日付） registered_before: 加入日以前（ISO 日付） limit: 取得件数（最大100、デフォルト20） offset: ページングオフセット Returns: total: 件数 mrr_jpy: active sub の月次換算金額合計（MRR 相当）

• Subscription Cancel

  サブスクリプションを手動キャンセルする (admin Subscrs::cancel 相当) subscrs.active を '0' に更新し、決済キャンセル slot (action_id4 / msg_text4) を発火する。 admin UI の「キャンセル」ボタンと同じ挙動。 ⚠️ 外部決済プロバイダ (Stripe / Univapay) の subscription は解除しない。 プロバイダ側の自動課金を止めるには別途コンソール操作が必要。 Args: subscription_id: subscrs.id (friend_id ではなく subscrs 行 ID) Returns: {"success": bool, "subscription_id": int, "active": 0, "event_action": "executed"|"failed"|"skipped"|"skipped (already inactive)"}

• Payment Settings Get

  決済鍵 (Stripe/Univapay) の設定状況を取得 admin UI `/admin/stripe/` `/admin/univapay/` に相当する読み取り。 secret は末尾 4 文字 (tail4) のみ返す。public key は raw。 Returns: stripe: {test_pk, test_sk_tail4, live_pk, live_sk_tail4, test_configured, live_configured, oauth_connected} univapay: {test_token_tail4, test_secret_tail4, live_token_tail4, live_secret_tail4, test_configured, live_configured} default_payment_system: 'stripe' | 'univapay' | None

• Payment Stripe Update

  Stripe 鍵 4 つを atomic 更新 (test + live) admin UI `/admin/stripe/` と同じ挙動。4 keys 全必須、更新後は stripe_user_id (OAuth 接続) が NULL クリアされる。 Args: test_pk: pk_test_... test_sk: sk_test_... live_pk: pk_live_... live_sk: sk_live_... Returns: {success, test_pk, live_pk, test_sk_tail4, live_sk_tail4, oauth_cleared}