ClawHub

运营商5G基站位置查询(AI付版) - 聚合数据

Finance

聚合数据提供的运营商5G基站信息查询服务技能，本技能使用无需用户注册聚合数据平台，安装后即可按实际查询付费使用。 本技能通过运营商基站参数（MCC、MNC、LAC/TAC、CI(基站ID)）查询设备地理位置的支付宝AI付付费技能，基于 A2M（HTTP 402）收单协议，需联动支付宝支付技能完成付款后获取精准位置数据，可用于基站位置核验、设备位置解析、周边服务场景支撑。 当用户需要查询基站位置信息,如当前位置查询、周边推荐、定位等时候,调用本技能。买家通过本 Skill 向卖家服务端发起请求，完成支付后获取相关结果。 关键词：基站定位、MCC、MNC、TAC/LAC、CI、基站地址、基站经纬度、当前位置、周边、附近

Install

openclaw skills install @juhemcp/cell-location

技能概述

本 Skill 提供通过运营商基站的MCC、MNC、TAC/LAC、CI(基站ID)信息查询所在位置信息。为用户提供位置服务，如当前位置查询、周边推荐、定位等。当用户需要查询基站对应地理位置，用于位置查看、周边推荐、位置服务的时候，调用本技能。

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

系统要求

操作系统

由于该技能基于 A2M 协议，需要在支持 A2M 协议的系统上运行，支付宝支付 CLI 工具（alipay-bot）在 Windows 环境下暂不支持。

macOS / Linux，版本要求如下：

系统版本要求
macOS12 Monterey 或更高版本
推荐 macOS 14 Sonoma 或 macOS 15 Sequoia
LinuxUbuntu：>= 21.04
Debian：>= 12
CentOS：>= 9

环境要求

环境版本要求
Node.js> 22
npm> 10

必要依赖

本技能依赖于支付宝AI付技能，需要从clawhub上安装这两个技能：alipay-authenticate-wallet 和 alipay-payment-skill，安装后检查是否已开启支付宝支付功能，如未开启，需要提示用户开启支付宝支付功能。

触发条件

  • 用户意图：
    • （1）直接查询：已提供 MCC、MNC、TAC、CI 四组基站编码，想要查询对应地理位置、查看周边场所、获取简易位置信息；
    • （2）前置引导：仅提出查看周边、位置查询、基站定位相关需求，但未提供基站四元组编码，触发技能引导用户补充 MCC、MNC、TAC、CI 参数。
  • 关键词匹配： 对话包含「基站定位、MCC、MNC、TAC/LAC、CI、基站地址、基站经纬度、当前位置、周边、附近」任一关键词；
  • 实体硬性要求： 输入内容必须完整提供 MCC、MNC、TAC/LAC、CI 四项基站参数，缺少任意一项不触发；
  • 拦截规则： 仅科普基站编码名词、使用 GPS/IP/WiFi 定位、非法追踪他人位置、仅查询运营商网络信息时，不触发本技能；
  • 服务说明： 本技能基于基站编码解析静态地理位置，支持周边地点、基础位置查询服务，不支持高精度实时持续追踪。

工作流程

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

第一步：收集基站信息

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

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

第二步：请求约束

  • 请求方法：POST
  • 请求头：Content-Type: application/json
  • 请求体是json字符串，请严格按照以下格式填写：'{"resourceId":"849","data":{"mcc":"<需要查询的移动国家代码MCC>","mnc":"<需要查询的移动网络代码MNC>","lac":"<需要查询的位置区码LAC/TAC>","ci":"<需要查询的基站号CI/CID或BID>"}}'
  • 注意promot引号转义，避免json字符串异常

第三步：请求资源

向用户展示待查询的参数，严格遵守请求约束，向以下 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 技能，引导用户完成付款，并展示用户订单号（out_trade_no）。

第五步：后续流程

完全转移到 alipay-payment-skill 技能的工作流,提示支付待确认的信息时，需要包含用户订单号（out_trade_no）。禁止agent更改用户提交的请求参数即json字符串。

返回示例

该服务结果（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 响应报文必须完整透传，不可篡改、删减；
  • 严格遵循既定流程与异常规则，禁止自定义逻辑。
More in Finance