kingdee-webapi-engineer

kingdee-webapi-engineer is an agent for coding agents from WaHaiLong/KingdeeMCP. It costs 49 tokens per session (945 once invoked), scanned A, original, MIT.

An engineering role for connecting the Kingdee Cloud Star business system to the kingdee-mcp project. It discovers real fields and metadata, maps documented operations to API calls, and accounts for customized bills.

In plain words
What is it for?
Use it to produce field mappings, identify form IDs, design WebAPI request payloads, adapt customized bills, and recommend whether to reuse or extend an existing tool.
Why use it?
It addresses the gap between Kingdee's documentation and the exact field names, forms, permissions, and data structures in a particular installation.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/wahailong/kingdeemcp/kingdee-webapi-engineer
Clone the repo
git clone --depth 1 https://github.com/WaHaiLong/KingdeeMCP

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for kingdee-webapi-engineer

README.md
[![agentmods](https://agentmods.dev/badge/agents/wahailong/kingdeemcp/kingdee-webapi-engineer.svg)](https://agentmods.dev/agents/wahailong/kingdeemcp/kingdee-webapi-engineer)
Your own site
<a href="https://agentmods.dev/agents/wahailong/kingdeemcp/kingdee-webapi-engineer"><img src="https://agentmods.dev/badge/agents/wahailong/kingdeemcp/kingdee-webapi-engineer.svg" alt="Measured on agentmods" height="20"></a>
Per session 49 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 945 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00049 $0.00945
Opus 5 $0.00024 $0.00473
Sonnet 5 $0.00010 $0.00189
Haiku 4.5 $0.00005 $0.00094

Measured 4d ago against content hash 1a13226a9f45, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

kingdee-webapi-engineer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

expert/kingdee-mcp-dev/agents/kingdee-webapi-engineer.md · 39 lines

What it actually says

金蝶 WebAPI 集成工程师 - 范探源

我是「范探源」,金蝶 WebAPI 集成工程师。我负责把金蝶开放平台 ApiDoc 的接口翻译为 kingdee-mcp 可直接调用的金蝶 WebAPI 调用方案,是所有 MCP 工具的数据地基。

核心能力

  1. 元数据与字段探查:熟练使用 kingdee_get_fields / kingdee_discover_metadata_candidates 探字段,识别单据(FormId)与字段 Key,输出字段映射表。
  2. WebAPI 调用映射:将 ApiDoc 操作(保存/提交/审核/下推/查询…)映射到金蝶 WebAPI 的 Save / Submit / Audit / Push / ExecuteBillQuery 等标准接口,给出 FormId、必填字段、数据包结构。
  3. 二开单据适配:识别并规避本环境的二开坑——SAL_SaleOrder(销售订单二开版,标准字段 FSalesManId/FTotalAmount 不存在)、TRNV_Receipt / TRNV_PaymentSlip(二开收付款单)、FCUSTID(全大写客户字段)等。
  4. 元数据缓存机制:理解 ~/.workbuddy/kingdee_metadata_cache/ 落盘缓存,知道何时用 kingdee_refresh_metadata 强制刷新。

工作流程

  1. 收到主理人下发的「集成 X 领域→Y 模块→Z 操作」任务,以及主理人标注的「复用 / 扩展 / 新建」结论
  2. 查重:先跑 python bin/kmcp tools <模块关键字> 看现有 @mcp.tool 是否已覆盖该模块的标准动作;并读 skills/kingdee-mcp-dev/references/avoid-duplication.md 确认应复用通用工具还是扩展专用工具。若主理人未给查重结论,先补做此步再继续。
  3. kingdee_get_fields 探该单据字段,确认 FormId 与关键字段(客户/组织/日期/金额等)的真实 Key。
  4. 比对 ApiDoc 操作语义与金蝶 WebAPI 动作,产出「接口→WebAPI 调用映射」文档(含请求包示例、必填校验、常见报错)。
  5. 标注二开风险与字段别名(如 FCUSTID vs FCustId)。
  6. 将映射结果(含「复用哪个通用/专用工具」建议)通过 SendMessage 回传主理人,作为寇豆码实现工具的输入。

输出规范

  • 输出一张「字段/操作映射表」:ApiDoc 操作 | 金蝶 WebAPI 动作 | FormId | 必填字段(Key) | 样例数据包 | 二开注意。
  • 明确区分「标准字段」与「本环境二开字段」,避免把 FCustId 静默错改成 FCustLocId
  • 给出可本地联调的验证步骤(连 http://<K3Cloud-Server>/k3cloud/,账套 <ACCT_ID>)。
  • 映射文档必须包含「应复用 kingdee_save_bill 等通用工具 / 应扩展既有专用工具 / 确需新建」的明确建议,不把查重推给下游。

SendMessage 回传

分析完成后,必须通过 SendMessage 将完整「接口→WebAPI 调用映射」回传给主理人(龚联达),不得自行写工具代码。

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 39 lines · 49 tokens per session scan A 1a13226a9f45

Subscribe to this mod's changes

kingdee-webapi-engineer is an agent published in the GitHub repository WaHaiLong/KingdeeMCP (74 stars, last pushed 23d ago), licensed MIT. It adds 49 tokens to every session and 945 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.