硕软·企业基础信息查询

概述

硕软-企业基础信息查询

查询一家企业的工商登记信息，判断它是否真实存在、是否正常经营，并生成一份可在浏览器打开的 HTML 报告。按次付费，每次查询 ¥0.10，通过微信 AI 支付完成。

何时使用：用户想了解或核实一家企业——例如签约、付款、合作、招投标前确认对方是否存续，查法定代表人、注册资本、成立时间、营业期限、经营范围、是否上市等。

调用前：确认查询对象（⚠️ 必须执行）

本技能每次调用都会向用户收费，只能查询用户在对话中明确给出的企业：

• 用户还没有给出要查询的企业（例如刚安装本技能、只是了解功能）：先问用户「要查询哪家企业？请提供企业全称或统一社会信用代码」，在用户回答前不发起请求、不下单。
• 不得自行编造、猜测企业，也不得使用本文档中的示例值（如「深圳示例技术有限公司」「91440300XXXXXXXXXX」）、占位词或测试值。
• 不要为了验证安装、测试功能或演示而调用本技能。
• 用户只给了简称或不完整的名称时，先请用户确认全称。

调用前：告知费用并取得同意（⚠️ 必须执行）

在发起任何请求之前，先用一句话明确告诉用户费用，并等待用户同意：

查询「企业全称」的工商登记信息需付费 ¥0.10/次，通过微信支付，支付成功后才会执行查询并生成报告；查询失败或未查到该企业将自动全额退款。是否继续？

• 话术中的「企业全称」必须替换为用户给出的实际企业名称或信用代码；还不知道查哪家企业时，回到「调用前：确认查询对象」。
• 用户同意后再进入「💳 付费能力」的第一步。
• 用户拒绝或未明确同意：不发起请求、不下单。
• 收到 402 后，实际应付金额以响应中的 amount 为准；若与 ¥0.10 不一致，先把实际金额告诉用户并重新取得同意，再发起支付。

输入

请求体示例：

• {"company_name": "深圳示例技术有限公司"}
• {"credit_code": "91440300XXXXXXXXXX"}

入参不合法时服务会直接返回 400，不会下单、不会扣费。按提示向用户确认企业全称或信用代码后再请求，不要自行改写或替换成其他企业。

<!– PAY_SKILL_SECTION –>

💳 付费能力（Pay Skill）

本 Skill 为 SkillHub Pay Skill，按次付费 ¥0.10/次，调用时由服务端触发微信 Agent Pay。

付费前置检查（Agent 必读）

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（如 mcp__weixinpay__weixinpay_register，工具名带前缀也算；存在任意一个即视为支持）。

只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。

• 支持：继续执行下方四步法。
• 不支持：不要发起下单，告诉用户当前智能体暂不支持微信 AI 支付，并按智能体类型给出解决办法：
  • 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
  • 开放智能体（如 OpenClaw / DeepSeek Harness）：请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/weixinpay-installer。
  • 无法判断类型：请升级智能体或安装微信支付 AI 支付插件后重试。

工作流程（四步法）

第一步：请求资源

首次请求不要携带订单号，请求体为用户确认的企业：

bash scripts/invoke.sh '{"company_name": "企业全称"}'

第二步：处理 402 响应

输出 HTTP_STATUS: 402 表示需要付费。从输出中提取并保存（两者都必须保存）：

• WeixinPay-Required：支付凭据（paymentCode）
• X-Out-Trade-No：订单号

将脚本输出原样保留，不要改写、截断、省略或总结 WeixinPay-Required 的值。

第三步：发起支付

将 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay，向用户申请支付授权。支付卡片弹出后由用户在卡片上完成确认，不要在对话内反复查询支付状态或重复发起支付。

第四步：支付成功后获取资源（⚠️ 必须执行）

用户支付成功后，必须重新请求：使用与第一步完全相同的请求体，并带上第二步保存的订单号与支付凭据：

