SuperAPI AI 工具集

tres-import-contacts

通用与其它

查看项目

更新于 10-15 19:56

技能介绍

用途:读取用户提供的 CSV 或 XLSX 文件中的地址到名称映射,作为联系人导入 TRES Finance 地址簿。这是联系人工作流的后半部分:用户先用导出技能导出未识别地址,填好名称与标签后,再用本技能把标注推回 TRES。

主要能力:所有 GraphQL 调用通过 user-tres-finance MCP 服务器(execute 工具)执行。期望文件包含「Contact Name」(必填,空则跳过)、「Contact Address」(必填)、「Contact Tag」(可选,逗号分隔多个)三列,表头大小写不敏感且顺序不限,多余列会被忽略。支持 XLSX(用 openpyxl==3.1.5,缺失时提示 python3 -m venv .venv && .venv/bin/pip install openpyxl==3.1.5;多工作表时找名为 Contacts 的表,否则用第一张)和 CSV(内置 csv 模块,以 encoding='utf-8-sig' 打开处理 BOM,先试逗号,找不到表头再试分号)。

用法流程:先用 get_viewer 确认会话;再解析文件并按地址去重(大小写不敏感,保留最后一条);跳过无名称或无地址的行,修剪空白并拆分标签;向用户报告总数、跳过数、待导入数、重复项,展示前 10 行预览并请确认。50 行以上导入会先经 AddressBook 查询(customAccountNameLabel,每 500 条分页)比对现有联系人,区分新增与更新,并提醒 setCustomAccountNameLabelTags 是替换而非追加,旧标签会被覆盖。导入时每行两次调用:setCustomAccountName 设置名称,有标签时再调用 setCustomAccountNameLabelTags;无批量端点,少于 20 条可并行,较大导入按每批 10 个并行处理,每 25 条显示进度。单条失败记录后继续,最后汇总成功、设置标签及失败情况,并建议重跑同一文件重试(名称写入幂等)。

限制与边界:地址大小写不规范化,按文件原样传入;名称支持 Unicode;标签会整体替换,技能不会自动合并现有标签;即使地址未在交易中出现也会创建地址簿条目。无表头、缺少地址列、空文件、名称全空或超过 500 行时会提示用户。官方资料未提供收费、价格或平台等更多信息。