mcpField
T
tidy

tidy

github.com/davepoonデータ・データベース3.7k98 回インストール2 日前に更新
リポジトリ

tidy について

tidyは、未分類取引を似た説明ごとにまとめ、カテゴリと加盟店名を提案するスキルです。確認を得てから、繰り返しの取引にはルールを作成し、単発取引には直接注釈を付けます。

主な機能

  1. 01期間を指定して未分類取引を取得
  2. 02説明や加盟店ごとに取引を分類
  3. 03グループごとにカテゴリと加盟店名を提案
  4. 04自動分類ルールのプレビューと作成
  5. 05単発取引への直接注釈

活用シーン

  1. 01過去90日間の未分類取引を整理
  2. 02判別しにくい加盟店や決済処理業者を調査
  3. 03繰り返し利用する加盟店の分類ルールを作成

MCP 対応

MCPの`query`ツールで取引を取得し、`admin`ツールでルールのプレビューや作成、取引の分類、加盟店名の設定を行います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --skill tidy

インストール後、Claude Code で/tidyを入力して読み込まれたか確認します。

詳細

未分類の取引を整理する

類似する取引をまとめて分類し、未分類の取引を一括でカテゴリ分けします。

ワークフロー

  1. 未分類の取引を取得します。 query MCP ツールを呼び出します。

    { "detail": true, "is_uncategorized": true, "period": "last_90d", "limit": 200, "sort": "-amount" }

    $ARGUMENTS に期間（例：「今月」「過去30日間」）が含まれている場合は、last_90d の代わりにその期間を使用します。

  2. 不明な取引を調査します。 説明だけでは特定できない取引については、次の方法を試します。

    • まずウェブ検索を行います（利用可能な場合）：加盟店名、説明に含まれる電話番号やドメイン、または説明文そのものを検索します。これにより、判別しにくい決済処理業者名の背後にある事業者がわかることがよくあります。
    • ユーザーのメールを検索します（利用可能な場合）：相手先や加盟店の名前を検索し、注文確認メールや領収書を探します。一致するものがなければ、正確な金額（例：「$47.23」）で検索し、領収書を探します。

  3. パターンごとにまとめます。 正規化した説明または相手先名で結果をグループ化します。各グループについて、件数と合計金額を記録します。

  4. カテゴリ分けを提案します。 各グループについて、次を提案します。

    • カテゴリ（ユーザーがすでに使用しているカテゴリから選択します）
    • 相手先（整えた加盟店名または取引相手の名称）

  5. ユーザーに提示します。 次の項目を含む表またはリストでグループを示します。

    • パターン／加盟店名
    • 取引件数
    • 合計金額
    • 推奨カテゴリ
    • ルールの作成を推奨するかどうか

    各グループについて、承認、変更、またはスキップするかをユーザーに尋ねます。

  6. 個別の注釈よりルールを優先します。 グループ内の取引が複数ある場合や、加盟店が今後も利用される可能性が高い場合（サブスクリプション、よく利用する店舗、公共料金など）は、個々の取引に注釈を付けるのではなく、ルールを作成します。ルールにより、今後の取引も自動的に分類されます。

    • まずプレビューします：admin { "entity": "rule", "action": "preview", ... }
    • プレビュー（該当する既存の取引件数）を提示します
    • ユーザーが確認したら作成します：admin { "entity": "rule", "action": "create", ... }

  7. 残りの取引に注釈を付けます。 ルールを適用する意味がない、真に一度限りの取引には、直接適用します。

    { "action": "categorize", "filter": { "search": "<pattern>" }, "category_name": "<approved_category>" }

    承認された相手先がある場合は、それも設定します。

    { "action": "set_party", "filter": { "search": "<pattern>" }, "party_name": "<approved_party>" }

  8. 概要を報告します。 カテゴリ分けした取引数、作成したルール数、未分類のまま残っている取引数を報告します。

トーン

事実に徹します。判断を交えずに、調査結果や提案を提示してください。支出習慣についてコメントせず、わかりやすく簡潔な所見と、実行可能な選択肢だけを示します。

コメント

Markdown 対応