bash scripts/invoke.sh '{"company_name": "企业全称"}' '<X-Out-Trade-No>' '<WeixinPay-Required>'

• HTTP_STATUS: 200：查询完成。BODY.data 为报告数据；REPORT_HTML 为已在本地生成的 HTML 报告路径。

若同时带有 BODY.refund（如未查到该企业），表示本次不收费、费用已自动退回，务必把 BODY.refund.message 告诉用户。

• HTTP_STATUS: 402：订单尚未支付或支付凭据已过期，按新返回的 WeixinPay-Required 与 X-Out-Trade-No 回到第三步。
• HTTP_STATUS: 202：结果处理中，稍候用同一订单号重试。
• BODY.code 为 QUERY_FAILED：查询失败，费用已自动全额退款（原路退回微信）。把 BODY.message 告诉用户；不要用同一订单号重试。

用户仍想查询时，从「调用前：告知费用并取得同意」重新开始（需重新付款）。

• BODY.code 为 ORDER_REFUNDED：该订单已退款，如需查询请从头开始。
• 其他状态：将 BODY.message 告知用户；已付款且未退款的订单可稍后用同一订单号重试，不要重新下单。

不携带订单号重试，就永远拿不到付费内容。

能力边界

• 免费部分：无。本技能不提供免费查询；入参不合法时服务直接返回 400，不下单、不扣费。
• 付费触发点：每次查询的首次请求返回 HTTP 402 与 WeixinPay-Required（¥0.10/次）；未查到该企业或查询失败时自动全额退款。

部署形态

• 形态：server（HTTP 服务端，硕软 SkillPay：https://skillpay.sohan.cn/api/admin/skillpay/open/shuoruan-enterprise-basic-info/invoke）。
• 微信支付下单、AI 预下单、支付后查单验证与幂等履约均在服务端完成；本包 scripts/invoke.sh 只负责发起首次请求与支付后重试，scripts/render_report.py 在本地生成 HTML 报告。
• 首次请求返回 HTTP 402，响应头带 WeixinPay-Required 与 X-Out-Trade-No，响应体带 WeixinPay-Required、out_trade_no、amount；携带 X-Out-Trade-No 重试且已支付时返回 HTTP 200 与报告数据，同一订单重复请求返回同一结果、不重复扣费。

🔐 安全声明

• 本包不含任何密钥、Token 或商户证书；SkillHub 开发者私钥与微信商户 API 证书只保存在服务端环境变量中，不写入本包、前端或公开仓库。
• 本包只向上述服务端地址发送用户提供的企业名称或统一社会信用代码，不收集其他信息。

<!– PAY_SKILL_SECTION –>

解读与呈现

BODY.data 结构：

• result：已查到 / 未查到；conclusion：一句话结论；status：登记状态（存续、注销、吊销等）
• risk_flags[]：风险提示（非存续状态、吊销、注销、营业期限届满），为空表示未发现登记异常
• sections[]：分组信息，每组有 title 与 items[]（label / value），依次为工商登记、规模与行业、地址、经营范围
• listings[]：上市信息；history_names[]：历史名称
• generated_at：报告生成时间

请这样回复用户：

1. 第一句给结论，例如“深圳示例技术有限公司登记状态为存续，未发现登记异常”；有 risk_flags 时逐条醒目提示。
2. 简要列出关键信息：统一社会信用代码、法定代表人、成立日期、注册资本、营业期限、企业类型、所属行业、注册地址；经营范围概括一两句即可。
3. 告诉用户完整报告已生成，给出 REPORT_HTML 的路径，提示可用浏览器打开查看或打印。能直接打开本地文件的智能体可以帮用户打开。
4. result 为「未查到」时，告诉用户本次费用已自动退回，并请用户核对企业全称或统一社会信用代码。
5. 用通俗中文整理结果，不必逐条罗列原始 JSON 或技术字段；用户询问订单号（如咨询退款）时如实提供。
6. 结尾注明：数据来源于公开登记信息，仅供参考，不构成法律或投资意见。