ls0f/phone

Health v2 · maintenance only

Flags: no_releases no_license

Adoption not part of the score

1084 stars · 233 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Python library that looks up the Chinese province, city, zip code, area code, and carrier for a mobile phone number prefix using an offline phone.dat database (updated December 2023). The binary data file can also be parsed in other languages such as Go, Node, PHP, and Lua.

Use cases

• look up which province and city a Chinese mobile number belongs to
• find the carrier (China Mobile, Unicom, Telecom) for a phone number
• validate and enrich user phone numbers during registration
• parse phone.dat in Go, Node, PHP, or Lua
• offline phone number geolocation without external API calls

When to choose

• you need fast, offline Chinese mobile number location lookup in Python
• you want a lightweight library with no external API dependency
• you need the carrier type along with region info

When to avoid

• you need international phone number lookup outside China
• you need frequently updated carrier data (last update December 2023)
• you need landline number lookup - only mobile prefixes are supported

Facets

library · maturity maintenance

search-engine data-science parser developer-tools data-science python cross-platform phone-number-lookup china-mobile phone-location offline-database phone-dat telecom

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ls0f/phone")