mcpField
S
smart-categorize

smart-categorize

github.com/openaccountant数据与数据库103440 次安装29 周前更新
代码仓库

关于 smart-categorize

smart-categorize 是一项交易分类技能,先用已有规则为未分类交易匹配类别,再为未匹配项目提出分类建议。经确认的建议可应用并保存为后续导入使用的规则。

主要功能

  1. 01查找未分类交易
  2. 02按描述匹配现有规则
  3. 03按商户相似度归组
  4. 04提出类别建议供确认
  5. 05保存规则用于后续导入

适用场景

  1. 01为新导入的交易批量分类
  2. 02整理未匹配的商户记录
  3. 03确认并应用新的分类规则

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/openaccountant/skills --skill smart-categorize

安装后在 Claude Code 中输入/smart-categorize确认已加载。

详细介绍

智能分类

概述

根据已知规则匹配商户/描述模式,自动为未分类的交易分类。首先使用现有分类规则,然后根据常见商户名称,为未匹配的交易建议新规则。

使用的 Wilson 工具

  • categorize — 将基于模式的分类规则应用于交易
  • transaction_search — 查找未分类的交易

工作流

  1. 使用 transaction_search 查找所有 category 为 null 或空值的交易。
  2. 运行 categorize,应用现有分类规则(对描述字段进行模式匹配)。
  3. 报告有多少笔交易通过现有规则完成分类。
  4. 对剩余的未分类交易,按商户/描述相似度分组。
  5. 为每个商户分组建议分类(例如,“SPOTIFY” -> 娱乐,“SHELL OIL” -> 交通)。
  6. 请用户确认或调整建议的分类。
  7. 应用已确认的分类,并可选择保存新的分类规则,以供将来导入时使用。

不使用 Wilson 时

你可以在电子表格中手动为交易分类:

在 Excel/Sheets 中设置分类规则
  1. 创建一个名为“Rules”的参考工作表,其中包含两列:Pattern 和 Category。

  2. 添加商户模式:

    PatternCategory
    AMAZONShopping
    WHOLE FOODSGroceries
    SHELLTransportation
    NETFLIXEntertainment
    STARBUCKSDining
  3. 在交易工作表的 Category 列中使用查找公式:

    • Excel:=IFERROR(INDEX(Rules!B:B,MATCH("*"&"AMAZON"&"*",Rules!A:A,0)),"Uncategorized") — 但这只适用于精确匹配。
    • 更好的 Excel 方法:使用辅助列配合 =SUMPRODUCT,或使用 VBA 宏进行部分匹配。
    • Google Sheets:=IFERROR(VLOOKUP("*"&A2&"*",Rules!A:B,2,FALSE),"Uncategorized") 不支持在 VLOOKUP 中使用通配符。
    • 实用的 Google Sheets 方法:
      =IF(REGEXMATCH(A2,"(?i)amazon"),"Shopping",
       IF(REGEXMATCH(A2,"(?i)whole foods|trader joe"),"Groceries",
       IF(REGEXMATCH(A2,"(?i)shell|chevron|exxon"),"Transportation",
       "Uncategorized")))
      
常见分类映射
商户模式建议分类
AMAZON、TARGET、WALMART购物
WHOLE FOODS、TRADER JOE、KROGER、SAFEWAY食品杂货
UBER EATS、DOORDASH、GRUBHUB餐饮
NETFLIX、SPOTIFY、HULU、DISNEY+娱乐
SHELL、CHEVRON、BP、EXXON交通
AT&T、VERIZON、T-MOBILE、COMCAST公用事业
CVS、WALGREENS、PHARMACY医疗保健
VENMO、ZELLE、PAYPAL(个人对个人)转账

重要说明

  • 模式匹配不区分大小写,并会匹配交易描述中的任意部分。
  • 规则按创建顺序应用。如果一笔交易匹配多条规则,则以第一条匹配规则为准。
  • 除非你明确要求,否则分类操作不会覆盖已有分类的交易。
  • Wilson 将规则存储在 categorization_rules 表中,因此规则会跨会话保留,并自动应用于之后导入的交易。

评论

支持 Markdown