agent-tools-api

工具 Tools

`bankcard_validate`

校验中国大陆银行卡号(Luhn算法),清洗空格/连字符后按卡BIN识别发卡行与卡种(卡BIN表核对至2026-10)

curl -X POST localhost:8890/api/v1/bankcard_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"card": "6222000000000009"}'

`iban_validate`

校验IBAN国际银行账号(ISO 13616):按国别长度表核对总长、字符集与MOD 97-10校验位,解析国家码/校验码/BBAN(国别表按SWIFT IBAN Registry核对至2026-10)

curl -X POST localhost:8890/api/v1/iban_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"iban": "GB29NWBK60161331926819"}'

`idcard_region`

按GB/T 2260前6位行政区划码解析省/市/区县(覆盖直辖市/省会/主要城市及常见历史码;区划表核对至2026-10)

curl -X POST localhost:8890/api/v1/idcard_region \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"code": "110101"}'

`idcard_validate`

校验18位中国身份证号(GB 11643)并解析地区码/出生日期/性别/行政区划, 晚于当日的出生日期判无效(区划表核对至2026-10)

curl -X POST localhost:8890/api/v1/idcard_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"id": "110101199001011237"}'

`isbn_validate`

校验ISBN-10/ISBN-13出版物号(ISO 2108):容忍连字符/空格,ISBN-10按mod 11(校验位可X),ISBN-13限978/979前缀按mod 10,返回规范化13位isbn13与原始格式format

curl -X POST localhost:8890/api/v1/isbn_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"isbn": "978-7-229-03093-3"}'

`lunar_calendar`

公历转农历日期/干支纪年月日/生肖/当天节气; 非法/不存在日期或sxtwl缺失返回{valid:false,reason}

curl -X POST localhost:8890/api/v1/lunar_calendar \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"date": "2026-10-13"}'

`phone_lookup`

查询11位中国手机号归属运营商(按号段识别,不含携号转网;prefix返回实际命中的3或4位号段;号段表核对至2026-10)

curl -X POST localhost:8890/api/v1/phone_lookup \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"phone": "13812345678"}'

`mask`

脱敏文本中的敏感号码: 18位身份证(校验位)/11位手机号(有效号段)/15-19位银行卡(Luhn), 保留首尾中段打码

curl -X POST localhost:8890/api/v1/mask \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"text": "张三手机13812345678, 身份证110101199003077715"}'

`plate_validate`

校验中国大陆机动车号牌(GA36-2018): 普通7位/新能源8位/使馆/领馆/粤Z港澳入出境, 规则表离线判定类型与省份

curl -X POST localhost:8890/api/v1/plate_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"plate": "粤B12345"}'

`rmb_upper`

转换人民币金额(元)为财务中文大写:接受字符串或数字输入,分角两位小数,中间连续零只读一个零字、末尾零不读,整数补整字;负数/超两位小数/非数值/金额≥1亿亿返回校验错误

curl -X POST localhost:8890/api/v1/rmb_upper \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"amount": "1234.56"}'

`swift_validate`

校验8位或11位SWIFT/BIC国际银行代码结构(ISO 9362),拆分银行码/ISO 3166-1国家码/位置码/分支机构码并判定总行is_primary(国家码表核对至2026-10)

curl -X POST localhost:8890/api/v1/swift_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"bic": "BKCHCNBJ"}'

`uscc_validate`

校验18位统一社会信用代码(GB 32100-2015)并解析登记管理部门/机构类别/行政区划/主体标识码(码表核对至2026-10)

curl -X POST localhost:8890/api/v1/uscc_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"code": "91110108MA01C8XX4J"}'

`vin_validate`

校验17位车辆识别代号VIN(ISO 3779/GB 16735 校验位)并解析WMI厂商/产地国、VDS/VIS、车型年份与装配厂(码表核对至2026-10)

curl -X POST localhost:8890/api/v1/vin_validate \
  -H 'x-api-key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"vin": "LSVAU2B49C2108563"}'

档位 Plan	日配额 Daily quota	适用场景 For
`free`	200 次/日	评估与低频调试
`pro`	10000 次/日（1 万）	生产环境中小流量 agent
`mega`	100000 次/日（10 万）	高频调用与批量任务

agent-tools-api v0.1.0