SuperAPI AI 工具集

tres-export-3rd-party-contacts

通用与其它

查看项目

更新于 10-15 19:56

技能介绍

用途:从用户的 TRES Finance 环境中抓取所有未识别(UNIDENTIFIED)的外部交易对手地址,即 TRES 界面“Unidentified Addresses”标签所用数据,去重并补充活动数据,生成可导入的联系人工作簿。

主要能力:通过 user-tres-finance MCP 服务器调用 GraphQL(execute 工具)。先执行 get_viewer 确认会话与组织名;再用 accountTxsSummary 查询,参数为 identificationState: "UNIDENTIFIED"、excludeInternalAccounts: true、fiatCurrency: "usd"、limit: 500,并按 offset 每 500 分页至 totalCount 取完。结果按小写 accountIdentifier 去重(保留首次出现的大小写,累加进出交易数与法币金额,跳过空地址),按总法币金额降序排序。因接口不返回网络字段,依据地址格式启发式推断网络(如 0x 为 EVM、KT1/tz 开头为 Tezos、T 开头为 Tron、bc1/1/3 为 Bitcoin 等),无法匹配则标为 Unknown。

输出:用 Python 与 openpyxl==3.1.5 生成 XLSX。若未安装则提示运行 python3 -m venv .venv && .venv/bin/pip install openpyxl==3.1.5。文件含两个工作表:Contacts(导入就绪,列为 Contact Name、Contact Address、Contact Tag,名称与标签留空由用户填写);Address details(列为 Contact Address、Network、Inflow Txs、Outflow Txs、Inflow USD、Outflow USD、Total USD)。表头加粗、自动列宽、USD 列用数字格式,Contacts 为首个活动表。保存至 outputs 目录,文件名形如 tres_3rd_party_contacts_<org_name>_<date>.xlsx,并向用户汇报地址数、交易总数和文件链接。

限制与边界:网络推断为尽力启发式,EVM 地址无法区分具体链;无未识别地址时提示可能已全部在联系人列表中;零地址如出现仍保留;未知网络不跳过。具体收费、价格与平台支持情况暂未提供。