工具文档
20 个 MCP 工具的完整入参与语义。所有工具经 POST /market/openapi/v1/mcp 的 JSON-RPC tools/call 调用；业务错误通过调用结果的 isError 与文本返回，HTTP 恒为 200。
attest_work个人
作品存证。默认沙箱（mock_attestation，不连真实链不耗配额）；confirm_mainnet=true 且提供实名双字段时走真实中数链（不可撤销）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 作品名称 |
| content | string | 是 | 作品文本内容（以其 SHA256/字节数作为存证指纹） |
| confirm_mainnet | boolean | 否 | true=上真实中数链 |
| real_name | string | 否 | 真链必填：著作权人实名姓名 |
| id_card | string | 否 | 真链必填：证件号 |
list_my_attestations个人
本人存证台账（含状态与证书链接）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 20，最大 100 |
| offset | integer | 否 | 默认 0 |
list_my_orders个人
本人订单列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 50，最大 200 |
| offset | integer | 否 | 默认 0 |
list_my_registrations个人
本人版权登记申请列表（成都版权通道）：平台状态/上游审核状态/受理号/驳回意见。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 20，最大 100 |
| offset | integer | 否 | 默认 0 |
get_registration个人
单笔版权登记申请详情（须本人）：作品信息/审核意见/受理号/证书下载链接。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 登记申请 ID（list_my_registrations 返回） |
query_products个人
平台公开在售商品行情。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| category | string | 否 | 品类：copyright_license / ip_license / cultural_creative |
| limit | integer | 否 | 默认 50，最大 500 |
| offset | integer | 否 | 默认 0 |
register_merchant合作方merchant:register
商户引入：按手机号幂等注册成交平台商户。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phone | string | 是 | 商户手机号（幂等键） |
| name | string | 是 | 商户名称 |
| institution_id | integer | 否 | 挂靠合作机构 ID |
| company_name | string | 否 | 公司名称 |
| license_no | string | 否 | 营业执照号 |
query_merchant合作方merchant:register
按手机号查询本合作方引入的商户状态。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phone | string | 是 | 商户手机号 |
list_merchant_products合作方product:import
商户名下商品列表（仅限本合作方引入的商户）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phone | string | 是 | 商户手机号 |
import_product合作方product:import
商品导入（external_id 幂等；图片用公网 URL，最多 9 张）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| merchant_phone | string | 是 | 归属商户手机号 |
| institution_external_id | string | 是 | 机构同步 external_id |
| external_id | string | 是 | 导入幂等键 |
| name | string | 是 | 商品名 |
| category | string | 是 | 产品品类（见 query_dictionaries） |
| transaction_mode | string | 是 | 交易模式（见 query_dictionaries） |
| description | string | 否 | 描述（可含简单 HTML） |
| sub_category | string | 否 | 内容二级分类 |
| tags | string[] | 否 | 标签 |
| license_mode | string | 否 | 授权模式 |
| price_cents | integer | 否 | 价格（分） |
| total_quantity | integer | 否 | 总量 |
| image_urls | string[] | 否 | 商品图公网 URL |
query_import_status合作方product:import
按 external_id 查询导入单状态。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| external_id | string | 是 | 导入幂等键 |
sync_institution合作方institution:sync
机构同步（external_id 幂等创建/更新；is_certified 由平台审核认定，不接受设置）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| external_id | string | 是 | 机构外部 ID（幂等键） |
| name | string | 是 | 机构名称 |
| contact | string | 否 | 联系方式 |
| introduction | string | 否 | 机构简介 |
| image_url | string | 否 | 头图 URL |
| logo_url | string | 否 | Logo URL |
| category | string | 否 | 机构分类 |
| tags | string[] | 否 | 标签 |
list_institutions合作方institution:sync
已同步机构列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 50 |
| offset | integer | 否 | 默认 0 |
query_dictionaries合作方
开放字典：品类/内容分类/交易模式/标签的合法取值。
| 参数 | 类型 | 必填 | 说明 |
|---|
kb_search双身份
版权知识库检索：法规条款要旨/典型案例/官方口径解读。回答版权法律咨询前先查证；引用条目须附 source_url 官方链接；verified=false 的条目应提示「待平台核对」。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 是 | 检索词 |
| domain | string | 否 | 知识域：legal/intel/stats/news/ip_data |
| kind | string | 否 | 内容形态：clause/case/interpretation/guide/faq |
kb_get双身份
按 ID 获取知识条目详情（标题/摘要/信源/官方原文链接/免责声明）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 条目 ID（kb_search 返回） |
file_off_market_transaction个人
场外版权交易备案（鉴证中心）：提交后平台向标的权利人短信确认，全员确认后出具带编号备案凭证并锚定存证链。调用前必须向用户复述标的/备案类型/对方手机号/合同号并获明确确认；提交即声明交易真实，虚假备案责任由提交人承担。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | integer | 是 | 平台在册商品编号（备案标的） |
| event | string | 是 | transfer=权利转让 / license=许可备案 |
| counterparty_phone | string | 是 | 对方（受让方/被许可方）11 位手机号 |
| contract_no | string | 是 | 双方书面合同号（同号重复提交幂等） |
| title | string | 否 | 标的名（缺省用 商品#ID） |
| note | string | 否 | 备注 |
| sandbox | boolean | 否 | true=沙箱出证（缺省）；false=正式上链（不可撤销，需用户明确确认） |
list_my_certificates个人
本人备案凭证（鉴证中心）：凭证编号/类型/事件/标的/签发时间。待确认中的备案申请不在列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 20，最大 100 |
| offset | integer | 否 | 默认 0 |
verify_certificate双身份
公开验真：按凭证编号查备案凭证（编号/事件/双方/哈希/链校验结论）。用户给出 CDCEE- 开头编号时用本工具核验，勿凭编号格式猜测真伪。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cert_no | string | 是 | 凭证编号，如 CDCEE-JY-2026-000001 |
query_subject_chain双身份
标的的全部备案凭证链（时间正序事件流+链校验）与当前权属（登记簿投影：权利项×持有人份额）。回答「这个作品归谁、经历过哪些交易」类问题时用本工具。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| subject_key | string | 是 | 标的键，如 product:11883 |
错误码
| HTTP | error | 说明 |
|---|---|---|
| 400 | invalid_request | 参数缺失或格式非法 |
| 401 | invalid_token | 凭据缺失/无效/已吊销 |
| 403 | scope_denied | 未开通对应能力、参数越界或应用未挂靠合作方主体 |
| 404 | not_found | 资源不存在（防枚举语义） |
| 409 | account_deactivated | 账号已注销（不自动复活） |
| 429 | rate_limited | 触发限流，响应附带 Retry-After |
| 502 | upstream_unavailable | 平台内部依赖异常，可稍后重试 |
429 响应附带 Retry-After 头；按 token 主体限流（个人换票 30 次/分 · 500 次/日；合作方按主体共享配额）。
环境
| 环境 | 网关 | 说明 |
|---|---|---|
| 正式 | https://cjapp.cdcee.net | 真实数据；MCP 存证走真实中数链（不可撤销、消耗配额） |
| 测试 | https://cjapp-t.cdcee.net | 沙箱演练；MCP 存证默认沙箱（mock，不连真实链、不耗配额） |
正式环境未开放沙箱字段：attest_work 沙箱模式在正式网关会返回字段未启用错误，属预期行为。
常见问题
token 在哪里获取？
个人用户：登录平台后经 API（POST /base/api/v1/user/api-tokens）或 Skill 包 脚本创建； 合作方：在 开发者控制台 创建应用后经 client_credentials 换取。
沙箱与真实链有什么区别？
沙箱（mock_attestation）走完整存证流程但不连真实链、不消耗配额，证书为平台合成； 真实链（zhongshu_attestation）在中数链上生成有效存证，不可撤销。
应用需要什么条件才能调用业务工具？
合作方应用需由平台运营「挂靠」到合作方主体（继承其机构绑定与配额）；个人工具开箱即用（仅本人数据）。
调用有什么限制？
每个合作方/应用有分钟级与日级配额（429 + Retry-After 提示稍后重试）； 平台另有全局兜底限流（所有调用方共享），保障整体可用性。读取与写入统一计入。
接入方式怎么选？
AI 工具用户 → Skill 包（开箱即用）或 MCP（一句话操作）； 合作方系统 → REST（/openapi/v1，OAuth2 或 ptk_ 令牌）； 在线试调只读端点 → API Explorer。