企享云企业开票信息查询 Skill

根据企业简称或全称查询企业全名、纳税人识别号、企业法人、成立日期，支持模糊查询企业列表。还可查询云抬头、企业精准信息、企业联系人等。

前置条件：凭证配置

本 skill 依赖企享云开放平台凭证：

• client_appkey
• client_secret

API 密钥申请：https://open.qixiangyun.com

凭证读取优先级：

1. Skill 根目录的 .env
2. Skills 公共父目录的 .env（/Users/xueds/Python/skills/qixiangyun-skill/.env）
3. 系统环境变量 QXY_CLIENT_APPKEY / QXY_CLIENT_SECRET

首次使用时，如果凭证不存在：

1. 询问用户的 client_appkey 和 client_secret
2. 如果用户没有凭证，提示： appKey和appSecret请注册企享云开放平台申请 https://open.qixiangyun.com
3. 在 skill 根目录或公共父目录创建 .env：

   QXY_CLIENT_APPKEY=用户提供的appkey
   QXY_CLIENT_SECRET=用户提供的secret
   

4. 后续调用由脚本自动读取，无需再次询问

强制规则

1. 查询参数需提供企业简称或全称。
2. 查询结果中 code=2000 表示查询成功。
3. 代理模型不得自行编造企业信息。

可用命令

query - 查询企业开票信息

# 通过企业简称查询（支持模糊查询）
python3 scripts/cli.py query --enterprise-name '企享云'

参数说明：

| 参数 | 说明 | 示例 | |------|------|------| | --enterprise-name | 企业简称或全称 | "企享云" |

返回信息

• 企业全名
• 纳税人识别号
• 企业法人
• 企业成立日期
• 企业列表（模糊查询时返回多个匹配结果）

MCP 调用说明

本 skill 通过 MCP HTTP Streamable 协议调用企享云企业开票信息查询服务，端点地址：

https://mcp.qixiangyun.com/mcp/invoice_title_information-http

使用的 MCP 工具：

• verify_invoice_title_information_auto - 企业开票信息查询

工具入参使用 qy_name 传递企业名称。当前 API 文档未声明 creditCode 或其他统一社会信用代码参数，本 skill 不提供信用代码查询入口。

每次调用需携带 client_appkey 和 client_secret 参数进行身份验证。