下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/smarttax--huisuiyun-smart-header.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @smarttax/huisuiyun-smart-header。使用慧穗云 CDK 智能抬头 API，根据企业名称查询规范发票抬头、纳税人识别号、地址电话、开户银行和银行账号。用于用户提到智能抬头、发票抬头查询、企业税号查询、开票资料补全，或需要核对购销方开票信息时。
阅读全文 （展开查看完整说明）
概述
慧穗云智能抬头
调用慧穗云同步接口 GET /api/v2/agent/cdk/addressee/query。使用随 skill 提供的脚本，不要自行拼接鉴权请求。先将本 SKILL.md 所在目录解析为 <skill-dir>，从任何工作目录都通过该绝对路径执行脚本。
配置
要求 Python 3、requests，以及以下环境变量：
HSY_AK=慧穗云或 ISV 的 AK
HSY_SK=对应的 SK
HSY_TYPE=2
HSY_API_URL=https://huisuiyun.comHSY_TYPE 取 2 表示慧穗云 AK/SK。ISV AK/SK 必须改为以下配置：
HSY_TYPE=1
HSY_TAX_NO=被操作公司的税号也可用 --operator-tax-no 代替 HSY_TAX_NO。这里填写当前 ISV 代表其操作并扣减流量的公司税号，不是要查询抬头的目标企业税号。不得要求用户在对话中粘贴 SK；引导其在本机配置环境变量。秘钥管理地址：https://huisuiyun.com/account/conf/secretkey。
查询
python "<skill-dir>/scripts/smart_header.py" query "慧穗数字科技"可选指定 ISV 操作税号和业务流水号：
python "<skill-dir>/scripts/smart_header.py" query "慧穗数字科技" --operator-tax-no 913... --serial-no order-1001公司名称少于 4 个字时，接口只查询系统内部数据。需要详细信息时，优先使用不少于 4 个字的公司名称；用户只提供简称时先说明这一限制，不要自行猜测全称。
解读结果
仅当顶层 code 为字符串 "200" 时按成功处理。存在多条候选时，展示公司全称和税号供用户确认，再按需提供 companyAddress、companyTel、companyBankName、companyBankNo。address 和 bankName 是拼接字段，优先使用拆分后的字段。
成功响应中的空 data 表示未查询到抬头。非 200、HTTP 错误或非 JSON 响应属于调用失败，必须保留并报告 message 和 serialNo，不得解释为“企业不存在”。历史上该链路出现过上游凭证失效和内部 MQ 异常，错误码及流水号对排查很重要。
依据
接口契约来自当前慧穗云 CDK 文档 辅助功能接口/invoice-smart-header.md。Token 有效期为 30 天；脚本使用 MD5(AK + SK) 获取访问令牌，并支持 X-Tax-Token 与 X-Serial-Token。
如需了解更多欢迎扫码联系
