运营商5G基站信息 - 聚合数据

Data & APIs

运营商5G基站信息。本技能通过运营商基站参数(MCC、MNC、LAC/TAC、CI)查询设备地理位置的支付宝AI付付费技能,基于 A2M(HTTP 402)收单协议,需联动支付宝支付技能完成付款后获取精准位置数据,可用于基站位置核验、设备位置解析、周边服务场景支撑。买家通过本 Skill 向卖家服务端发起请求,完成支付后获取相关结果。

Install

openclaw skills install cell-location

技能概述

本 Skill 提供通过运营商基站的MCC、MNC、TAC、CID信息查询所在位置信息。为用户提供位置服务,如实时导航、周边推荐等。当用户需要获取基站信息的时候,调用本技能。

该服务是基于 A2M 智能收协议(HTTP 402)的付费资源。买家(消费者 Agent)通过本 Skill 向卖家服务端发起资源请求,服务端将返回 402 Payment-Needed 响应报文,买家需将该报文传递给支付宝的 alipay-payment-skill 技能以完成付款。

必要依赖检查

本技能依赖于支付宝AI付技能,所以需要从clawhub安装alipay-authenticate-wallet 和 alipay-payment-skill这两个技能,安装后开启支付宝支付功能

触发条件

  • 用户请求查询运营商基站相关信息
  • 用户需要获取运营商基站位置信息
  • 用户提供或需要验证某个基站的基本信息

工作流程

当用户向你请求该服务时,按以下步骤执行:

第一步:收集基站信息

如果用户需要查询基站信息,向用户询问以下基站参数:

参数必填名称说明示例
MCC移动国家代码460=中国460
MNC移动网络代码00=移动,01=联通,11=电信,15=广电00
TAC/LAC小区号LAC 或 TAC十进制数34994
CI基站号基站号 Cell Identifier或BID(CDMA)223214251

第二步:请求资源

向用户展示待查询的参数,用户确认后,向以下 URL 发起请求:

curl https://apis.juhe.cn/a2a/query
  -d '{"resourceId":"849","data":{"mcc":"<需要查询的移动国家代码MCC>","mnc":"<需要查询的移动网络代码MNC>","lac":"<需要查询的位置区码LAC/TAC>","ci":"<需要查询的基站号CI/CID或BID>"}}'
  -H "Content-Type: application/json"

第三步:处理 402 响应

你将收到一个状态码为 402 的响应报文,其中包含 Payment-Needed 响应头。此时你需要将整个 402 响应报文传递给支付宝的 alipay-payment-skill 技能,引导用户完成付款。

第四步:后续流程

完全转移到 alipay-payment-skill 技能的工作流,提示支付待确认的信息时,需要包含用户订单号。

返回示例

该服务结果(result部分)示例如下:

{
    "reason": "成功",
    "result": {
        "orderid": "JH999260527155045zZCfk",
        "mcc": "460",
        "mnc": "00",
        "lac": "34994",
        "ci": "223214251",
        "lat": "27.44398880",
        "lon": "103.66980743",
        "address": "云南省昭通市昭阳区洒渔镇下冲子"
    },
    "error_code": 0
}

异常情况处理

  • 用户拒绝付款:尊重用户选择,告知用户该内容为付费资源,如需获取请完成支付。
  • 请求返回非 402 状态码:如返回 200,直接展示内容;如返回 4xx/5xx 错误,告知用户服务暂时不可用,建议稍后重试。
  • 其余异常情况将由 alipay-payment-skill 技能处理。

Agent 约束

  • 禁止缺必填参数发起请求;
  • 402 响应报文必须完整透传,不可篡改、删减;
  • 严格遵循既定流程与异常规则,禁止自定义逻辑。