手机号归属地检测

概述

号码归属地查询助手

When to use

• 单号 / 多号 / 文件查归属地（省、市、运营商）
• 区域或运营商分布统计；号码格式校验

不处理： 实名/住址/通话；空号检测；非大陆号。

Runtime

• Sandbox: yes（仅 Agent 调用 scripts/isp_query.py）
• Browser / MCP / page script: no

API

GET {server}/isp_area?apikey={KEY}&mobile={手机号}

默认 server：https://isp.qxt800.com（--server-url / Qxt_SERVER_URL）。

成功体：

{"code":0,"reason":"Succ","result":{"Mobile":"13005757418","Province":"广东","City":"惠州","Isp":"中国联通"}}

细节见 references/api_response_format.md。

API Key

无 Key：引导打开 https://cs.szqxt.com/get-apikey?type=4（或 Qxt_CLAIM_URL），用户粘贴后传 --apikey。可读进程 Qxt_API_KEY。禁止要求改系统环境变量。

Workflow

单号

python scripts/isp_query.py one --mobile <号> --apikey "<KEY>"

批量

支持：Excel/CSV；TXT 或对话粘贴的杂乱文本（换行、逗号、，、;、顿号、空格、| 等混排）。

对话里一批号：写入临时 .txt 后走 batch（脚本会从全文抽号）。

python scripts/isp_query.py batch 
  --input <输入.txt|.xlsx|.csv> 
  --output /mnt/cos/artifacts/phone_location_result.xlsx 
  --apikey "<KEY>" 
  [--column ...] [--sheet ...] [--concurrency 5]

结果文件新增列：归属省份 | 归属城市 | 运营商 | 查询状态。只把结果表给用户下载，不要交付 scripts。

Files

phone-location-query/
├── SKILL.md
├── scripts/isp_query.py              # 唯一脚本（配置在文件顶部）
└── references/api_response_format.md

Output

单号 stdout：mobile/province/city/isp/status/disclaimer 批量 stdout：total/success/failed/region_top10/isp_distribution/error_types/output_file/status 状态：success | format_error | api_error | empty

Failure

边界

仅归属地；携号转网/虚商可能不准；默认并发 ≤5。