# xluohome/phonedata

手机号码归属地信息库、手机号归属地查询   phone.dat 最后更新：2023年02月

Repository: https://github.com/xluohome/phonedata
Canonical: https://ross.abutalabs.com/products/phonedata
Homepage: https://github.com/xluohome/phonedata
Language: Go
License: GPL-3.0
License Family: copyleft
Topics: golang, java, python, php, phonenumber
Last push: 2023-11-14T05:23:28+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3451, "days_push": 1023, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2214, forks 402 (observed 2026-08-28T04:06:27.041270+00:00)

## What it is
A Go library and offline database (phone.dat) for querying the geographic location of Chinese mobile phone numbers, returning province, city, zip code, area code, and carrier via binary search. It also ships a CLI tool and ports in many other languages.

## Use cases
- look up which province and city a Chinese phone number belongs to
- find the carrier of a mobile number offline
- resolve phone number area code and zip code in Go
- query phone number location without an external API
- embed a phone number geolocation database in an application

## When to choose
- you need fast, offline Chinese phone number location lookup with no network calls
- you work in Go and want a simple library API plus a CLI
- you need carrier, province, city, zip, and area code from a phone number

## When to avoid
- you need international phone number lookup outside China
- you require guaranteed up-to-date data - the database last updated February 2023
- you need accuracy guarantees for production without your own verification

## Facets
- artifact type: library
- maturity: maintenance
- function: search-engine, developer-tools, cli
- domain: developer-tools, apis
- platform: go, cross-platform, cli
- tags: phone-number-lookup, china, phone-location, binary-search, offline-database, phone-dat, command-line

## Member repositories
- xluohome/phonedata (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:27.041270+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:46:00.074451+00:00, confidence not recorded.
  - readme: https://github.com/xluohome/phonedata (fetched 2026-08-28T04:06:27.041270+00:00, sha 1625d7ec2b1f)
  - homepage: https://github.com/xluohome/phonedata (fetched 2026-08-29T10:26:15.819385+00:00, sha 6f2d64e29127)
- Data as of 2026-08-30T08:39:29.467469+00:00.